Prefixy ranků v LuckPerms s obrázkovými odznaky (ItemsAdder)

Jak obrázkové prefixy fungují

Chat v Minecraftu umí zobrazit jen text. Resource pack může do fontu přidat nové znaky a ItemsAdder z jakéhokoli PNG udělá takový znak, kterému se říká font image (obrázek ve fontu). Jakmile je pack načtený, odznak je prostě další znak v řádku.

O práci se dělí tři pluginy:

• ItemsAdder sestaví resource pack a nahradí %img_<name>% (PlaceholderAPI) nebo svůj vlastní tag :<name>: znakem odznaku.
• LuckPerms ukládá, která skupina nosí který prefix, a když má hráč víc prefixů, rozhoduje podle priority.
• Tvoje pluginy pro chat a tab čtou prefix z LuckPerms přes Vault nebo placeholder PlaceholderAPI %luckperms_prefix% a zobrazují ho. Samotný LuckPerms chat neformátuje.

Krok 1: Vytvoř obrázky odznaků

Navrhni své ranky v generátoru prefixů ranků. Každý odznak je ve výchozím stavu vysoký 8 pixelů, jak žádá wiki ItemsAdderu, a široký podle svého textu. Seřaď ranky: vrchol seznamu dostane nejvyšší prioritu v LuckPerms. Nastav namespace (název složky, ve výchozím stavu ranks) a stiskni Stáhnout vše jako ZIP.

ZIP obsahuje jedno PNG na rank, ranks.yml a README se všemi příkazy:

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

Krok 2: Přidej obrázky ve fontu do ItemsAdderu

Zkopíruj složku ranks do plugins/ItemsAdder/contents/. Config zaregistruje každý odznak jako obrázek ve fontu:

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 odpovídá obrázku vysokému 8 pixelů, takže jeden pixel obrázku je jeden pixel fontu, a y_position: 7 posadí odznak na řádek textu. Když vybereš jinou výšku, generátor změní obě hodnoty s ní. ItemsAdder vyžaduje, aby y_position byla menší nebo rovna scale_ratio.
• Řádek permission rozhoduje jen o tom, kdo smí odznak napsat jako emoji v chatu. Kdo ho nosí před jménem, rozhoduje LuckPerms.
• path ukazuje na PNG ve složce textures daného namespace.

Spusť v konzoli /iazip a počkej, až se resource pack přestaví. Hráči uvidí odznaky, až když si načtou nový pack.

Krok 3: Nastav prefix v LuckPerms

Vytvoř skupiny, pokud ještě neexistují, a pak nastav prefix každé skupiny. Generátor tyto řádky napíše pro všechny ranky najednou:

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

• Číslo je priorita. Když je hráč ve více skupinách, LuckPerms ukáže prefix s nejvyšší prioritou. Generátor dá nejvyššímu ranku nejvyšší číslo, po krocích deset.
• setprefix nahradí existující prefixy dané skupiny ve stejném kontextu. addprefix by přidal další vedle nich.
• Uvozovky jsou potřeba, protože prefix končí mezerou, která oddělí odznak od jména.
• Prefix odstraníš přes lp group vip meta removeprefix 10.

Chceš víc odznaků vedle sebe, třeba odznak ranku a odznak donátora? LuckPerms umí prefixy skládat pomocí sekce meta-formatting ve svém config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Krok 4: Zobraz odznak v chatu a tabu

Prefix teď obsahuje %img_admin%. Něco musí tento placeholder nahradit odznakem. Plugin pro chat nebo tab musí zobrazovat prefix z LuckPerms a zpracovávat v něm placeholdery PlaceholderAPI.

1. Nainstaluj PlaceholderAPI a expanzi LuckPerms: /papi ecloud download LuckPerms, pak /papi reload.
2. Použij %luckperms_prefix% ve formátu chatu, nebo nech chat plugin číst prefix přes Vault.
3. Pro tab list ukazuje wiki ItemsAdderu plugin TAB s obrázkovým placeholderem přímo v prefixu skupiny a pak /tab reload:

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

Vlastní tag ItemsAdderu :admin: funguje tam, kde ItemsAdder nahrazuje text sám. Pluginy, které rozumějí jen PlaceholderAPI, potřebují místo toho %img_admin%, a proto generátor používá formu s placeholderem.

Textové prefixy bez resource packu

Pokud resource pack nechceš, fungují i barevné textové prefixy. Generátor je píše také s hex barvami &# a tučným písmem:

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

Hex barvy potřebují Minecraft 1.16 nebo novější a chat plugin, který rozumí &#RRGGBB. Pro chat pluginy, které čtou MiniMessage, zkopíruj místo toho řádky MiniMessage s <gradient>. Víc o barevných formátech najdeš v návodu k barvám MOTD, hex a přechodům.

Časté chyby a jejich řešení

Stejná technika s obrázky ve fontu kreslí i celá pozadí menu, viz vlastní pozadí GUI v DeluxeMenus s ItemsAdderem. A pokud k rankům patří výhody za hlasování, návod na odměny za hlasování s VotingPluginem ukazuje, jak je rozdávat.