WHSTags — Documentación

¿Qué es WHSTags?

WHSTags es un sistema de tags para servidores Minecraft con múltiples modalidades. Permite crear tags visuales que los jugadores pueden equiparse y que se muestran en el chat, tab, holograms u otros plugins. Los tags se sincronizan automáticamente entre todas las modalidades del servidor a través de una base de datos MySQL compartida.

Configuración inicial

config.yml

mode: lobby          # lobby | client
server-id: lobby     # identificador único de esta modalidad
gui-mode: self       # self | legacy
language: es         # es | en | fr | de | pt

Campo	Descripción
`mode`	`lobby` — crea y gestiona los tags. `client` — recibe los tags desde la DB.
`server-id`	Nombre único de esta modalidad (ej: `lobby`, `survival-op`, `earth`). Cada modalidad debe tener uno diferente.
`gui-mode`	`self` — usa sus propios menús locales. `legacy` — descarga los menús del lobby.
`language`	Idioma de los mensajes. `es` para español, `en` para inglés.

Modos de operación

Lobby (mode: lobby)
  ├── Crea y elimina tags
  ├── Sube tags a MySQL
  └── Puede subir sus menús con /whstags admin upload

Cliente (mode: client)
  ├── Lee los tags desde MySQL
  ├── Guarda el tag activo de cada jugador por modalidad
  └── gui-mode: legacy → descarga los menús del lobby
      gui-mode: self   → usa sus propios menús locales

Comandos

Comando	Descripción	Permiso
`/whstags`	Abre el menú de tags	`whstags.use`
`/whstags set <id>`	Equipa un tag directamente	`whstags.use`
`/whstags remove`	Quita el tag activo	`whstags.use`
`/whstags admin list`	Abre el menú admin con todos los tags	`whstags.admin.list`
`/whstags admin create <id> <display>`	Crea un nuevo tag	`whstags.admin.create`
`/whstags admin delete <id>`	Elimina un tag	`whstags.admin.delete`
`/whstags admin reload`	Recarga config, idioma y tags desde DB	`whstags.admin.reload`
`/whstags admin upload`	Sube los menús locales a MySQL	`whstags.admin.upload`
`/whstags admin download`	Descarga los menús desde MySQL	`whstags.admin.download`
`/whstags admin purge`	Elimina todos los tags existentes. Requiere escribir confirm en el chat en un plazo de 30 s.	`whstags.admin.purge`
`/whstags admin fixperms`	Corrige permisos bugueados tras cambios de id de tags	`whstags.admin.fixperms`
`/whstags admin extract`	Exporta todos los tags de la DB a un archivo YML	`whstags.admin.extract`
`/whstags admin import`	Sube el archivo YML exportado (editado o no) a la base de datos	`whstags.admin.import`

Alias disponibles: /tag, /tags

create, delete y upload solo funcionan en mode: lobby.

download solo funciona en gui-mode: legacy.

extract solo funciona en servidores con mode: lobby.

import solo funciona en servidores con mode: lobby.

Todos los comandos (excepto aperturas de menús) pueden ejecutarse desde la consola del servidor.

Permisos

Permiso	Descripción	Default
`whstags.use`	Abrir el menú y equipar tags	true
`whstags.<id>`	Permiso para usar un tag específico (ej: `whstags.vip`)	op
`whstags.admin.list`	Ver todos los tags en el menú admin	op
`whstags.admin.create`	Crear tags (solo lobby)	op
`whstags.admin.delete`	Eliminar tags (solo lobby)	op
`whstags.admin.reload`	Recargar el plugin	op
`whstags.admin.upload`	Subir menús a MySQL (solo lobby)	op
`whstags.admin.download`	Descargar menús desde MySQL (solo legacy)	op
`whstags.admin.purge`	Eliminar todos los tags (solo lobby)	op
`whstags.admin.fixperms`	Corregir permisos tras cambios de id	op
`whstags.admin.extract`	Exportar los tags a un archivo YML (solo lobby)	op
`whstags.admin.import`	Importar el archivo YML exportado a la base de datos (solo lobby)	op

Gestión de Tags

Crear un tag

/whstags admin create <id> <display>

id Identificador interno, solo letras, números, - y _ (máx. 32 caracteres)

display Nombre visual, acepta colores MiniMessage, HEX y códigos &

Ejemplos

/whstags admin create vip <gold>VIP
/whstags admin create mvp <gradient:#FFD700:#FF6B00>MVP</gradient>
/whstags admin create admin <red><bold>ADMIN
/whstags admin create pvp ⚔ <red>PvP God

Editar el id de un tag

En el menú de /whstags admin list, hacé clic derecho sobre un tag para cambiar su id. El plugin te pedirá que escribas el nuevo id en el chat; tenés 30 segundos para hacerlo. Tras un cambio de id, ejecutá /whstags admin fixperms para corregir permisos que hayan quedado desactualizados.

Dar permiso a un jugador (LuckPerms)

/lp user <jugador> permission set whstags.<id> true

Dar permiso a un grupo (LuckPerms)

/lp group <grupo> permission set whstags.<id> true

Formato del archivo exportado

El comando /whstags admin extract genera un archivo YML en la carpeta del plugin con todos los tags de la base de datos. El nombre del archivo incluye la fecha de extracción.

plugins/WHSTags/tags-export-{AAAAMMDD}.yml

# WHSTags Export — 2026-05-26 15:04:47
# Total: 7 tags

tags:
  vip:
    display: "<gold>VIP"
    permission: whstags.vip
  mvp:
    display: "<gradient:#FFD700:#FF6B00>MVP</gradient>"
    permission: whstags.mvp
  admin:
    display: "<red><bold>ADMIN"
    permission: whstags.admin

Presets de ítem en el archivo exportado

Además de display y permission, cada tag del archivo exportado puede incluir un bloque item con los mismos parámetros usados en los ítems de menús (item_id, name, lore, banner, enchants, attributes, flags, glow). Este preset se guarda en la base de datos junto al tag.

# WHSTags Export — 2026-07-07 12:00:00
# Total: 1 tags

tags:
  colombia:
    display: "<gold>ᴄ<dark_blue>ᴏ<dark_red>ʟ"
    permission: tags.colombia
    item:
      item_id: PAPER          # o "head:<base64|player|url>"
      name: "<gold>colombia"
      lore:                   # lista o string single-line
        - "<gray>Click to equip"
      banner:
        - pattern: STRIPE_TOP
          color: RED
      enchants:
        - "unbreaking:1"
      attributes:             # solo hide_attributes implementado
        - "hide_attributes"
      flags:                  # hide_enchants, hide_dye, etc
        - "hide_enchants"
      glow: false

Cuando el tag se referencia en una categoría, el plugin usa automáticamente este preset como apariencia del ítem. Si la categoría define su propia configuración para ese tag (item_id, name, lore, etc.), esa configuración local sobreescribe al preset únicamente en esa categoría.

Importar el archivo editado

Después de editar el archivo exportado (agregando o modificando los bloques item), subí los cambios a la base de datos con /whstags admin import. El plugin lee ese mismo archivo y actualiza los tags existentes con la configuración especificada.

/whstags admin extract
# editá plugins/WHSTags/tags-export-{AAAAMMDD}.yml
/whstags admin import

Ejemplo real

Este es un archivo real extraído con /whstags admin extract, con más de 60 tags ya configurados con sus presets de ítem. Podés copiarlo y usarlo como base en tu propio servidor con /whstags admin import.

# WHSTags Export — 2026-07-07 19:35:50
# Total: 66 tags

tags:
  tierone:
    display: "&4ᴛɪᴇʀ ᴏɴᴇ"
    permission: tags.tierone
    item:
      item_id: armor_stand
  egg:
    display: "&#FFE066&k: &#FFE066ᴇ&#C8F57Aɢ&#A0F5A0ɢ &#FF99CCᴇɢɢ &#FF99CC&k:"
    permission: tags.egg
    item:
      item_id: egg
  dios:
    display: "&#006EFF&k::&r&#006EFFᴅ&#00ACFFɪ&#00EAFFᴏ&#00EAFFꜱ&#00EAFF&k::"
    permission: tags.dios
    item:
      item_id: light_blue_dye
  sacerdotisa:
    display: "&#9B00C8ꜱ&#AA00DC &#BB00EEᴀ&#CC00FFᴄ&#BB00EEᴇ&#AA00DCʀ&#9B00C8ᴅ&#8C00B4ᴏ&#7D00A0ᴛ&#6E008Cɪ&#5F0078ꜱ&#500064ᴀ"
    permission: tags.sacerdotisa
    item:
      item_id: soul_lantern
  venezuela:
    display: "&7ᴠ&1ᴇ&4ɴ"
    permission: tags.venezuela
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTMwMzMwNDliYWFlMTE4Nzc0MDZkYTQwYmQwNTE3Y2JmYjJiMzdhMjM5OGJlM2JkYTQ5OTViNjFmZmVhYTI0MyJ9fX0=
  supremo:
    display: "&c&k:: &aꜱᴜᴘʀᴇᴍᴏ &c&k::"
    permission: tags.supremo
    item:
      item_id: light_blue_concrete
  casual:
    display: "&#A8D8EA&ki &#A8D8EAᴄᴀꜱᴜᴀʟ &#A8D8EA&ki"
    permission: tags.casual
  runner:
    display: "&3ʀᴜɴɴᴇʀ"
    permission: tags.runner
    item:
      item_id: feather
  vip:
    display: "&8&k:&#FFF799ᴠ&#FFE066ɪ&#FFD94Dᴘ&8&k:"
    permission: tags.vip
    item:
      item_id: gold_ingot
  bunny:
    display: "&#E0F7FF&k: &#E0F7FFʙ&#C9F0FFᴜ&#B2E9FFɴ&#9BE2FFɴ&#84DBFFʏ &#84DBFF&k:"
    permission: tags.bunny
    item:
      item_id: white_dye
  goat:
    display: "&#FFD700&ki &#FFD700ɢᴏᴀᴛ &#FFD700&ki"
    permission: tags.goat
    item:
      item_id: emerald_block
  extinto:
    display: "&#F2A8C0&k::&#F2A8C0ᴇ&#F4AEC5xᴛ&#F5B4CAɪ&#F7BAD0ɴ&#F8C0D5ᴛ&#FAC6DAᴏ&#FBCCDF&k::"
    permission: tags.extinto
    item:
      item_id: pink_concrete
  menace:
    display: "&#FF0000&ki &#FF0000ᴍᴇɴᴀᴄᴇ &#FF0000&ki"
    permission: tags.menace
    item:
      item_id: redstone_block
  explorer:
    display: "&#F5E642&k:: &#F5E642ᴇ&#F7E94Dxᴘ&#F9EC58ʟ&#FAEE63ᴏ&#FCF16Eʀ&#FDF479ᴇ&#FFF484ʀ &#FFF484&k::"
    permission: tags.explorer
    item:
      item_id: yellow_concrete
  boost:
    display: "&a&k:&#E700FFʙᴏᴏꜱᴛ&a&k:"
    permission: tags.boost
    item:
      item_id: purple_concrete
  ecuador:
    display: "&6ᴇ&1ᴄ&4ᴜ"
    permission: tags.ecuador
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNzI4NjliNTVhNDAxYzg3ZmI5M2MzNmEyZDJlNzRlYTRkZDcyMjU0MmFiMGZjM2MwZGJmOTUxMTc3MzI1MTQ1NSJ9fX0=
  forest:
    display: "&#0D3D00&k:: &#0D3D00ꜰ&#1A5C00ᴏ&#277A00ʀ&#348000ᴇ&#3D9900ꜱ&#46B300ᴛ &#46B300&k::"
    permission: tags.forest
    item:
      item_id: oak_log
  hadesgod:
    display: "&#FCFF00&k:&r&#FF0000ʜ&#F92000ᴀ&#F44000ᴅ&#EE6000ᴇ&#E98000ꜱ &#DDBF00ɢ&#D8DF00ᴏ&#D2FF00ᴅ&#D7E600&k:&#D2FF00&k:"
    permission: tags.hadesgod
    item:
      item_id: red_concrete
  warrior:
    display: "&#8B0000&k: &#8B0000ᴡ&#A00000ᴀ&#B50000ʀ&#CA0000ʀ&#DF0000ɪ&#F00000ᴏ&#FF2020ʀ"
    permission: tags.warrior
    item:
      item_id: diamond_axe
  ripbp:
    display: "&#FF5D00&k;;&r&#00FFC1ʀ&#00FFAEɪ&#00FF9Cᴘ &#00FF77ʙ&#00FF64ᴘ&#FF5D00&k;;"
    permission: tags.ripbp
    item:
      item_id: bedrock
  elite:
    display: "&#9B59B6&ki &#9B59B6ᴇʟɪᴛᴇ &#9B59B6&ki"
    permission: tags.elite
  paraguay:
    display: "&4ᴘ&fᴀ&1ʀ"
    permission: tags.paraguay
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODE3OGRlNjkxYjUwOGQ2MjQ5MTA5ZmM1NGFmNmZiYTQ5YmFhODM3N2FkMzcwNjEyZWQ2MTdkNzdkZDZhZDU4OCJ9fX0=
  builder:
    display: "&#8B4513ʙ&#9B5523ᴜ&#AB6533ɪ&#BB7543ʟ&#CB8553ᴅ&#DB9563ᴇ&#EBA573ʀ"
    permission: tags.builder
    item:
      item_id: bricks
  guardian:
    display: "&#003580&k: &#003580ɢ&#004A99ᴜ&#005EB3ᴀ&#0072CCʀ&#0086E6ᴅ&#0099FFɪ&#0086E6ᴀ&#0072CCɴ"
    permission: tags.guardian
    item:
      item_id: shield
  colombia:
    display: "&6ᴄ&1ᴏ&4ʟ"
    permission: tags.colombia
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYzcyMTIwYjlmZTc3ZDc3MGIyNTRiMzljN2JlOWIxY2VjY2VmNmFkZmU3YTVjYzY4OWFiMWZkMjNlM2MifX19
  noob:
    display: "&7&k:&#FF0000ɴ&#00FF11ᴏ&#C434C0ᴏ&#D2FF00ʙ&7&k:"
    permission: tags.noob
  mexico:
    display: "&2ᴍ&fᴇ&4x"
    permission: tags.mexico
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTNjNzlhNzhkZTVjYmVkYmQyMjEwMzZhNjRmNGM2ZWMzOTExOTYwZGUxNzZiZGJlNDliNGQ1MDFmNDFkZjMifX19
  hacker:
    display: "&7&k:&#FF0000ʜ&#F63300ᴀ&#ED6600ᴄ&#E49900ᴋ&#DBCC00ᴇ&#D2FF00ʀ&7&k:"
    permission: tags.hacker
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNGUyYzZiNjMyN2Q1ZDdkNjE2Y2RhYjM1NDMxM2E5NmQ2MTk1NzA4NGZlZTJkNDE5ZTVlODgzZTg2NjA5NjVkOSJ9fX0=
  rage:
    display: "&#8B0000&ki &#8B0000ʀᴀɢᴇ &#8B0000&ki"
    permission: tags.rage
    item:
      item_id: magma_block
  uruguay:
    display: "&fᴜ&9ʀ&fᴜ"
    permission: tags.uruguay
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNzNmNjlmNjdhNjVmYjJlNmU4MGY3MDhiNTU5ZDIzYzVmNzY5YTFmNWE1NmMzYWQ2MTliY2NhODQ0ZmMyYmZkNSJ9fX0=
  scout:
    display: "&#004D1A&k: &#004D1Aꜱ&#0D6626ᴄ&#1A8033ᴏ&#279940ᴜ&#34B34Dᴛ &#34B34D&k:"
    permission: tags.scout
    item:
      item_id: turtle_scute
  brasil:
    display: "&2ʙ&eʀ&1ᴀ"
    permission: tags.brasil
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOWE0NjQ3NWQ1ZGNjODE1ZjZjNWYyODU5ZWRiYjEwNjExZjNlODYxYzBlYjE0ZjA4ODE2MWIzYzBjY2IyYjBkOSJ9fX0=
  easter:
    display: "&#FFB3D9&k: &#FFB3D9ᴇ&#FFC9E3ᴀ&#FFD4EBꜱ&#FFDEEFᴛ&#FFE8F3ᴇ&#FFF2F8ʀ &#FFF2F8&k:"
    permission: tags.easter
  grinch:
    display: "&#0D5C00&k:&#1A6B0D&k:&#277A1Aɢ&#347927ʀ&#418834ɪ&#4E9741ɴ&#5BA64Eᴄ&#68B55Bʜ&#75C468&k:&#82D375&k:"
    permission: tags.grinch
    item:
      item_id: lime_concrete
  iefra:
    display: "&x&C&8&0&0&F&F&l&o&nʀ&x&C&8&0&0&F&F&l&o&nʜ&x&8&E&1&3&E&9&l&o&nʏ&x&5&3&2&5&D&2&l&o&nᴛ&x&1&9&3&8&B&C&l&o&nʜ&x&1&6&5&7&A&B&l&o&nᴍ&x&1&2&7&5&9&A&l&o&nɪ&x&0&F&9&4&8&9&l&o&nᴄ"
    permission: tags.iefra
    item:
      item_id: red_tulip
      lore:
        - "&8| &d🗲 Tag custom de: &6iEfra"
  argentina:
    display: "&bᴀ&eʀ&bɢ"
    permission: tags.argentina
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjZkMDMzZGM1ZjY3NWFkNTFiYzA2YzdhMTk0OWMzNWExZDM3ZTQ4YTJlMWMyNzg5YzJjZjdkMzBlYzU4ZjMyYyJ9fX0=
  legit:
    display: "&7&k:&fʟᴇɢɪᴛ&7&k:"
    permission: tags.legit
    item:
      item_id: lime_wool
  heartearth:
    display: "&fɪ&c❤&fᴇᴀʀᴛʜ"
    permission: tags.heartearth
    item:
      item_id: rose_bush
  sacerdote:
    display: "&#B8860Bꜱ&#C9950Cᴀ&#DAA520ᴄ&#EBB630ᴇ&#F5C842ʀ&#FFD700ᴅ&#F5C842ᴏ&#EBB630ᴛ&#DAA520ᴇ"
    permission: tags.sacerdote
    item:
      item_id: lantern
  ezzz:
    display: "&cᴇᴢᴢᴢ"
    permission: tags.ezzz
    item:
      item_id: redstone
  hunter:
    display: "&#1A4000ʜ&#254D00ᴜ&#306000ɴ&#3B7300ᴛ&#468600ᴇ&#519900ʀ"
    permission: tags.hunter
    item:
      item_id: diamond_sword
  toxic:
    display: "&#39FF14&ki &#39FF14ᴛᴏxɪᴄ &#39FF14&ki"
    permission: tags.toxic
    item:
      item_id: dragon_egg
  void:
    display: "&#006EFF&k::&#006EFFᴠ&#2137FFᴏ&#4100FFɪ&#4100FFᴅ&#4100FF&k::"
    permission: tags.void
    item:
      item_id: obsidian
  king:
    display: "&#CDFA1D&k: &#D6F51Cᴋ&#DEF01Bɪ&#E6EB19ɴ&#EEE618ɢ ♛ &#FFDC16&k:"
    permission: tags.king
    item:
      item_id: gold_block
  pro:
    display: "&7&k:&#FF0000ᴘ&#00FF11ʀ&#3478C4ᴏ&7&k:"
    permission: tags.pro
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWI5YzQ1OTM0NGIxZDVlNjdkMjM5YzdiZDg4NzQxZWE2MDM1ZGIzNzRkNDU0NDk5OTE0ODcxNzk4M2ZlZDg5NCJ9fX0=
  trash:
    display: "&#808080&ki &#808080ᴛʀᴀꜱʜ &#808080&ki"
    permission: tags.trash
    item:
      item_id: coal_block
  ocean:
    display: "&#003EB5&k:: &#003EB5ᴏ&#0055CCᴄ&#006BE3ᴇ&#0082FAᴀ&#0098FFɴ &#0098FF&k::"
    permission: tags.ocean
    item:
      item_id: water_bucket
  warden:
    display: "&#2D00FF&k::&#2719FFᴡ&#2031FFᴀ&#1A4AFFʀ&#1362FFᴅ&#0D7BFFᴇ&#0693FFɴ&#00ACFF&k::"
    permission: tags.warden
    item:
      item_id: sculk
  frosty:
    display: "&#4DD9FF&k:&#5DDDFF&k:&#6DE0FFꜰ&#7DE4FFʀ&#8DE8FFᴏ&#9DEBFFꜱ&#ADEFFFᴛ&#BDF3FFʏ&#FFFFFF&k:&#FFFFFF&k:"
    permission: tags.frosty
    item:
      item_id: snow_block
  chile:
    display: "&1ᴄ&fʜ&4ʟ"
    permission: tags.chile
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTAzNTk0YzBjMTE2YjA1ZDc1NjA2MGEyMjM5ODM3NzQ3ODg4NzMyMjY5MzVkOTYyNzExYmMzZTI1ODQ2ZGM2YiJ9fX0=
  peru:
    display: "&4ᴘ&fᴇ&4ʀ"
    permission: tags.peru
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMjRkMDNiZDQ0MTBiYWJkYzY4MjQ5M2IzYzJiYmEyNmU3MzBlNmJjNjU4ZDM4ODhlNzliZjcxMmY4NTMifX19
  santa:
    display: "&#FF0000&k:&#FF1A1A&k:&#FF3333ꜱ&#FF4D4Dᴀ&#FF6666ɴ&#FF8080ᴛ&#FF9999ᴀ&#FFB3B3&k:&#FFFFFF&k:"
    permission: tags.santa
    item:
      item_id: red_wool
  unitedstates:
    display: "&1ᴜ&4ꜱ&fᴀ"
    permission: tags.unitedstates
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmNiYzMyY2IyNGQ1N2ZjZGMwMzFlODUxMjM1ZGEyZGFhZDNlMTkxNGI4NzA0M2JkMDEyNjMzZTZmMzJjNyJ9fX0=
  lava:
    display: "&#FF1500ʟ&#FF3D00ᴀ&#FF6600ᴠ&#FF8C00ᴀ"
    permission: tags.lava
    item:
      item_id: lava_bucket
  vape:
    display: "&cᴠᴀᴘᴇ"
    permission: tags.vape
    item:
      item_id: barrier
  end:
    display: "&#FF00EEᴇɴᴅ"
    permission: tags.end
    item:
      item_id: end_stone
  easygame:
    display: "&dᴇᴀꜱʏɢᴀᴍᴇ"
    permission: tags.easygame
    item:
      item_id: emerald
  gg:
    display: "&e&ki &eɢɢ &e&ki"
    permission: tags.gg
    item:
      item_id: egg
  npc:
    display: "&b&ki &bɴᴘᴄ &b&ki"
    permission: tags.npc
  slayer:
    display: "&#FF00C4&k::&#FF00C4ꜱ&#DB00D8ʟ&#B800EBᴀ&#9400FFʏ&#9400FFᴇ&#9400FFʀ&#9400FF&k::"
    permission: tags.slayer
    item:
      item_id: netherite_sword
  nature:
    display: "&#1A5C00ɴ&#2E7A00ᴀ&#439800ᴛ&#57B600ᴜ&#6BD400ʀ&#80F200ᴇ"
    permission: tags.nature
    item:
      item_id: sand
  rekt:
    display: "&#FF4500&ki &#FF4500ʀᴇᴋᴛ &#FF4500&ki"
    permission: tags.rekt
    item:
      item_id: diamond_block
  espana:
    display: "&4ᴇ&eꜱ&4ᴘ"
    permission: tags.espana
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYzJkNzMwYjZkZGExNmI1ODQ3ODNiNjNkMDgyYTgwMDQ5YjVmYTcwMjI4YWJhNGFlODg0YzJjMWZjMGMzYThiYyJ9fX0=
  bolivia:
    display: "&4ʙ&6ᴏ&2ʟ"
    permission: tags.bolivia
    item:
      item_id: head:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmQyYzlmOTg2MThjZDVmN2RiZjBjMWE1NGVlMDk0NzQ2NjJiNzEzYjVhYTI2NWM4NWVmYmZjNDY0MThlOTE1In19fQ==
  earth:
    display: "&#1A6BFF&k:: &#1A6BFFᴇ&#1A8BFFᴀ&#1AA8FFʀ&#0FBF6Fᴛ&#0AD45Fʜ &#0AD45F&k::"
    permission: tags.earth
    item:
      item_id: grass_block
  nohands:
    display: "&eɴᴏ ʜᴀɴᴅꜱ"
    permission: tags.nohands
    item:
      item_id: coal

Sincronización entre modalidades

Flujo de tags

Lobby crea tag → guarda en MySQL → clientes leen al conectarse jugadores

Los clientes cargan el tag activo de cada jugador al conectarse. El tag se guarda por jugador y por modalidad, por lo que un jugador puede tener un tag diferente en cada modalidad.

Flujo de menús (gui-mode: legacy)

1. Lobby configura sus menús localmente
2. /whstags admin upload → sube menu.yml y categorías a MySQL
3. En los clientes: /whstags admin download → descarga y sobreescribe los archivos locales

Menús y categorías

Estructura de archivos

plugins/WHSTags/
  gui/
    menu.yml              ← menú principal de categorías
    categories/
      default.yml         ← una categoría con lista de tags
      mytag.yml           ← categoría especial "mis tags"
      pvp.yml             ← cualquier categoría que crees

gui/menu.yml — menú principal

title: "<dark_purple><bold>Tags"
rows: 6

items:
  fill:
    item_id: black_stained_glass_pane
    name: " "
    slots: [0-8, 45-53, 9, 18, 27, 36, 17, 26, 35, 44]

  mi-categoria:
    item_id: name_tag
    name: "<yellow>Tags generales"
    lore:
      - "<gray>Haz clic para ver los tags."
    slots: [22]

categories:
  default:
    file: default.yml
    item: mi-categoria

gui/categories/default.yml — categoría estándar

title: "<yellow>Tags generales"
rows: 6

items:
  fill:
    item_id: gray_stained_glass_pane
    name: " "
    slots: [0-8, 45-53, 9, 18, 27, 36, 17, 26, 35, 44]

  close:
    item_id: barrier
    name: "<red>✖ Cerrar"
    slots: [49]

  prev-page:
    item_id: arrow
    name: "<gray>« Anterior"
    slots: [45]

  next-page:
    item_id: arrow
    name: "<gray>» Siguiente"
    slots: [53]

tag-item:
  item_id: name_tag
  slots: [10-16, 19-25, 28-34, 37-43]

tags:
  - vip
  - mvp
  - pvp_god:
      item_id: netherite_sword
      slots: [22]
      name: "<red>Dios del PvP"
      lore:
        - "<gray>Solo para los mejores"

Categoría especial: "Mis Tags"

title: "<gold>Mis Tags"
rows: 6
type: my-tags   # ← muestra solo los tags que el jugador tiene permiso

No necesita lista tags: — muestra automáticamente todos los tags del servidor que el jugador tenga permiso. Si no tiene ninguno, aparece una barrera en el centro con un mensaje.

Definición de items

mi-item:
  item_id: diamond_sword
  name: "<red>Nombre"
  slots: [0-8, 22, 45]
  quantity: 1
  lore:
    - "<gray>Línea 1"
    - "<gray>Línea 2"
  attributes:
    - hide_attributes
    - hide_enchants
    - hide_unbreakable
  enchants:
    - sharpness:5
    - unbreaking:3

Cabezas de jugadores

Podés usar cabezas de jugadores como item_id en cualquier ítem de menú.

mi-item:
  item_id: head:Notch        # por nick de jugador
  name: "<white>Notch"
  slots: [22]

mi-item2:
  item_id: head:eyJ0ZXh0dX... # por ID en Base64
  name: "<white>Custom Head"
  slots: [23]

Banners con patrones

Podés definir banners con patrones personalizados agregando la clave banner al ítem. Los patrones disponibles están en la wiki de Minecraft.

mi-banner:
  item_id: white_banner
  name: "<white>Banner"
  slots: [22]
  banner:
    - pattern: stripe_top
      color: RED
    - pattern: gradient
      color: BLACK
    - pattern: flower
      color: YELLOW

Override por tag

tags:
  - tag_normal
  - tag_con_item:
      item_id: diamond
  - tag_completo:
      item_id: netherite_sword
      slots: [22]
      name: "<gold>Tag Especial"
      lore:
        - "<gray>Tag exclusivo"

Formato de slots

slots: [22]              # slot único
slots: [0-8]             # rango del 0 al 8 (incluido)
slots: [0-8, 45-53]      # múltiples rangos
slots: [10, 15, 20]      # slots individuales
slots: [0-8, 9, 17, 44]  # combinación de todo

gui-layout: Diseño del menú

Controla qué carpeta usa el plugin como menú principal. Acepta dos valores:

Valor	Descripción
`default`	Comportamiento normal. El plugin usa la carpeta `gui/` como siempre.
`hub`	El plugin usa una segunda carpeta `gui_hub/` como menú principal. Tiene su propio `menu.yml` y `categories/`, pero puede referenciar archivos de `gui/categories/` sin duplicarlos. Si un archivo no existe en `gui_hub/categories/`, el plugin lo busca automáticamente en `gui/categories/`.

gui_hub/ es completamente local — nunca se sube ni se descarga con /whstags admin upload o download. Esos comandos solo afectan a gui/.

¿Para qué sirve?

Es útil cuando querés un menú principal que agrupe las modalidades del servidor (Modalidad 1, Modalidad 2, Modalidad 3) y que al hacer clic en cada una muestre sus propias categorías de tags, todo sin modificar la configuración base de gui/.

Estructura con gui-layout: hub

plugins/WHSTags/
  gui/
    menu.yml
    categories/
      pvp.yml
      paises.yml
      clanes.yml
  gui_hub/
    menu.yml              ← menú principal con botones por modalidad
    categories/
      earth.yml           ← puede referenciar pvp.yml de gui/categories/
      survival-op.yml
      survival-pvp.yml

PlaceholderAPI

Requiere PlaceholderAPI instalado. Se registra automáticamente al iniciar el servidor.

Placeholder	Retorna	Ejemplo
`%whstags_tag%`	Display del tag con colores	`<gold>VIP`
`%whstags_tag_plain%`	Display sin colores	`VIP`
`%whstags_tag_id%`	ID interno del tag	`vip`
`%whstags_has_tag%`	Si el jugador tiene tag activo	`true` / `false`

Uso en otros plugins

# Chat (EssentialsX, CMI, etc.)
{%whstags_tag%} %player_name%: %message%

# TAB
%whstags_tag_plain% | %player_name%

# DecentHolograms
{papi: %whstags_tag%}
{papi: %player_name%}

# Condición (si tiene tag)
%whstags_has_tag% == true

Compatibilidad Bedrock

El plugin detecta automáticamente jugadores de Bedrock via Geyser/Floodgate si están instalados. No requiere configuración adicional.

Base de datos

Por defecto el plugin usa H2 embebida. No requiere instalar ni configurar ninguna base de datos externa; las tablas se crean solas al iniciar.

Para sincronizar tags y menús entre modalidades (mode: lobby + client), configurá MySQL en config.yml. La base de datos whs_tags debe existir antes de iniciar el plugin.

Tabla	Contenido
`whs_tags`	Todos los tags creados (id, display)
`whs_player_tags`	Tag activo de cada jugador por modalidad
`whs_gui_config`	Archivos YML de menús subidos desde el lobby

Las tablas se crean automáticamente al iniciar el plugin, tanto en H2 como en MySQL.

Si usás MySQL y al iniciar el servidor aparece un mensaje indicando que falta la configuración de la base de datos, editá plugins/WHSTags/config.yml con los datos de tu MySQL y reiniciá el servidor. Con H2 (valor por defecto) no se requiere ninguna configuración adicional.

MySQL

CREATE DATABASE whs_tags CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;