mBadges (Мбэджес)

Плагин для серверов Майнкрафт добавляет графические значки игрока с коллекциями и несколькими слотами экипировки. Игроки выбирают и меняют полученные значки через меню, а выбранные отображаются в списке игроков и, при настройке, возле ника в таблице счёта.

Возможности

• Выдаёт постоянные и временные значки игрокам, в том числе тем, кто сейчас не на сервере.
• Позволяет просматривать коллекцию, фильтровать значки, выбирать их порядок, надевать и снимать.
• Создаёт ресурс-пак со значками из PNG-файлов и сохраняет назначенные символы после перезапуска сервера.
• Работает с SQLite, MySQL и PostgreSQL.
• Поддерживает PlaceholderAPI, Java API, REST API и синхронизацию коллекций между серверами через общую базу данных.
• Сообщения плагина доступны на русском языке.

Команды

• /badge или /badge gui — открыть меню коллекции.
• /badge list — показать полученные значки.
• /badge set <id> — надеть значок.
• /badge remove <id> — снять значок.
• /badge clear — снять все значки.
• /badge info <id> — показать сведения о значке.
• /mbadge give <player|uuid> <id> [--duration 1w2d] — выдать значок, при необходимости на указанный срок.
• /mbadge take <player|uuid> <id> — забрать значок.
• /mbadge equip <player|uuid> <id> — принудительно надеть значок игроку.
• /mbadge unequip <player|uuid> <id> — снять значок с игрока.
• /mbadge clear <player|uuid> — очистить экипированные значки игрока.
• /mbadge list <player|uuid> — показать число значков в коллекции.
• /mbadge reload — перезагрузить безопасные настройки и описания значков.
• /mbadge resourcepack rebuild — пересобрать ресурс-пак.

Права

• mbadge.use — команды игрока.
• mbadge.gui — доступ к меню коллекции.
• mbadge.badge.<id> — использование конкретного значка.
• mbadge.max.<number> — увеличить число доступных слотов.
• mbadge.admin — все административные права.
• mbadge.admin.give, mbadge.admin.take — выдача и изъятие значков.
• mbadge.admin.equip, mbadge.admin.clear — управление экипировкой игроков.
• mbadge.admin.list — просмотр размера коллекций.
• mbadge.admin.reload — перезагрузка настроек.
• mbadge.admin.resourcepack — пересборка ресурс-пака.

Настройка

Значки добавляют PNG-файлами размером до 256×256 в plugins/mBadges/badges, а их параметры указывают в badges.yml: название, описание, файл текстуры, право, категорию, приоритет, видимость и срок действия.

Основные файлы плагина:

• config.yml — язык, слоты, отображение, сроки действия, синхронизация и REST API;
• badges.yml — значки, права, категории и приоритеты;
• database.yml — подключение к базе данных;
• resourcepack.yml — создание и раздача ресурс-пака;
• gui.yml — размер меню, предметы и слоты навигации;
• lang/ru_RU.yml — русские сообщения.

В обычном режиме плагин создаёт архив generated/mbadges-resource-pack.zip. Для автоматической отправки игрокам его нужно разместить по прямой HTTP(S)-ссылке и указать URL с SHA-1 в resourcepack.yml. При использовании Oraxen или ItemsAdder значки подключаются к их ресурс-паку вручную.

Для сети серверов все серверы должны использовать одну MySQL- или PostgreSQL-базу, одинаковые badges.yml и карту символов, а также включённый sync.enabled.

Требования

Плагин работает на Paper, Purpur и Folia. PlaceholderAPI, LuckPerms, Oraxen и ItemsAdder необязательны.

SQLite используется без дополнительной настройки. Отображение в списке игроков включено по умолчанию; показ возле ников в таблице счёта лучше включать с учётом других плагинов, которые управляют командами и оформлением табло. Для оформления чата используйте заполнители PlaceholderAPI: %mbadge_equipped%, %mbadge_count%, %mbadge_owned_count%, %mbadge_slots% и %mbadge_slot_1%.