Prefiksy rang LuckPerms z obrazkami (ItemsAdder)

Jak działają prefiksy z obrazkami

Czat Minecrafta potrafi pokazać tylko tekst. Paczka zasobów może dodać do czcionki nowe znaki, a ItemsAdder zamienia dowolny PNG w taki znak, nazywany font image. Gdy paczka jest wczytana, odznaka jest po prostu kolejnym znakiem w linii.

Pracę dzielą trzy pluginy:

• ItemsAdder buduje paczkę zasobów i zamienia %img_<nazwa>% (PlaceholderAPI) albo własny tag :<nazwa>: na znak odznaki.
• LuckPerms przechowuje, która grupa nosi który prefiks, i po priorytecie decyduje, gdy gracz ma ich kilka.
• Twoje pluginy czatu i taba odczytują prefiks LuckPerms przez Vault albo placeholder PlaceholderAPI %luckperms_prefix% i go wyświetlają. Sam LuckPerms nie formatuje czatu.

Krok 1: Przygotuj obrazki odznak

Zaprojektuj rangi w Generatorze prefiksów rang. Każda odznaka ma domyślnie 8 pikseli wysokości, tak jak zaleca wiki ItemsAdder, i jest tak szeroka jak jej tekst. Ustaw rangi w kolejności: góra listy dostaje najwyższy priorytet w LuckPerms. Ustaw namespace (nazwę folderu, domyślnie ranks) i kliknij Pobierz wszystkie jako ZIP.

ZIP zawiera jeden PNG na rangę, plik ranks.yml i README ze wszystkimi komendami:

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

Krok 2: Dodaj font images do ItemsAdder (rangi ItemsAdder)

Skopiuj folder ranks do plugins/ItemsAdder/contents/. Config rejestruje każdą odznakę jako 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 pasuje do obrazka o wysokości 8 pikseli, więc jeden piksel obrazka to jeden piksel czcionki, a y_position: 7 ustawia odznakę na linii tekstu. Jeśli wybierzesz inną wysokość, generator zmieni obie wartości razem z nią. ItemsAdder wymaga, żeby y_position było mniejsze lub równe scale_ratio.
• Linia permission decyduje tylko o tym, kto może wpisać odznakę jako emoji na czacie. O tym, kto nosi ją przed nickiem, decyduje LuckPerms.
• path wskazuje PNG w folderze textures danego namespace.

Wpisz /iazip w konsoli i poczekaj, aż paczka zasobów się przebuduje. Gracze zobaczą odznaki dopiero po wczytaniu nowej paczki.

Krok 3: Ustaw prefiks w LuckPerms

Utwórz grupy, jeśli jeszcze nie istnieją, a potem ustaw prefiks każdej grupy. Generator wypisuje te linie od razu dla wszystkich rang:

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

• Liczba to priorytet. Jeśli gracz należy do kilku grup, LuckPerms pokazuje prefiks z najwyższym priorytetem. Generator daje najwyższej randze największą liczbę, w krokach co dziesięć.
• setprefix zastępuje istniejące prefiksy tej grupy w tym samym kontekście. addprefix dodałby kolejny obok nich.
• Cudzysłów jest potrzebny, bo prefiks kończy się spacją, która oddziela odznakę od nicku.
• Prefiks usuniesz przez lp group vip meta removeprefix 10.

Chcesz kilka odznak obok siebie, na przykład odznakę rangi i odznakę wspierającego? LuckPerms potrafi układać prefiksy w stos dzięki sekcji meta-formatting w swoim config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Krok 4: Pokaż odznakę na czacie i w tabie

Prefiks zawiera teraz %img_admin%. Coś musi zamienić ten placeholder na odznakę. Plugin czatu albo taba musi pokazywać prefiks LuckPerms i przetwarzać w nim placeholdery PlaceholderAPI.

1. Zainstaluj PlaceholderAPI i rozszerzenie LuckPerms: /papi ecloud download LuckPerms, potem /papi reload.
2. Użyj %luckperms_prefix% w formacie czatu albo pozwól pluginowi czatu odczytać prefiks przez Vault.
3. Dla listy graczy (taba) wiki ItemsAdder pokazuje plugin TAB z placeholderem obrazka bezpośrednio w prefiksie grupy, a potem /tab reload:

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

Własny tag ItemsAdder :admin: działa tam, gdzie ItemsAdder sam podmienia tekst. Pluginy, które rozumieją tylko PlaceholderAPI, potrzebują zamiast tego %img_admin%, dlatego generator używa formy z placeholderem.

Prefiksy tekstowe bez paczki zasobów

Jeśli nie chcesz paczki zasobów, kolorowe prefiksy tekstowe też działają. Generator wypisuje je również z kolorami hex &# i pogrubieniem:

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

Kolory hex wymagają Minecrafta 1.16 lub nowszego i pluginu czatu, który rozumie &#RRGGBB. Dla pluginów czatu, które czytają MiniMessage, skopiuj zamiast tego linie MiniMessage z <gradient>. Więcej o formatach kolorów znajdziesz w poradniku o kolorach MOTD, hex i gradientach.

Typowe błędy i rozwiązania

Ta sama technika font images rysuje też całe tła menu, zobacz własne tło GUI w DeluxeMenus z ItemsAdder. A jeśli twoje rangi dają bonusy za głosowanie, poradnik o nagrodach za głosy z VotingPlugin pokazuje, jak je rozdawać.