WHSTags

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:

¿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.

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

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.

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

MySQL

CREATE DATABASE whs_tags CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;