ApoTags (Апо тэгс)

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

Возможности

• Поддерживает цвета &#RRGGBB, обычные цветовые коды & и форматирование текста.
• Показывает теги в постраничном меню инвентаря: выбранный тег можно сбросить, а недоступные отметить отдельным предметом.
• Позволяет включать и скрывать отдельные теги, менять их порядок, видимый текст и многострочное описание.
• Хранит данные во встроенной базе H2 либо в YAML-файле.
• Через PlaceholderAPI выводит активный тег в чате, списке игроков и табло: %apotags_tag%, %apotags_tag_plain%, %apotags_tag_id%.

Команды

• /tags — открыть меню выбора тега.
• /tags list — посмотреть доступные и активный теги.
• /tags select <id> — выбрать тег.
• /tags admin — открыть меню управления для администратора.
• /tags list all и /tags list <player> — посмотреть все теги или теги игрока.
• /tags set <player> <id> и /tags clear <player> — назначить или снять тег игрока.
• /tags create <id> <tag>, /tags delete <id>, /tags enable <id>, /tags disable <id> — создать, удалить, включить или скрыть тег.
• /tags setorder <id> <n>, /tags setdisplay <id> <tag>, /tags setdesc <id> <desc> — изменить порядок, надпись и описание. Для нескольких строк описания используйте \|.
• /tags reload — перечитать конфиги без перезапуска.

Основная команда также доступна как /apotags и /tag.

Права

• apotags.use — все команды игрока.
• apotags.admin — команды администратора.
• apotags.reload — /tags reload.
• apotags.tag.all — доступ ко всем тегам.
• apotags.command.<название> — право на отдельную команду, например apotags.command.select.
• apotags.tag.<TagID> — доступ к конкретному тегу; идентификатор должен точно совпадать с ключом в tags.yml, включая регистр.

Тег с permission: none доступен всем игрокам.

Настройка

Основные параметры находятся в config.yml: locale, storage, название и размер меню, предметы и слоты кнопок. Оформление обычного и административного меню задаётся в gui/gui_user.yml и gui/gui_admin.yml.

Сами теги перечислены в tags.yml. Для каждого указываются order, tag, lore, permission и enabled. Текст интерфейса вынесен в языковые файлы: встроены английский и испанский языки; другой перевод можно добавить копированием файла из plugins/ApoTags/lang/ и выбором его кода в locale.

Требования

Работает на сервере Paper и требует Java 17. PlaceholderAPI нужен для вывода тегов в чат, список игроков, табло и другие совместимые плагины.