LuckPerms — это плагин для управления правами, с помощью которого ты определяешь, кто и какие команды может использовать на сервере Paper или Spigot. Без такого плагина есть всего два уровня: оператор, которому доступно всё, и обычные игроки, которым не доступно почти ничего. LuckPerms добавляет между ними группы: гости, строители, модераторы. У каждой группы есть свои узлы прав, а игроки наследуют узлы своих групп.
В этом руководстве мы пройдём путь от установки до создания первой группы модераторов. Команды взяты из официальной документации LuckPerms, а скриншоты сделаны на тестовом сервере с Paper 1.21.4 и LuckPerms 5.5.71.
Установка через панель
В панели сервера LuckPerms находится в разделе Плагины → Браузер. Поиск получает данные с Modrinth; загрузчик и версия сервера сверяются с метаданными плагина, прежде чем файл попадёт в папку plugins/. Если тебе нужен весь комплект, мастер защиты мира на странице плагинов установит LuckPerms вместе с WorldGuard и WorldEdit за один шаг. После перезапуска плагин при входе на сервер сообщит свою версию и автора.
(Enlarge image)Это сообщение появляется, если ввести /luckperms или коротко /lp без аргументов. Так быстрее всего проверить, действительно ли плагин работает.
Как устроены права в LuckPerms
Узел прав — это строка вроде essentials.home или worldedit.region.set. Каждый плагин добавляет собственные узлы и описывает их в документации. Узел может иметь значение true или false. Звёздочка в worldedit.* охватывает все узлы плагина: для модераторов это удобно, а для обычных игроков опасно.
В LuckPerms есть три уровня:
- Группы объединяют узлы. В группу
defaultавтоматически попадает каждый игрок. - Игроки наследуют права своих групп и могут дополнительно иметь собственные узлы.
- Контексты ограничивают действие узлов, например определённым миром или режимом игры.
Не усложняй структуру. Для большинства серверов достаточно двух–четырёх групп.
Создание первой группы
Следующие команды выполняются в консоли сервера или в игре от имени оператора:
/lp creategroup mod
/lp group mod permission set worldedit.* true
/lp group mod permission set essentials.kick true
/lp user Spielername parent add mod
Первая строка создаёт группу. Две строки с permission set дают ей полный доступ к WorldEdit и команду кика из EssentialsX. Последняя строка добавляет игрока в группу, при этом вместо Spielername подставь его ник. Проверить результат можно командой /lp user Spielername permission check essentials.kick.
Для группы default имеет смысл пойти обратным путём и убрать команды, которые игрокам не нужны. Без права bukkit.command.plugins Paper вообще перестаёт показывать команду /plugins: игрок видит только сообщение о неизвестной команде.
(Enlarge image)/lp group default permission set bukkit.command.plugins false
В строгом смысле это не мера безопасности, но так список плагинов будет скрыт от любопытных гостей.
Веб-редактор
Для масштабных изменений консоль неудобна. Команда /lp editor создаёт ссылку на веб-редактор на сайте luckperms.net. Там все группы и игроки показаны в таблице, узлы можно настраивать мышью, а в конце одним кликом передать результаты сессии обратно на сервер. Ссылка действует несколько минут и работает только с созданным кодом. В сессиях содержатся ники игроков и UUID, поэтому никому не передавай эту ссылку.
Типичные ошибки
- Право не действует. Игрок всё ещё является оператором. Операторы обходят ограничения LuckPerms. Сними
opи работай только с группами. - Узел написан неправильно. LuckPerms принимает любой текст, в том числе с опечатками. Сверь узел с документацией соответствующего плагина.
- Звёздочка в
default. Узел*в стандартной группе даёт каждому гостю доступ ко всему. Используй звёздочки только в группах модераторов. - Изменения пропадают после перезапуска. По умолчанию LuckPerms хранит данные в файле H2 в папке плагина. Если при перезапуске запись в эту папку невозможна, изменения теряются. Ошибку можно увидеть в консоли при запуске сервера.
Хранение данных и резервные копии
Все данные находятся в папке plugins/LuckPerms/. Резервная копия в панели сохраняет и её. Для сетей из нескольких серверов LuckPerms поддерживает общую базу данных MySQL, а для одного сервера самым простым вариантом остаётся H2.
Другие руководства
О том, как устанавливать и обновлять плагины, читай в руководстве «Установка плагинов и управление ими». Защита мира с помощью регионов описана в статье WorldGuard: защита регионов, а инструменты для строительства — в статье WorldEdit: строительство и отмена изменений.
Источники
- Вики LuckPerms: https://luckperms.net/wiki/Home
- Справочник команд: https://luckperms.net/wiki/Command-Usage
- Веб-редактор: https://luckperms.net/wiki/Web-Editor