LuckPerms префикси за рангове със значки-картинки (ItemsAdder)

Как работят префиксите с картинки

Чатът в Minecraft може да показва само текст. Resource pack може да добави нови символи към шрифт, а ItemsAdder превръща всеки PNG в такъв символ, наречен font image. Щом pack-ът е зареден, значката е просто още един символ в реда.

Три плъгина си делят работата:

• ItemsAdder изгражда resource pack-а и заменя %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 в конзолата и изчакай resource pack-ът да се изгради отново. Играчите виждат значките едва след като заредят новия pack.

Стъпка 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%, затова генераторът използва формата с плейсхолдър.

Текстови префикси без resource pack

Ако не искаш resource pack, цветните текстови префикси също работят. Генераторът ги пише и с hex цветове &# и удебеляване:

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

Hex цветовете изискват Minecraft 1.16 или по-нов и плъгин за чат, който разбира &#RRGGBB. За плъгини за чат, които четат MiniMessage, копирай вместо това MiniMessage редовете с <gradient>. Повече за цветовите формати има в ръководството за цветове в MOTD, hex и градиенти.

Чести грешки и решения

Същата техника с font images рисува и цели фонове на менюта, виж собствени GUI фонове в DeluxeMenus с ItemsAdder. А ако ранговете ти идват с бонуси за гласуване, ръководството за награди за гласуване с VotingPlugin показва как да ги раздаваш.