Плагин для серверов Майнкрафт, который управляет рангами и привилегиями игроков. Игрок может владеть несколькими рангами одновременно: права всех рангов складываются, а для чата и списка игроков он сам выбирает один отображаемый ранг. Подходит для серверов с донатом, ролями строителей и администрации, а также прогрессией.
Возможности
- Меню рангов с постраничным списком: активный ранг подсвечивается, доступные ранги можно выбрать, недоступные отмечаются отдельно.
- Префикс и суффикс активного ранга выводятся в чате и списке игроков.
- Временные ранги автоматически заканчиваются; оставшееся время показывается в меню.
- Ранги задают вес, отображаемое имя, префикс, суффикс, значок меню,
custom_model_dataи список прав. - Поддерживаются цвета, градиенты и форматирование MiniMessage.
- Данные хранятся в SQLite или MySQL; для сетей серверов можно использовать общую MySQL-базу.
- Есть интеграция с LuckPerms: группы можно синхронизировать, сохранив иерархию и права LuckPerms.
- Для PlaceholderAPI доступны плейсхолдеры:
%ultimateranks_prefix%,%ultimateranks_suffix%,%ultimateranks_rank_displayname%,%ultimateranks_rank_id%,%ultimateranks_rank_weight%,%ultimateranks_total_ranks%.
Команды
/rank menu— открыть меню и выбрать отображаемый ранг./rank set <player> <rank>— назначить основной ранг./rank grant <player> <rank> [time]— выдать дополнительный ранг, в том числе временный./rank remove <player> <rank>— снять указанный ранг./rank reload— перечитать конфигурацию.
Для срока временного ранга используются значения вроде 30d, 1w, 1mo, 1y или permanent.
Права
ultimateranks.use— базовый доступ.ultimateranks.menu— доступ к меню рангов.ultimateranks.admin.set— команда/rank set.ultimateranks.admin.grant— команда/rank grant.ultimateranks.admin.remove— команда/rank remove.ultimateranks.admin.reload— команда/rank reload.ultimateranks.chat.color— цветное сообщение в чате.ultimateranks.bypass.expiration— ранг не заканчивается.ultimateranks.notify.expiration— предупреждения об окончании ранга.ultimateranks.*— все права плагина.
Настройка
Основные параметры находятся в plugins/UltimateRanks/config.yml: выбор базы в database.type, оформление и размер страниц меню в gui, формат чата в chat, автоматическое удаление и предупреждения о временных рангах в expiration, а также режим прав в permissions.mode.
Ранги создаются в plugins/UltimateRanks/ranks.yml. Для каждого указываются идентификатор, weight, display_name, prefix, suffix, gui_icon, custom_model_data и permissions. После изменения файлов используйте /rank reload.
Требования
Плагин работает на серверах Paper, а также Purpur и Pufferfish, и требует Java 21. LuckPerms нужен для синхронизации с его группами и расширенного управления правами; PlaceholderAPI нужен для вывода данных ранга в совместимых плагинах чата, таб-листа и скорборда.
