Rankprefix i LuckPerms med bildbadges (ItemsAdder)

Så fungerar bildprefix

Minecrafts chatt kan bara visa text. Ett resource pack kan lägga till nya tecken i ett typsnitt, och ItemsAdder gör om vilken PNG som helst till ett sådant tecken, en så kallad font image (typsnittsbild). När packet är laddat är badgen bara ett tecken till på raden.

Tre plugins delar på jobbet:

• ItemsAdder bygger resource packet och ersätter %img_<name>% (PlaceholderAPI) eller sin egen tagg :<name>: med badgens tecken.
• LuckPerms sparar vilken grupp som har vilket prefix och avgör utifrån prioritet när en spelare har flera.
• Dina chatt- och tabplugins läser LuckPerms-prefixet, via Vault eller PlaceholderAPI-placeholdern %luckperms_prefix%, och visar det. LuckPerms formaterar inte själv chatten.

Steg 1: Gör badgebilderna

Designa dina ranker i rankprefix-generatorn. Varje badge är som standard 8 pixlar hög, som ItemsAdder-wikin anger, och lika bred som sin text. Lägg rankerna i ordning: överst i listan får den högsta prioriteten i LuckPerms. Ange ett namespace (mappnamnet, ranks som standard) och tryck på Ladda ner alla som ZIP.

ZIP-filen innehåller en PNG per rank, en ranks.yml och en README med alla kommandon:

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

Steg 2: Lägg till typsnittsbilderna i ItemsAdder

Kopiera mappen ranks till plugins/ItemsAdder/contents/. Configen registrerar varje badge som en typsnittsbild:

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 motsvarar bilden på 8 pixlar, så en bildpixel blir en teckenpixel, och y_position: 7 placerar badgen på textraden. Väljer du en annan höjd ändrar generatorn båda värdena i takt. ItemsAdder kräver att y_position är mindre än eller lika med scale_ratio.
• Raden permission avgör bara vem som får skriva badgen som emoji i chatten. Vem som bär den framför namnet avgör LuckPerms.
• path pekar på PNG:en i namespacets mapp textures.

Kör /iazip i konsolen och vänta tills resource packet har byggts om. Spelarna ser badges först när de har laddat det nya packet.

Steg 3: Sätt prefixet med LuckPerms

Skapa grupperna om de inte finns än och sätt sedan prefixet för varje grupp. Generatorn skriver de här raderna för alla ranker på en gång:

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

• Siffran är prioriteten. Om en spelare är med i flera grupper visar LuckPerms prefixet med högst prioritet. Generatorn ger toppranken det högsta talet, i steg om tio.
• setprefix ersätter befintliga prefix för gruppen i samma kontext. addprefix skulle lägga till ett till bredvid dem.
• Citattecknen behövs eftersom prefixet slutar med ett mellanslag, som håller isär badgen och namnet.
• Ta bort ett prefix med lp group vip meta removeprefix 10.

Vill du ha flera badges i rad, till exempel en rankbadge och en donatorbadge? LuckPerms kan stapla prefix med avsnittet meta-formatting i sin config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Steg 4: Visa badgen i chatt och tab

Prefixet innehåller nu %img_admin%. Något måste ersätta placeholdern med badgen. Chatt- eller tabpluginet måste visa LuckPerms-prefixet och tolka PlaceholderAPI-placeholders i det.

1. Installera PlaceholderAPI och LuckPerms-expansionen: /papi ecloud download LuckPerms, sedan /papi reload.
2. Använd %luckperms_prefix% i ditt chattformat, eller låt chattpluginet läsa prefixet via Vault.
3. För tablistan visar ItemsAdder-wikin pluginet TAB med bildplaceholdern direkt i gruppens prefix och sedan /tab reload:

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

ItemsAdders egen tagg :admin: fungerar där ItemsAdder själv ersätter text. Plugins som bara förstår PlaceholderAPI behöver %img_admin% i stället, och därför använder generatorn placeholder-formen.

Textprefix utan resource pack

Om du inte vill ha något resource pack fungerar färgade textprefix också. Generatorn skriver dem även med &#-hexfärger och fetstil:

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

Hexfärger kräver Minecraft 1.16 eller nyare och ett chattplugin som förstår &#RRGGBB. För chattplugins som läser MiniMessage kopierar du i stället MiniMessage-raderna med <gradient>. Mer om färgformat finns i guiden om MOTD-färger, hex och gradienter.

Vanliga fel och lösningar

Samma teknik med typsnittsbilder ritar också hela menybakgrunder, se egna GUI-bakgrunder i DeluxeMenus med ItemsAdder. Och om dina ranker kommer med röstförmåner visar guiden om röstbelöningar med VotingPlugin hur du delar ut dem.