Плагін Minecraft DeluxeTags

🔌 Про DeluxeTags

DeluxeTags — це плагін Minecraft Spigot, який надає додаткові теги, що базуються на дозволах (prefixes), і які гравці можуть розблоковувати та перемикати між ними через внутрішньоігровий GUI або команди. Теги розглядаються як "додатковий префікс" і можуть відображатися в чаті, tab та інших інтеграціях чату через placeholder-и.

🎯 Призначення

DeluxeTags вирішує проблему надання гравцям необов’язкових косметичних тегів, які можна розблокувати окремо від префіксів рангу/групи. Це корисно для серверів, які хочуть мати теги, що можна придбати, розблокувати або отримати як нагороду, і які гравець може вмикати або вимикати без зміни основної групи чи рангу.

⚙️ Можливості

• Теги на основі дозволів: надавайте доступ за допомогою deluxetags.tag.<identifier> (приклад у конфігу: deluxetags.tag.example).
• GUI для гравців, щоб переглядати та вибирати доступні теги.
• Команди для перегляду списку, вибору та керування тегами (команди для гравців і адміністраторів задокументовані проєктом).
• Підтримка PlaceholderAPI та placeholder-ів для вставки активного тега, identifier, опису та кількості в форматах чату.
• Налаштовувані елементи GUI, назви та параметри пагінації, як показано у фрагменті конфігурації плагіна.
• Опції для завантаження тега гравця під час входу, інтеграції форматування чату та перевірки оновлень.

🧩 Для кого це

• Сервери Survival / SMP, які хочуть косметичні, розблоковувані теги для чату, окремі від prefix-ів рангу.
• Сервери, що використовують плагіни дозволів для видачі косметичних нагород (наприклад, через LuckPerms).
• Адміністратори, яким потрібен простий GUI-інтерфейс для вибору тегів гравцями.

🏗️ Приклади використання

• Надати гравцю дозвіл на VIP-тег як косметичну покупку та дозволити йому вмикати його через GUI тегів.
• Нагорода за подію надає дозвіл на певний тег, щоб переможці могли вибрати новий тег зі своїх доступних тегів.
• Адміністратори створюють власні теги через команди та визначають, які гравці можуть їх використовувати, через дозволи.

⌨️ Команди

Примітка: документація проєкту підтверджує ці команди; конкретні вузли дозволів для команд (крім шаблону вузла для кожного тега) у основному джерелі не вказані.

🔐 Permissions

Плагін використовує вузли дозволів для кожного тега окремо; інші вузли, пов’язані з командами, явно не задокументовані в основних доступних файлах проєкту.

⚙️ Встановлення

📥 Налаштування

• Завантажте JAR плагіна зі Spigot-ресурсу проєкту або з офіційних build artifacts.
• Помістіть JAR у теку plugins/ на вашому сервері.
• Запустіть або перезапустіть сервер і перевірте console, щоб переконатися, що плагін завантажився.

📦 Залежності

• PlaceholderAPI — підтримується (плагін містить placeholder-и та опцію papi_chat), вказано в конфігурації та прикладах placeholder-ів.

🧾 Конфігурація

• DeluxeTags використовує YAML-конфігурацію, що визначає теги, налаштування GUI та повідомлення. Конфігурація містить приклади для записів тегів, налаштувань елементів GUI, placeholder-ів та опцій формату чату. Типові ключі в конфігу: deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join.

🧠 Технічні примітки

• Вихідний код проєкту доступний у публічному репозиторії GitHub.
• Проєкт Spigot перелічує протестовані версії Minecraft від 1.8 до 1.21 і включає окремий запис для 1.20.6 у списку протестованих версій.
• Dev-білди та CI artifacts надаються CI-сервером проєкту.
• У репозиторії не показано опублікованих релізів на хості з вихідним кодом; CI artifacts доступні окремо.

🤝 Коли цей плагін корисний

Якщо ви хочете, щоб гравці мали необов’язкові косметичні теги на основі дозволів, які можна вмикати через GUI або команди без зміни груп рангу, DeluxeTags пропонує просте, налаштовуване рішення з інтеграцією PlaceholderAPI для відображення в чаті.