Prefixos de rang amb imatge a LuckPerms (ItemsAdder)

Com funcionen els prefixos amb imatge

El xat de Minecraft només pot mostrar text. Un paquet de recursos pot afegir caràcters nous a una font, i ItemsAdder converteix qualsevol PNG en un d’aquests caràcters, anomenat font image. Amb el paquet carregat, la insígnia és un caràcter més a la línia.

Tres plugins es reparteixen la feina:

• ItemsAdder genera el paquet de recursos i substitueix %img_<nom>% (PlaceholderAPI) o la seva pròpia etiqueta :<nom>: pel caràcter de la insígnia.
• LuckPerms desa quin grup porta quin prefix i decideix per prioritat quan un jugador en té diversos.
• Els teus plugins de xat i tab llegeixen el prefix de LuckPerms, a través de Vault o del placeholder de PlaceholderAPI %luckperms_prefix%, i el mostren. LuckPerms no dona format al xat per si mateix.

Pas 1: crea les imatges de les insígnies

Dissenya els teus rangs al Generador de prefixos de rang. Cada insígnia fa 8 píxels d’alçada per defecte, com demana la wiki d’ItemsAdder, i és tan ampla com el seu text. Ordena els rangs: el primer de la llista rep la prioritat més alta a LuckPerms. Posa un namespace (el nom de la carpeta, ranks per defecte) i prem Descarrega-ho tot en ZIP.

El ZIP conté un PNG per rang, un ranks.yml i un README amb totes les comandes:

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

Pas 2: afegeix les font images a ItemsAdder

Copia la carpeta ranks a plugins/ItemsAdder/contents/. La configuració registra cada insígnia com a 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 coincideix amb la imatge de 8 píxels, de manera que un píxel de la imatge és un píxel de la font, i y_position: 7 col·loca la insígnia a la línia de text. Si tries una altra alçada, el generador canvia tots dos valors. ItemsAdder exigeix que y_position sigui menor o igual que scale_ratio.
• La línia permission només decideix qui pot escriure la insígnia com a emoji al xat. Qui la porta davant del nom ho decideix LuckPerms.
• path apunta al PNG dins de la carpeta textures del namespace.

Executa /iazip a la consola i espera que es regeneri el paquet de recursos. Els jugadors només veuen les insígnies quan han carregat el paquet nou.

Pas 3: posa el prefix amb LuckPerms

Crea els grups si encara no existeixen i després posa el prefix de cada grup. El generador escriu aquestes línies per a tots els rangs alhora:

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 és la prioritat. Si un jugador és en diversos grups, LuckPerms mostra el prefix amb la prioritat més alta. El generador dona al rang superior el número més alt, de deu en deu.
• setprefix substitueix els prefixos que ja tingui aquest grup en el mateix context. addprefix n’afegiria un altre al costat.
• Les cometes calen perquè el prefix acaba amb un espai, que separa la insígnia del nom.
• Treu un prefix amb lp group vip meta removeprefix 10.

Vols diverses insígnies seguides, per exemple una de rang i una altra de donador? LuckPerms pot apilar prefixos amb la secció meta-formatting del seu config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Pas 4: mostra la insígnia al xat i al tab

Ara el prefix conté %img_admin%. Alguna cosa ha de substituir aquest placeholder per la insígnia. El plugin de xat o de tab ha de mostrar el prefix de LuckPerms i interpretar els placeholders de PlaceholderAPI que conté.

1. Instal·la PlaceholderAPI i l’expansió de LuckPerms: /papi ecloud download LuckPerms i després /papi reload.
2. Fes servir %luckperms_prefix% al format del teu xat, o deixa que el plugin de xat llegeixi el prefix a través de Vault.
3. Per a la llista del tab, la wiki d’ItemsAdder mostra el plugin TAB amb el placeholder de la imatge directament al prefix del grup i després /tab reload:

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

L’etiqueta pròpia d’ItemsAdder :admin: funciona allà on ItemsAdder substitueix el text per si mateix. Els plugins que només entenen PlaceholderAPI necessiten %img_admin%, per això el generador fa servir la forma de placeholder.

Prefixos de text sense paquet de recursos

Si no vols un paquet de recursos, també serveixen els prefixos de text de colors. El generador també els escriu amb colors hex &# i negreta:

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

Els colors hex necessiten Minecraft 1.16 o superior i un plugin de xat que entengui &#RRGGBB. Per a plugins de xat que llegeixen MiniMessage, copia en lloc d’això les línies MiniMessage amb <gradient>. Tens més informació sobre formats de color a la guia de colors del MOTD, hex i degradats.

Errors comuns i solucions

La mateixa tècnica de font images també dibuixa fons de menú complets; mira fons de GUI personalitzats a DeluxeMenus amb ItemsAdder. I si els teus rangs inclouen avantatges per votar, la guia de recompenses per votar amb VotingPlugin explica com repartir-les.