Префікси рангів LuckPerms зі значками-зображеннями (ItemsAdder)

Як працюють префікси-зображення

Чат Minecraft може показувати лише текст. Ресурспак може додати до шрифту нові символи, а ItemsAdder перетворює будь-який PNG на такий символ, що називається font image. Щойно пак завантажено, значок – це просто ще один символ у рядку.

Роботу ділять три плагіни:

• ItemsAdder збирає ресурспак і замінює %img_<name>% (PlaceholderAPI) або власний тег :<name>: на символ значка.
• LuckPerms зберігає, яка група носить який префікс, і вирішує за пріоритетом, коли в гравця їх кілька.
• Твої плагіни чату й табу читають префікс LuckPerms через Vault або плейсхолдер PlaceholderAPI %luckperms_prefix% і показують його. Сам LuckPerms чат не форматує.

Крок 1: Створи зображення значків

Спроєктуй свої ранги в генераторі префіксів рангів. Кожен значок типово має висоту 8 пікселів, як вимагає вікі ItemsAdder, і ширину за довжиною тексту. Розстав ранги по порядку: верх списку отримує найвищий пріоритет у LuckPerms. Задай namespace (назву папки, типово ranks) і натисни Завантажити всі як ZIP.

ZIP містить по одному PNG на ранг, ranks.yml і README з усіма командами:

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

Крок 2: Додай font images в ItemsAdder

Скопіюй папку ranks у plugins/ItemsAdder/contents/. Конфіг реєструє кожен значок як 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 відповідає картинці висотою 8 пікселів, тож один піксель картинки – це один піксель шрифту, а y_position: 7 ставить значок на рядок тексту. Якщо вибрати іншу висоту, генератор змінює обидва значення разом з нею. ItemsAdder вимагає, щоб y_position був меншим або рівним scale_ratio.
• Рядок permission вирішує лише те, хто може вводити значок у чат як емодзі. Хто носить його перед ніком, вирішує LuckPerms.
• path вказує на PNG у папці textures цього namespace.

Виконай /iazip у консолі й зачекай, доки ресурспак перезбереться. Гравці побачать значки лише тоді, коли завантажать новий пак.

Крок 3: Задай префікс через LuckPerms

Створи групи, якщо їх ще немає, а потім задай префікс кожної групи. Генератор пише ці рядки одразу для всіх рангів:

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

• Число – це пріоритет. Якщо гравець у кількох групах, LuckPerms показує префікс із найвищим пріоритетом. Генератор дає найвищому рангу найбільше число з кроком десять.
• setprefix замінює наявні префікси цієї групи в тому самому контексті. addprefix додав би ще один поруч.
• Лапки потрібні, бо префікс закінчується пробілом, який відділяє значок від ніка.
• Видалити префікс можна командою lp group vip meta removeprefix 10.

Хочеш кілька значків поспіль, наприклад значок рангу й значок донатера? LuckPerms уміє складати префікси через розділ meta-formatting у своєму config.yml (format, duplicates, start-spacer, middle-spacer, end-spacer).

Крок 4: Покажи значок у чаті й табі

Тепер префікс містить %img_admin%. Щось має замінити цей плейсхолдер на значок. Плагін чату чи табу має показувати префікс LuckPerms і обробляти плейсхолдери PlaceholderAPI всередині нього.

1. Встанови PlaceholderAPI і розширення LuckPerms: /papi ecloud download LuckPerms, потім /papi reload.
2. Використай %luckperms_prefix% у форматі чату або дай плагіну чату читати префікс через Vault.
3. Для таб-списку вікі ItemsAdder показує плагін TAB з плейсхолдером зображення прямо в префіксі групи, а потім /tab reload:

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

Власний тег ItemsAdder :admin: працює там, де ItemsAdder сам замінює текст. Плагінам, які розуміють лише PlaceholderAPI, потрібен %img_admin%, тому генератор використовує форму плейсхолдера.

Текстові префікси без ресурспаку

Якщо ресурспак тобі не потрібен, кольорові текстові префікси теж працюють. Генератор пише й такі – з hex-кольорами &# і жирним шрифтом:

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

Hex-кольорам потрібен Minecraft 1.16 або новіший і плагін чату, що розуміє &#RRGGBB. Для плагінів чату, які читають MiniMessage, скопіюй натомість рядки MiniMessage з <gradient>. Більше про формати кольорів – у посібнику кольори MOTD, hex і градієнти.

Типові помилки та рішення

Та сама техніка font image малює й цілі фони меню, дивись власний фон GUI у DeluxeMenus з ItemsAdder. А якщо твої ранги дають бонуси за голоси, посібник нагороди за голоси з VotingPlugin показує, як їх видавати.