LuckPerms — это плагин прав, с которым ты на Paper- или Spigot-сервере задаешь, кто какие команды может использовать. Без плагина прав есть только два уровня: оператор со всем доступом и обычные игроки почти без прав. LuckPerms добавляет между ними группы: гости, строители, модерация. Каждая группа несет узлы прав, а игроки наследуют узлы своих групп.
Этот гайд показывает путь от установки до первой группы модерации. Команды взяты из официальной документации LuckPerms; скриншоты — с тестового сервера на Paper 1.21.4 и LuckPerms 5.5.71.
Установка через панель
В панели сервера ты найдешь LuckPerms в разделе Plugins → Browser. Поиск берет данные из Modrinth; загрузчик и версия сервера сверяются с метаданными плагина до того, как файл попадет в папку plugins/. Ассистент защиты мира на странице плагина устанавливает LuckPerms вместе с WorldGuard и WorldEdit за один шаг, если тебе нужен этот пакет. После перезапуска плагин при входе сообщает версию и автора.
Этот вывод появляется, если ты вводишь /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. Последняя строка добавляет игрока в группу. Проверить результат можно командой /lp user Spielername permission check essentials.kick.
Для группы default полезен обратный подход: убрать команды, которые игрокам не нужны. Paper без права bukkit.command.plugins больше вообще не показывает команду /plugins; игрок видит только сообщение об неизвестной команде.
/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 остается самым простым выбором.
FAQ
Почему отозванное право у меня самого не действует?
Потому что ты оператор. Операторы полностью обходят LuckPerms — любая проверка для них проходит положительно. Сними с себя op и для себя тоже работай через группу модерации, иначе ты не тестируешь собственные правила в реальных условиях.
Нужна ли мне MySQL-база данных для LuckPerms?
Для одного сервера — нет. LuckPerms по умолчанию сохраняет данные в H2-файл в plugins/LuckPerms/, который панель включает в бэкап. MySQL имеет смысл только тогда, когда несколько серверов одной сети должны делить одни и те же группы и права.
Сколько групп имеет смысл создать?
Двух-четырех хватает почти для всех серверов: default для всех, группа строителей и группа модерации. Глубокие цепочки наследования усложняют понимание, откуда пришло право — держи структуру плоской и выдавай узлы со звездочкой только группам модерации.
Как проверить, есть ли у игрока определенное право?
Через /lp user Spielername permission check knoten — ответ показывает результат и источник, то есть было ли право унаследовано из группы или задано напрямую. /lp user Spielername info показывает все группы игрока одним взглядом.
Безопасна ли ссылка веб-редактора?
Она действует всего несколько минут и не используется без созданного кода. Однако сессия содержит имена игроков и UUID твоего сервера — поэтому не передавай ссылку дальше и лучше создай новую, если сомневаешься.
Дополнительные гайды
Как в целом устанавливать и обновлять плагины, описано в Установка и управление плагинами. Защиту мира с регионами объясняет WorldGuard: защита регионов, а строительные инструменты — WorldEdit: строительство и откат действий.
Источники
- Вики LuckPerms: https://luckperms.net/wiki/Home
- Справочник команд: https://luckperms.net/wiki/Command-Usage
- Веб-редактор: https://luckperms.net/wiki/Web-Editor
LuckPerms: посмотреть пример
Собственные записи из демо-среды. Показанные версия и настройки могут отличаться от твоего сервера.
LuckPerms 5.5.71 · 2026-09-12
LuckPerms 5.5.71 · 2026-09-12