Prefixe de rang LuckPerms cu insigne ca imagini (ItemsAdder)

Cum funcționează prefixele cu imagini

Chatul din Minecraft poate afișa doar text. Un resource pack poate adăuga caractere noi unui font, iar ItemsAdder transformă orice PNG într-un astfel de caracter, numit font image (imagine de font). După ce packul e încărcat, insigna e doar încă un caracter pe rând.

Trei pluginuri își împart treaba:

• ItemsAdder construiește resource packul și înlocuiește %img_<name>% (PlaceholderAPI) sau propriul tag :<name>: cu caracterul insignei.
• LuckPerms stochează ce grup poartă ce prefix și decide după prioritate când un jucător are mai multe.
• Pluginurile tale de chat și tab citesc prefixul LuckPerms, prin Vault sau prin placeholderul PlaceholderAPI %luckperms_prefix%, și îl afișează. LuckPerms în sine nu formatează chatul.

Pasul 1: Fă imaginile insignelor

Creează-ți rangurile în generatorul de prefixe de rang. Fiecare insignă are implicit 8 pixeli înălțime, cum cere wiki-ul ItemsAdder, și e cât de lată e textul ei. Pune rangurile în ordine: vârful listei primește cea mai mare prioritate LuckPerms. Setează un namespace (numele folderului, implicit ranks) și apasă Descarcă toate ca ZIP.

ZIP-ul conține câte un PNG pentru fiecare rang, un ranks.yml și un README cu toate comenzile:

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

Pasul 2: Adaugă imaginile de font în ItemsAdder

Copiază folderul ranks în plugins/ItemsAdder/contents/. Configul înregistrează fiecare insignă ca imagine de font:

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 se potrivește cu imaginea de 8 pixeli, deci un pixel din imagine e un pixel de font, iar y_position: 7 pune insigna pe linia textului. Dacă alegi altă înălțime, generatorul schimbă ambele valori odată cu ea. ItemsAdder cere ca y_position să fie mai mic sau egal cu scale_ratio.
• Rândul permission decide doar cine poate scrie insigna ca emoji în chat. Cine o poartă în fața numelui decide LuckPerms.
• path arată spre PNG-ul din folderul textures al namespace-ului.

Rulează /iazip în consolă și așteaptă până când resource packul e refăcut. Jucătorii văd insignele abia după ce au încărcat noul pack.

Pasul 3: Setează prefixul cu LuckPerms

Creează grupurile dacă nu există încă, apoi setează prefixul fiecărui grup. Generatorul scrie aceste rânduri pentru toate rangurile deodată:

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

• Numărul e prioritatea. Dacă un jucător e în mai multe grupuri, LuckPerms arată prefixul cu prioritatea cea mai mare. Generatorul îi dă rangului de sus numărul cel mai mare, din zece în zece.
• setprefix înlocuiește prefixele existente ale grupului în același context. addprefix ar adăuga încă unul lângă ele.
• Ghilimelele sunt necesare pentru că prefixul se termină cu un spațiu, care ține insigna separată de nume.
• Elimini un prefix cu lp group vip meta removeprefix 10.

Vrei mai multe insigne la rând, de exemplu o insignă de rang și una de donator? LuckPerms poate cumula prefixe cu secțiunea meta-formatting din config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Pasul 4: Afișează insigna în chat și tab

Prefixul conține acum %img_admin%. Ceva trebuie să înlocuiască acel placeholder cu insigna. Pluginul de chat sau de tab trebuie să afișeze prefixul LuckPerms și să proceseze placeholderele PlaceholderAPI din el.

1. Instalează PlaceholderAPI și expansionul LuckPerms: /papi ecloud download LuckPerms, apoi /papi reload.
2. Folosește %luckperms_prefix% în formatul de chat sau lasă pluginul de chat să citească prefixul prin Vault.
3. Pentru lista tab, wiki-ul ItemsAdder arată pluginul TAB cu placeholderul imaginii direct în prefixul grupului și apoi /tab reload:

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

Tagul propriu ItemsAdder :admin: merge acolo unde ItemsAdder înlocuiește singur textul. Pluginurile care înțeleg doar PlaceholderAPI au nevoie în schimb de %img_admin%, de aceea generatorul folosește forma de placeholder.

Prefixe text fără resource pack

Dacă nu vrei un resource pack, merg și prefixele text colorate. Generatorul le scrie și pe acestea, cu culori hex &# și îngroșat:

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

Culorile hex au nevoie de Minecraft 1.16 sau mai nou și de un plugin de chat care înțelege &#RRGGBB. Pentru pluginurile de chat care citesc MiniMessage, copiază în schimb rândurile MiniMessage cu <gradient>. Mai multe despre formatele de culoare găsești în ghidul despre culori MOTD, hex și gradienturi.

Erori frecvente și soluții

Aceeași tehnică cu imagini de font desenează și fundaluri întregi de meniu, vezi fundaluri de GUI personalizate în DeluxeMenus cu ItemsAdder. Iar dacă rangurile tale vin cu avantaje pentru vot, ghidul despre recompense de vot cu VotingPlugin arată cum le împarți.