DeluxeTags

DeluxeTags предоставляет игрокам возможность использовать дополнительные теги в чате, списке игроков и других интерфейсах. Доступ к конкретным тегам регулируется узлами прав доступа, а игроки могут переключаться между доступными им тегами через GUI.

Основная концепция: дополнительные метки вместо групп

DeluxeTags меняет подход к отображению статусов игроков, предоставляя возможность использовать дополнительные текстовые метки (теги) в чате, при выборе имени в списке игроков (Tab) и в других элементах интерфейса. В отличие от стандартных префиксов, жестко привязанных к группам, этот плагин реализует систему узлов прав доступа. Игрок может получить доступ к тегу, не входя в конкретную группу, достаточно предоставить ему соответствующий узел прав. Игрок может иметь доступ к нескольким тегам одновременно и переключаться между ними, что позволяет гибко управлять отображением информации о статусе игрока без необходимости перезагружать сервер или менять группы.

Графический интерфейс и переключение

Для удобства управления игрокам доступен графический интерфейс (GUI). Через меню игрок может просматривать доступные ему теги, видеть их описания и переключать активный тег на лету. Интерфейс включает в себя слоты для выбора тегов, разделители, элементы навигации по страницам (предыдущая/следующая страница) и специальные предметы для выхода из меню или сброса текущего тега.

Управление через консоль и команды

Администраторы могут управлять тегами напрямую с помощью консольных команд. Доступны операции по созданию новых тегов, их удалению, изменению порядка отображения и описания. Также предусмотрены команды для назначения и сброса тегов у конкретных игроков, а также проверки списка доступных тегов для пользователя или всего сервера. Основные команды включают /Tags Create для создания, /Tags Delete для удаления, /Tags Set для назначения и /Tags Clear для сброса. Игроки также могут использовать команды для просмотра доступных им тегов и переключения текущего активного тега. Все команды имеют систему прав доступа для разграничения возможностей между обычными игроками и администраторами.

Интеграция с плагинами чата

DeluxeTags разработан для совместимости с популярными плагинами обработки чата, такими как DeluxeChat. Плагин поддерживает использование плейсхолдеров для динамической подстановки данных. В конфигурации можно настроить отображение идентификатора активного тега, самого текста тега, его описания и количества доступных тегов у игрока. Поддерживаются форматы как для DeluxeChat, так и для EssentialsChat. Плейсхолдеры %deluxetags_identifier%, %deluxetags_tag%, %deluxetags_description% и %deluxetags_amount% позволяют интегрировать данные о тегах в любые шаблоны сообщений чата, обеспечивая единообразие отображения статусов.

Настройка конфигурации

Основная конфигурация позволяет определить структуру тегов, их внешний вид и поведение. Для каждого тега задаётся текст (с поддержкой цветового кода), описание (используемое в GUI и сообщениях) и узел прав доступа. Плагин также поддерживает настройку элементов интерфейса GUI, включая материалы предметов для выбора и переключения, а также логику отображения разделителей и кнопок навигации по страницам. В конфигурации можно включить или выключить отображение количества тегов в названии меню, настроить отображение тега, у которого нет доступа (tag_visible_item), а также определить предмет для выхода из меню.

Система сообщений и обратная связь

Плагин генерирует информативные сообщения для обратной связи при выполнении команд. Сообщения сообщают об успешном создании или удалении тегов, о назначении тегов игрокам, об ошибках при использовании некорректных команд или отсутствии прав доступа. Сообщения также адаптируются под игрока, которому адресована команда, если он находится онлайн. Например, при попытке установить тег игроку, который не имеет доступа к нему, система выдаст соответствующее уведомление. Также предусмотрены сообщения для случаев, когда у игрока нет доступных тегов или когда он пытается выполнить команду без необходимых прав.

Разработка и поддержка

Разработчиком плагина выступает команда HelpChat. Для получения помощи, обсуждения функционала и поддержки проекта доступен официальный Discord-сервер. Также доступны сборочные версии (development builds) для тестирования новых функций. Плагин распространяется под лицензией MIT, что позволяет свободно использовать и модифицировать его код. Для получения дополнительной информации о командах и узлах прав рекомендуется обращаться к документации на официальном сайте разработчика.