LuckPerms на Minecraft-сервере: права, группы и префиксы

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

Ниже — установка LuckPerms на Paper 1.21.1, группы default, vip и admin, выдача прав, префиксы в чате и ошибки, которые встречаются чаще всего.

Коротко

Чтобы настроить права в LuckPerms на Paper 1.21.1, установите плагин из каталога «Моды и плагины», создайте группу командой lp creategroup vip, выдайте ей право через lp group vip permission set <право> true и назначьте игроку группу: lp user Steve_EGN parent add vip. Изменения применяются сразу, перезапускать сервер для команд не нужно.

Как устроены права

Есть три понятия.

• Право (permission node) — строка вида worldedit.wand, которую проверяет плагин: может ли игрок это делать.
• Группа — именованный набор прав. Игрок может состоять в нескольких группах.
• Наследование — группа может включать другую группу. Тогда она получает все её права.

Группа default особая: её права получают все игроки, даже если у них нет других групп. Вес группы (weight) решает, чьё значение побеждает, если одно и то же право выдано в двух группах с разными ответами. У группы с большим весом приоритет выше.

Для примера возьмём три группы:

Игрок с группой admin получает права всех трёх групп. Игрок с группой vip не получает прав admin. Это главная логика, которую нужно держать в голове: наследование идёт вверх по цепочке, а не вниз.

Шаги

1. Установите LuckPerms

В панели откройте «Моды и плагины», затем «Каталог». Выберите «Paper — плагины» и версию игры 1.21.1, найдите LuckPerms и нажмите «Установить». После установки нажмите «Перезапустить сервер» — плагин загрузится при старте.

В консоли после запуска должна появиться строка о том, что LuckPerms включён. Если её нет, откройте вкладку «Консоль» и проверьте, нет ли ошибок загрузки плагина.

Версия плагина

LuckPerms развивается по ветке 5.5. Каталог панели берёт сборки с Modrinth и подбирает подходящую под ядро и версию игры. Не копируйте старые jar-файлы из интернета: при обновлении сервера их легко перепутать.

2. Создайте группы

Откройте «Консоль» и выполните команды. В консоли пишите без слеша: lp, а не /lp.

lp creategroup vip
lp group vip setweight 10
lp creategroup admin
lp group admin setweight 100
lp group admin parent add vip

Первая строка создаёт группу, вторая задаёт вес, четвёртая и пятая создают admin и делают её наследником vip. Проверьте результат командой lp listgroups (список групп) и lp group admin info (вес, родители и права группы).

3. Выдайте права группам

Права группе задаются командой permission set. Примеры ниже показывают синтаксис. Названия узлов берите из документации конкретного плагина, а не придумывайте.

lp group default permission set essentials.spawn true
lp group vip permission set essentials.sethome true
lp group admin permission set worldedit.wand true
lp group admin permission set essentials.gamemode true

Право * даёт всё сразу. Не выдавайте его никому, кроме владельца сервера: вместе с ним игрок получит доступ к командам, которые могут удалить мир или выдать себе права.

Если право нужно убрать, используйте permission unset: lp group vip permission unset essentials.sethome.

4. Назначьте группу игроку

Игрок попадает в группу командой parent add. Ник указывайте точно, как в игре.

lp user Steve_EGN parent add vip
lp user Steve_EGN info
lp user Steve_EGN permission check worldedit.wand

Команда info показывает группы игрока, а permission check отвечает, есть ли у него конкретное право и из какой группы оно пришло. Эту связку удобно использовать для любой проверки.

Чтобы снять группу, выполните lp user Steve_EGN parent remove vip. Если нужно поставить единственную группу, используйте parent set: она заменит все остальные.

5. Как сделать в панели EGN

Список игроков открывается в разделе «Игроки». Там видно, кто на сервере сейчас, и есть кнопки «Кик», «Бан», «Права» и «В белый список». Кнопка «Права» выдаёт и снимает оператора (op) и не связана с группами LuckPerms: группы и права задаются командами lp из «Консоли». Кнопки «Кик» и «Бан» действуют сразу, поэтому перед ними проверяйте ник.

Порядок такой: откройте «Игроки», проверьте ник в списке, затем откройте «Консоль» и выдайте группу. Вернитесь в «Игроки», чтобы убедиться, что игрок в сети.

6. Префиксы в чате

LuckPerms хранит произвольные данные группы в метаданных. Префикс задаётся так:

lp group vip meta setprefix 100 "&a[VIP] "
lp group admin meta setprefix 200 "&c[Admin] "

Число (приоритет) решает, какой префикс показать, если их несколько. Значения &a и &c — цветовые коды Minecraft. Для отображения префикса в чате нужен плагин чата или таблиста, который читает LuckPerms. Сам LuckPerms префикс только хранит.

7. Где лежат данные и как сохранить

Настройки плагина лежат в папке plugins/LuckPerms/, в файле config.yml. По умолчанию данные хранятся локально, в файловой базе (в документации LuckPerms это тип хранилища H2) в той же папке; для сети серверов в config.yml можно выбрать MySQL/MariaDB. Правки config.yml применяются после перезапуска сервера.

Чтобы не потерять права при переезде или ошибке, сделайте резервную копию через раздел «Бэкапы» перед крупными изменениями: создание групп и наследование меняют сразу много записей.

Частые ошибки

Отдельно о op. Он работает сам по себе и не зависит от LuckPerms. Оператор имеет доступ ко всем стандартным командам сервера. Поэтому назначайте его только владельцам и доверенным модераторам, а остальным раздавайте группы.

Примеры из жизни сервера

Разберём три ситуации, с которыми сталкивается почти каждый владелец.

Ситуация 1. Игрок купил VIP на месяц. Не выдавайте группу навсегда. LuckPerms умеет временное назначение: lp user Steve_EGN parent addtemp vip 30d. Через тридцать дней группа снимется сама, и вам не придётся помнить о каждом игроке. Проверить срок можно командой lp user Steve_EGN info: там видно время окончания.

Ситуация 2. Модератору нужно только открыть поиск по откату. Не выдавайте ему всю группу admin. Создайте отдельную группу mod с весом 50, наследуйте её от default и выдайте только нужные права: lp creategroup mod, lp group mod setweight 50, lp group mod parent add default, затем права на поиск CoreProtect и команду /tp для наблюдения. Так модератор не получит доступ к /gamemode и /eco.

Ситуация 3. Права не сработали после обновления плагина. Плагин-владелец права может переименовать узел в новой версии. Откройте changelog именно этого плагина, найдите новое название и проверьте через permission check. Старое право можно убрать командой permission unset, чтобы не копить мусор. Подсказка: lp verbose on в консоли показывает, какие права реально проверяются в момент действия игрока.

Порядок действий для любой ситуации один: понять, кому нужен доступ, создать группу под задачу, выдать минимум прав и проверить info и permission check.

Как проверить, что всё настроено правильно

Пройдите чек-лист перед открытием сервера:

1. lp listgroups — все группы на месте; lp group <имя> info — веса и родители правильные.
2. lp group default info — в default нет админских прав.
3. lp user <ник> info — для тестового аккаунта группы и наследование как задумано.
4. Зайдите тестовым аккаунтом без групп и попробуйте команду, которой не должно быть. Она должна отказать.
5. Сделайте снимок в «Бэкапах», чтобы вернуть настройки, если что-то пойдёт не так.

Такой чек-лист занимает десять минут и экономит часы разборов, когда игрок пишет, что «у него пропало право».

Итог

LuckPerms — это порядок на сервере: один раз продумайте группы и их вес, а дальше добавляйте игроков одной командой. Логика простая: права живут в группах, группы наследуются вверх, игрок получает объединение всех своих групп. Перед каждым изменением проверяйте lp user <ник> info и permission check, и большинство ошибок станет видно сразу.

Дальше имеет смысл посмотреть EssentialsX: команды и киты — там видно, какие права нужны базовым командам. Для защиты территорий пригодится WorldGuard и WorldEdit, а про оператора и белый список — выдача op и whitelist.

Вопросы и ответы

Нужен ли LuckPerms, если на сервере есть op?

Нужен, если игроков больше двух-трёх. Оператор даёт доступ ко всему сразу и не делится на роли. LuckPerms позволяет выдавать точечные права, например только worldedit.wand, без статуса администратора.

Работает ли LuckPerms на Forge, Fabric и NeoForge?

Да, у LuckPerms есть отдельные сборки для Fabric, Forge и NeoForge (на Modrinth проект один, версии различаются загрузчиком). Для Paper 1.21.1 берите сборку под Bukkit-серверы: каталог панели выбирает её сам.

Применяются ли команды сразу или нужен перезапуск?

Команды lp применяются сразу, без перезапуска. Перезапуск нужен после правок config.yml, а для правок, сделанных в файлах хранилища напрямую, лучше использовать lp sync.

Можно ли выдать права группе, которой ещё нет?

Нет, сначала создайте её командой lp creategroup <имя>. Иначе LuckPerms вернёт ошибку и ничего не сохранит.

Сервер под Minecraft за пару минут — egnetwork.ru