Prefissi dei rank LuckPerms con badge in immagine (ItemsAdder)

Come funzionano i prefissi con immagini

La chat di Minecraft può mostrare solo testo. Un resource pack può aggiungere nuovi caratteri a un font, e ItemsAdder trasforma qualsiasi PNG in un carattere del genere, chiamato font image. Una volta caricato il pack, il badge è solo un carattere in più nella riga.

Tre plugin si dividono il lavoro:

• ItemsAdder costruisce il resource pack e sostituisce %img_<nome>% (PlaceholderAPI) o il suo tag :<nome>: con il carattere del badge.
• LuckPerms memorizza quale gruppo porta quale prefisso e, se un giocatore ne ha più di uno, decide in base alla priorità.
• I tuoi plugin di chat e tab leggono il prefisso di LuckPerms, tramite Vault o il placeholder di PlaceholderAPI %luckperms_prefix%, e lo mostrano. LuckPerms da solo non formatta la chat.

Passo 1: crea le immagini dei badge

Disegna i tuoi rank nel generatore di prefissi rank. Ogni badge è alto 8 pixel di default, come chiede la wiki di ItemsAdder, e largo quanto il suo testo. Metti i rank in ordine: il primo della lista riceve la priorità LuckPerms più alta. Imposta un namespace (il nome della cartella, di default ranks) e premi Scarica tutti come ZIP.

Lo ZIP contiene un PNG per rank, un ranks.yml e un README con tutti i comandi:

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

Passo 2: aggiungi le font image a ItemsAdder

Copia la cartella ranks in plugins/ItemsAdder/contents/. La config registra ogni badge come 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 corrisponde all’immagine da 8 pixel, quindi un pixel dell’immagine è un pixel del font, e y_position: 7 mette il badge sulla riga del testo. Se scegli un’altra altezza, il generatore cambia entrambi i valori. ItemsAdder richiede che y_position sia minore o uguale a scale_ratio.
• La riga permission decide solo chi può scrivere il badge come emoji in chat. Chi lo porta davanti al nome lo decide LuckPerms.
• path punta al PNG nella cartella textures del namespace.

Esegui /iazip in console e aspetta che il resource pack venga ricostruito. I giocatori vedono i badge solo dopo aver caricato il nuovo pack.

Passo 3: imposta il prefisso con LuckPerms

Crea i gruppi se non esistono ancora, poi imposta il prefisso di ogni gruppo. Il generatore scrive queste righe per tutti i rank in una volta:

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

• Il numero è la priorità. Se un giocatore è in più gruppi, LuckPerms mostra il prefisso con la priorità più alta. Il generatore dà al rank più alto il numero più alto, a passi di dieci.
• setprefix sostituisce i prefissi esistenti di quel gruppo nello stesso contesto. addprefix ne aggiungerebbe un altro accanto.
• Le virgolette servono perché il prefisso finisce con uno spazio, che tiene il badge separato dal nome.
• Rimuovi un prefisso con lp group vip meta removeprefix 10.

Vuoi più badge in fila, per esempio un badge del rank e uno da donatore? LuckPerms può impilare i prefissi con la sezione meta-formatting nel suo config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Passo 4: mostra il badge in chat e nella tab

Ora il prefisso contiene %img_admin%. Qualcosa deve sostituire quel placeholder con il badge. Il plugin di chat o di tab deve mostrare il prefisso di LuckPerms ed elaborare i placeholder di PlaceholderAPI al suo interno.

1. Installa PlaceholderAPI e l’espansione di LuckPerms: /papi ecloud download LuckPerms, poi /papi reload.
2. Usa %luckperms_prefix% nel formato della chat, oppure lascia che il plugin di chat legga il prefisso tramite Vault.
3. Per la lista tab, la wiki di ItemsAdder mostra il plugin TAB con il placeholder dell’immagine direttamente nel prefisso del gruppo, seguito da /tab reload:

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

Il tag :admin: di ItemsAdder funziona dove ItemsAdder sostituisce il testo da solo. I plugin che capiscono solo PlaceholderAPI hanno bisogno di %img_admin%, ed è per questo che il generatore usa la forma con il placeholder.

Prefissi di testo senza resource pack

Se non vuoi un resource pack, funzionano anche i prefissi di testo colorati. Il generatore li scrive anche con colori hex &# e grassetto:

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

I colori hex richiedono Minecraft 1.16 o successivo e un plugin di chat che capisca &#RRGGBB. Per i plugin di chat che leggono MiniMessage, copia invece le righe MiniMessage con <gradient>. Trovi di più sui formati colore nella guida a colori del MOTD, hex e sfumature.

Errori comuni e soluzioni

La stessa tecnica delle font image disegna anche interi sfondi di menu, vedi sfondi GUI personalizzati in DeluxeMenus con ItemsAdder. E se i tuoi rank includono vantaggi per chi vota, la guida alle ricompense per i voti con VotingPlugin ti mostra come assegnarli.