Плагин для серверов Майнкрафт с системой титулов и суффиксов: игроки получают несколько вариантов оформления имени, выбирают активные через GUI или команды, а администратор управляет ими вручную, через магазин и автоматические правила. Титул и суффикс выводятся в чате, Tab и над головой, поддерживаются RGB-градиенты, китайский и английский языки интерфейса.
Возможности
- У каждого игрока может быть несколько титулов и суффиксов с отдельными ID; их можно включать и отключать независимо.
- GUI открывает список собственных титулов, суффиксов и магазин. Администраторский GUI позволяет искать в том числе офлайн-игроков по имени или UUID, выдавать, переименовывать, активировать и удалять их награды.
- Магазин работает на внутренней валюте либо экономике Vault. В нём есть ежедневная награда за вход и три состояния товара: продаётся, только показывается с пояснением или скрыт.
- Автоматические титулы выдаются и отзываются по условиям: уровню, здоровью, времени игры, убийствам, балансу, правам и другим встроенным переменным. Правила поддерживают числовые сравнения, диапазоны, условия «и»/«или»/«не», скобки, строки и регулярные выражения.
- Доступны переменные PlaceholderAPI, включая
%catcraft_title%,%catcraft_suffix%,%catcraft_balance%,%catcraft_currency%, количество титулов и активные ID. - Формат чата задаётся через
{title},{name},{suffix},{message}. Цвета можно писать в формате&#RRGGBB, а палитру градиента — вsettings.gradient-colors. - Данные хранятся в SQLite, MySQL или PostgreSQL. MySQL и PostgreSQL подходят для общей базы нескольких серверов; при ошибке подключения используется SQLite.
Команды
Игрокам доступны:
/catcraft gui— открыть управление титулами;/catcraft shop— открыть магазин;/catcraft list— показать свои титулы и суффиксы;/catcraft active <ID>и/catcraft deactive— включить или отключить титул;/catcraft suffixactive <ID>и/catcraft suffixdeactive— включить или отключить суффикс;/catcraft remove <ID>— удалить свой неактивный титул, выданный не автоматически.
Администраторские команды:
/titleadmin panel— открыть панель управления;/titleadmin reload— перечитать конфиг, сообщения, формат чата и правила;/titleadmin autotest [игрок]— проверить разбор каждого автоматического правила;/titleadmin give <игрок> <ID> <отображаемое_имя>,/titleadmin edit <игрок> <ID> <отображаемое_имя>,/titleadmin take <игрок> <ID>— выдать, изменить или забрать титул;/titleadmin suffixgive,/titleadmin suffixedit,/titleadmin suffixtake,/titleadmin suffixlist,/titleadmin suffixsetactive,/titleadmin suffixdeactive— те же операции для суффиксов;/titleadmin shop add <ID> <тип> <цена> <отображаемое_имя>,/titleadmin shop remove <ID> <тип>,/titleadmin shop setprice <ID> <тип> <цена>— управление товарами;/titleadmin shop givebalance <игрок> <сумма>и/titleadmin shop setbalance <игрок> <сумма>— изменить баланс;/titleadmin shop toggle,/titleadmin shop currency <internal|vault>— включить магазин и выбрать валюту;/titleadmin shop state <ID> <тип> <sellable|display|hidden>и/titleadmin shop note <ID> <тип> <текст|clear>— задать состояние и примечание товара.
В командах магазина тип 0 означает титул, 1 — суффикс.
Права
catcraft.admin— панель и команды администратора;catcraft.use— команды игрока и GUI;catcraft.shop— магазин и ежедневная награда.
Названия прав можно изменить в разделе permissions файла config.yml.
Настройка
В config.yml выбираются язык language: zh|en, база данных, валюта магазина, стартовый баланс, награда за вход, титул по умолчанию, RGB-градиент и формат чата. Текст сообщений редактируется в messages_zh.yml и messages_en.yml.
Для автоматических правил используется раздел auto-rules. Встроенные переменные записываются в фигурных скобках, например {level}, {health}, {playtime_minutes}, {kills}, {balance}, {perm:group.vip} и {has_title:1}; переменные PlaceholderAPI — в процентах, например %player_level%. Команда /titleadmin autotest <игрок> помогает увидеть значения переменных и результат каждого условия.
Требования
Плагин работает на Paper, Purpur, Spigot и Folia. Для запуска требуется Java 8 или выше.
PlaceholderAPI нужен для правил и переменных, использующих его плейсхолдеры; правила со встроенными переменными работают без него. Vault вместе с плагином экономики требуется при shop.currency: vault. Для синхронизации между серверами настройте MySQL или PostgreSQL; без внешней базы используется SQLite.
Если другой плагин уже управляет командами scoreboard или рангами игрока, отображение в Tab и над головой сохраняет его оформление. На Folia, где недоступны команды scoreboard, титул показывается как префикс имени в Tab.
