LuckPerms-rankpræfikser med billedbadges (ItemsAdder)

Sådan virker billedpræfikser

Minecrafts chat kan kun vise tekst. En resource pack kan tilføje nye tegn til en skrifttype, og ItemsAdder laver enhver PNG om til sådan et tegn, et såkaldt font image. Når packen er indlæst, er badget bare ét tegn mere i linjen.

Tre plugins deler arbejdet:

• ItemsAdder bygger resource packen og erstatter %img_<name>% (PlaceholderAPI) eller sit eget :<name>:-tag med badge-tegnet.
• LuckPerms gemmer, hvilken gruppe der bærer hvilket præfiks, og afgør ud fra prioritet, når en spiller har flere.
• Dine chat- og tab-plugins læser LuckPerms-præfikset via Vault eller PlaceholderAPI-placeholderen %luckperms_prefix% og viser det. LuckPerms formaterer ikke selv chatten.

Trin 1: Lav badge-billederne

Design dine ranks i rank-præfiks-generatoren. Hvert badge er som standard 8 pixels højt, som ItemsAdder-wikien foreskriver, og lige så bredt som sin tekst. Sæt dine ranks i rækkefølge: toppen af listen får den højeste LuckPerms-prioritet. Angiv et namespace (mappenavnet, som standard ranks), og tryk på Download alle som ZIP.

ZIP-filen indeholder én PNG pr. rank, en ranks.yml og en README med alle kommandoer:

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

Trin 2: Tilføj font images til ItemsAdder

Kopiér mappen ranks ind i plugins/ItemsAdder/contents/. Configen registrerer hvert badge som et 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 passer til billedet på 8 pixels, så én billedpixel er én skriftpixel, og y_position: 7 sætter badget på tekstlinjen. Vælger du en anden højde, ændrer generatoren begge værdier med. ItemsAdder kræver, at y_position er mindre end eller lig med scale_ratio.
• Linjen permission afgør kun, hvem der må skrive badget som emoji i chatten. Hvem der bærer det foran navnet, afgør LuckPerms.
• path peger på PNG’en i namespacets textures-mappe.

Kør /iazip i konsollen, og vent, til resource packen er bygget igen. Spillere ser først badges, når de har indlæst den nye pack.

Trin 3: Sæt præfikset med LuckPerms

Opret grupperne, hvis de ikke findes endnu, og sæt så præfikset for hver gruppe. Generatoren skriver disse linjer for alle ranks på én gang:

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

• Tallet er prioriteten. Er en spiller i flere grupper, viser LuckPerms præfikset med den højeste prioritet. Generatoren giver den øverste rank det højeste tal, i trin på ti.
• setprefix erstatter gruppens eksisterende præfikser i samme kontekst. addprefix ville tilføje endnu et ved siden af.
• Anførselstegnene er nødvendige, fordi præfikset slutter med et mellemrum, som holder badget adskilt fra navnet.
• Fjern et præfiks med lp group vip meta removeprefix 10.

Vil du have flere badges på række, f.eks. et rankbadge og et donorbadge? LuckPerms kan stable præfikser med afsnittet meta-formatting i sin config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Trin 4: Vis badget i chat og tab

Præfikset indeholder nu %img_admin%. Noget skal erstatte den placeholder med badget. Chat- eller tab-pluginet skal vise LuckPerms-præfikset og fortolke PlaceholderAPI-placeholders inde i det.

1. Installer PlaceholderAPI og LuckPerms-expansionen: /papi ecloud download LuckPerms, derefter /papi reload.
2. Brug %luckperms_prefix% i dit chatformat, eller lad chatpluginet læse præfikset via Vault.
3. Til tab-listen viser ItemsAdder-wikien TAB-pluginet med billed-placeholderen direkte i gruppepræfikset og derefter /tab reload:

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

ItemsAdders eget :admin:-tag virker der, hvor ItemsAdder selv erstatter tekst. Plugins, der kun forstår PlaceholderAPI, skal have %img_admin% i stedet, og derfor bruger generatoren placeholder-formen.

Tekstpræfikser uden resource pack

Vil du ikke have en resource pack, virker farvede tekstpræfikser også. Generatoren skriver dem også med &#-hex-farver og fed skrift:

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

Hex-farver kræver Minecraft 1.16 eller nyere og et chatplugin, der forstår &#RRGGBB. Til chatplugins, der læser MiniMessage, kopierer du i stedet MiniMessage-linjerne med <gradient>. Mere om farveformater står i guiden til MOTD-farver, hex og gradienter.

Typiske fejl og løsninger

Samme teknik med font images tegner også hele menubaggrunde, se egne GUI-baggrunde i DeluxeMenus med ItemsAdder. Og følger der stemmefordele med dine ranks, viser guiden til stemmebelønninger med VotingPlugin, hvordan du deler dem ud.