LuckPerms — это плагин для управления правами, с помощью которого ты определяешь, кто и какие команды может использовать на сервере Paper или Spigot. Без такого плагина есть всего два уровня: оператор, которому доступно всё, и обычные игроки, которым не доступно почти ничего. LuckPerms добавляет между ними группы: гости, строители, модераторы. У каждой группы есть свои узлы прав, а игроки наследуют узлы своих групп.

В этом руководстве мы пройдём путь от установки до создания первой группы модераторов. Команды взяты из официальной документации LuckPerms, а скриншоты сделаны на тестовом сервере с Paper 1.21.4 и LuckPerms 5.5.71.

Установка через панель

В панели сервера LuckPerms находится в разделе Плагины → Браузер. Поиск получает данные с Modrinth; загрузчик и версия сервера сверяются с метаданными плагина, прежде чем файл попадёт в папку plugins/. Если тебе нужен весь комплект, мастер защиты мира на странице плагинов установит LuckPerms вместе с WorldGuard и WorldEdit за один шаг. После перезапуска плагин при входе на сервер сообщит свою версию и автора.

Чат после входа на сервер: LuckPerms 5.5.71 загружен, указаны сайт и автор (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: игрок видит только сообщение о неизвестной команде.

Без права bukkit.command.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: посмотреть пример

Собственные записи из демо-среды. Показанные версия и настройки могут отличаться от твоего сервера.

LuckPerms: Без права доступа проверяемая команда списка плагинов недоступна.
Без права доступа проверяемая команда списка плагинов недоступна.

LuckPerms 5.5.71 · 2026-09-12

LuckPerms: После смены прав та же команда выводит список плагинов.
После смены прав та же команда выводит список плагинов.

LuckPerms 5.5.71 · 2026-09-12