LuckPerms-rankprefixen met badges als afbeelding (ItemsAdder)

Zo werken prefixen als afbeelding

De Minecraft-chat kan alleen tekst tonen. Een resource pack kan nieuwe tekens aan een lettertype toevoegen, en ItemsAdder maakt van elke PNG zo’n teken, een font image. Zodra het pack geladen is, is de badge gewoon één teken extra in de regel.

Drie plugins verdelen het werk:

• ItemsAdder bouwt het resource pack en vervangt %img_<name>% (PlaceholderAPI) of de eigen :<name>:-tag door het badgeteken.
• LuckPerms slaat op welke groep welke prefix draagt en beslist op prioriteit als een speler er meerdere heeft.
• Je chat- en tabplugins lezen de LuckPerms-prefix, via Vault of de PlaceholderAPI-placeholder %luckperms_prefix%, en tonen hem. LuckPerms zelf maakt de chat niet op.

Stap 1: Maak de badgeafbeeldingen

Ontwerp je ranks in de rankprefix-generator. Elke badge is standaard 8 pixels hoog, zoals de ItemsAdder-wiki vraagt, en zo breed als de tekst. Zet de ranks op volgorde: bovenaan de lijst krijgt de hoogste LuckPerms-prioriteit. Stel een namespace in (de mapnaam, standaard ranks) en klik op Alle als ZIP downloaden.

De ZIP bevat één PNG per rank, een ranks.yml en een README met alle commando’s:

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

Stap 2: Voeg de font images toe aan ItemsAdder

Kopieer de map ranks naar plugins/ItemsAdder/contents/. De config registreert elke badge als 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 past bij de afbeelding van 8 pixels, zodat één afbeeldingspixel één fontpixel is, en y_position: 7 zet de badge op de tekstregel. Kies je een andere hoogte, dan past de generator beide waarden mee aan. ItemsAdder eist dat y_position kleiner dan of gelijk aan scale_ratio is.
• De regel permission bepaalt alleen wie de badge als chatemoji mag typen. Wie hem vóór de naam draagt, bepaalt LuckPerms.
• path wijst naar de PNG in de map textures van de namespace.

Voer /iazip uit in de console en wacht tot het resource pack opnieuw is gebouwd. Spelers zien badges pas als ze het nieuwe pack hebben geladen.

Stap 3: Stel de prefix in met LuckPerms

Maak de groepen aan als ze nog niet bestaan en stel daarna de prefix van elke groep in. De generator schrijft deze regels voor alle ranks tegelijk:

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

• Het getal is de prioriteit. Zit een speler in meerdere groepen, dan toont LuckPerms de prefix met de hoogste prioriteit. De generator geeft de hoogste rank het hoogste getal, in stappen van tien.
• setprefix vervangt bestaande prefixen van die groep in dezelfde context. addprefix zou er nog een naast zetten.
• De aanhalingstekens zijn nodig omdat de prefix eindigt met een spatie, die de badge van de naam scheidt.
• Een prefix verwijder je met lp group vip meta removeprefix 10.

Wil je meerdere badges naast elkaar, bijvoorbeeld een rankbadge en een donateursbadge? LuckPerms kan prefixen stapelen met het onderdeel meta-formatting in zijn config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Stap 4: Toon de badge in chat en tab

De prefix bevat nu %img_admin%. Iets moet die placeholder door de badge vervangen. De chat- of tabplugin moet de LuckPerms-prefix tonen en de PlaceholderAPI-placeholders daarin verwerken.

1. Installeer PlaceholderAPI en de LuckPerms-expansion: /papi ecloud download LuckPerms, daarna /papi reload.
2. Gebruik %luckperms_prefix% in je chatformaat, of laat de chatplugin de prefix via Vault lezen.
3. Voor de tablijst laat de ItemsAdder-wiki de TAB-plugin zien met de afbeeldingsplaceholder direct in de groepsprefix, en daarna /tab reload:

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

De eigen :admin:-tag van ItemsAdder werkt waar ItemsAdder zelf tekst vervangt. Plugins die alleen PlaceholderAPI begrijpen, hebben %img_admin% nodig; daarom gebruikt de generator de placeholdervorm.

Tekstprefixen zonder resource pack

Wil je geen resource pack, dan werken gekleurde tekstprefixen ook. De generator schrijft ze ook met &#-hexkleuren en vet:

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

Hexkleuren vereisen Minecraft 1.16 of nieuwer en een chatplugin die &#RRGGBB begrijpt. Voor chatplugins die MiniMessage lezen, kopieer je in plaats daarvan de MiniMessage-regels met <gradient>. Meer over kleurformaten lees je in de handleiding over MOTD-kleuren, hex en gradiënten.

Veelvoorkomende fouten en oplossingen

Met dezelfde font image-techniek teken je ook complete menuachtergronden, zie eigen GUI-achtergronden in DeluxeMenus met ItemsAdder. En als je ranks met stemvoordelen komen, laat de handleiding over stembeloningen met VotingPlugin zien hoe je ze uitdeelt.