CustomPerm (Кастомперм)

Мод для Майнкрафт на NeoForge, который позволяет выдавать игрокам отдельные ванильные и добавленные модами команды без прав оператора. Подходит для серверов, одиночных миров и игры по локальной сети: можно создать ранги, настроить доступ к командам, псевдонимы и ограничения их использования.

Возможности

• Открывает доступ к выбранным корневым командам и выдаёт его через узлы прав вида customperm.command.<имя>.
• Работает с LuckPerms либо со встроенной системой рангов: поддерживаются наследование, приоритеты, запреты, шаблоны прав, временные права и права для конкретного мира или режима игры.
• Позволяет запретить команды даже операторам; параметр gateAllCommands включает проверку для всех команд.
• Создаёт лестницы рангов с повышением и понижением через customperm track promote|demote.
• Добавляет псевдонимы и макросы команд, например /fly, /heal или /starter; им можно передавать аргументы player, integer, word и text.
• Ограничивает частоту использования команд и псевдонимов, например 10/1h или unlimited.
• Настраивает префиксы, суффиксы и никнеймы игроков. Право на самостоятельную смену ника — customperm.nick.
• Ведёт журнал действий администраторов и при необходимости сохраняет введённые игроками команды.
• Импортирует и экспортирует группы и игроков LuckPerms, а также позволяет редактировать их из игрового интерфейса.
• В режиме кластера несколько серверов могут использовать общие ранги, команды, псевдонимы, лимиты и журнал через MariaDB или MySQL.

Как пользоваться

Чтобы разрешить команду через встроенные ранги, сначала откройте её, создайте ранг, выдайте ему право и назначьте игроку:

customperm command add gamemode
customperm grade create vip
customperm grade addperm vip customperm.command.gamemode
customperm grade assign Steve vip

С LuckPerms можно создать псевдоним и выдать доступ к нему группе:

customperm alias add spec gamemode spectator
lp group vip permission set customperm.alias.spec true
lp user Steve parent add vip

Административное меню открывается командой /customperm gui. В нём доступны управление командами, рангами, игроками, псевдонимами, лимитами, журналом и переносом данных. Для доступа требуются уровень оператора 2 и право customperm.admin; отдельные разделы можно делегировать правами наподобие customperm.manage.grades.

Для проверки состояния и поиска проблем используйте /customperm status, /customperm scan, /customperm debug и /customperm test.

В одиночном мире должны быть включены читы. Настройки хранятся в .minecraft/config/arcadia/customperm/ и общие для всех одиночных миров этой установки; при открытии мира по локальной сети гостям можно выдавать команды через ранги.

Настройки

Команды, которые не были добавлены через customperm command add <имя>, сохраняют исходные требования. В конфигурации поддерживается безопасная горячая перезагрузка: при ошибке в JSON остаётся прежняя рабочая конфигурация.

Требования и совместимость

Нужны NeoForge и Java. LuckPerms необязателен: без него используется встроенная система рангов.

Для игрового меню мод должен быть установлен у администратора на клиенте; остальным игрокам он не требуется. Для режима кластера нужен мод с драйвером MariaDB или MySQL, например Arcadia Lib, причём он устанавливается и на серверы, и на клиенты игроков.