Prefijos de rango con imagen en LuckPerms (ItemsAdder)

Cómo funcionan los prefijos con imagen

El chat de Minecraft solo puede mostrar texto. Un paquete de recursos puede añadir caracteres nuevos a una fuente, e ItemsAdder convierte cualquier PNG en uno de esos caracteres, llamado font image. Con el paquete cargado, la insignia es un carácter más en la línea.

Tres plugins se reparten el trabajo:

• ItemsAdder genera el paquete de recursos y sustituye %img_<nombre>% (PlaceholderAPI) o su propia etiqueta :<nombre>: por el carácter de la insignia.
• LuckPerms guarda qué grupo lleva qué prefijo y decide por prioridad cuando un jugador tiene varios.
• Tus plugins de chat y tab leen el prefijo de LuckPerms, a través de Vault o del placeholder de PlaceholderAPI %luckperms_prefix%, y lo muestran. LuckPerms no da formato al chat por sí mismo.

Paso 1: Crea las imágenes de las insignias

Diseña tus rangos en el Generador de prefijos de rango. Cada insignia mide 8 píxeles de alto por defecto, como pide la wiki de ItemsAdder, y es tan ancha como su texto. Ordena los rangos: el primero de la lista recibe la prioridad más alta en LuckPerms. Pon un namespace (el nombre de la carpeta, ranks por defecto) y pulsa Descargar todas en ZIP.

El ZIP trae un PNG por rango, un ranks.yml y un README con todos los comandos:

ranks/
  configs/ranks.yml
  textures/admin.png
  textures/vip.png
README.txt

Paso 2: Añade las font images a ItemsAdder

Copia la carpeta ranks en plugins/ItemsAdder/contents/. La configuración registra cada insignia como font image:

info:
  namespace: ranks
font_images:
  admin:
    permission: "ranks.admin"
    show_in_gui: true
    suggest_in_command: false
    path: "admin.png"
    scale_ratio: 8
    y_position: 7
  vip:
    permission: "ranks.vip"
    show_in_gui: true
    suggest_in_command: false
    path: "vip.png"
    scale_ratio: 8
    y_position: 7

• scale_ratio: 8 coincide con la imagen de 8 píxeles, así que un píxel de la imagen es un píxel de la fuente, y y_position: 7 coloca la insignia en la línea de texto. Si eliges otra altura, el generador cambia ambos valores con ella. ItemsAdder exige que y_position sea menor o igual que scale_ratio.
• La línea permission solo decide quién puede escribir la insignia como emoji en el chat. Quién la lleva delante del nombre lo decide LuckPerms.
• path apunta al PNG dentro de la carpeta textures del namespace.

Ejecuta /iazip en la consola y espera a que se regenere el paquete de recursos. Los jugadores solo ven las insignias cuando han cargado el paquete nuevo.

Paso 3: Pon el prefijo con LuckPerms

Crea los grupos si todavía no existen y luego pon el prefijo de cada grupo. El generador escribe estas líneas para todos los rangos a la vez:

lp creategroup admin
lp creategroup vip
lp group admin meta setprefix 20 "%img_admin% "
lp group vip meta setprefix 10 "%img_vip% "
lp user Steve parent add vip

• El número es la prioridad. Si un jugador está en varios grupos, LuckPerms muestra el prefijo con la prioridad más alta. El generador da al rango superior el número más alto, de diez en diez.
• setprefix reemplaza los prefijos que ya tenga ese grupo en el mismo contexto. addprefix añadiría otro al lado.
• Las comillas hacen falta porque el prefijo termina con un espacio, que separa la insignia del nombre.
• Quita un prefijo con lp group vip meta removeprefix 10.

¿Quieres varias insignias seguidas, por ejemplo una de rango y otra de donador? LuckPerms puede apilar prefijos con la sección meta-formatting de su config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Paso 4: Muestra la insignia en el chat y el tab

Ahora el prefijo contiene %img_admin%. Algo tiene que sustituir ese placeholder por la insignia. El plugin de chat o de tab debe mostrar el prefijo de LuckPerms e interpretar los placeholders de PlaceholderAPI que contiene.

1. Instala PlaceholderAPI y la expansión de LuckPerms: /papi ecloud download LuckPerms y después /papi reload.
2. Usa %luckperms_prefix% en el formato de tu chat, o deja que el plugin de chat lea el prefijo a través de Vault.
3. Para la lista del tab, la wiki de ItemsAdder muestra el plugin TAB con el placeholder de la imagen directamente en el prefijo del grupo y después /tab reload:

  Admin:
    tabprefix: '%img_admin%  '
    tagprefix: '%img_admin%  '

La etiqueta propia de ItemsAdder :admin: funciona donde ItemsAdder reemplaza el texto por sí mismo. Los plugins que solo entienden PlaceholderAPI necesitan %img_admin%, por eso el generador usa la forma de placeholder.

Prefijos de texto sin paquete de recursos

Si no quieres un paquete de recursos, también sirven los prefijos de texto de colores. El generador los escribe además con colores hex &# y negrita:

lp group vip meta setprefix 10 "&#0599AD&lVIP &r"

Los colores hex necesitan Minecraft 1.16 o superior y un plugin de chat que entienda &#RRGGBB. Para plugins de chat que leen MiniMessage, copia en su lugar las líneas MiniMessage con <gradient>. Tienes más sobre formatos de color en la guía de colores del MOTD, hex y degradados.

Errores comunes y soluciones

La misma técnica de font images también dibuja fondos de menú completos; mira fondos de GUI personalizados en DeluxeMenus con ItemsAdder. Y si tus rangos vienen con ventajas por votar, la guía de recompensas por votar con VotingPlugin explica cómo repartirlas.