LuckPerms: права и группы на сервере за 10 минут

LuckPerms — плагин прав для серверов Minecraft. Основа работы — четыре команды: lp creategroup <группа> создаёт группу, lp group <группа> permission set <право> true выдаёт ей право, lp group <группа> parent add <другая> подключает наследование, lp user <ник> parent add <группа> добавляет игрока в группу. Всё то же можно сделать мышкой в веб-редакторе: /lp editor.

Почему не OP#

OP — это «всё или ничего». У многих плагинов права по умолчанию выданы операторам: например, команды CoreProtect, включая откат чужих построек и очистку базы. Дали модератору OP, чтобы он мог кикать, — он получил и откат, и смену режима игры, и управление плагинами.

Хуже того, украденный аккаунт с OP — это весь сервер. LuckPerms даёт каждому ровно то, что нужно для работы, и снимает права одной командой. OP оставьте себе — или не держите вовсе, выдав себе права через LuckPerms.

Установка и первый доступ#

1. 1

   Скачайте и поставьте

   Файл для Bukkit/Paper — на luckperms.net/download. Положите его в plugins/ и перезапустите сервер, как любой плагин: как установить плагин.

2. 2

   Выберите хранилище

   По умолчанию данные лежат в файловой базе H2 в папке плагина — для одного сервера этого хватает. Для сети серверов, которые делят права, в config.yml в разделе Storage Settings выбирают MySQL или MariaDB. Решите сразу: менять потом можно, но лучше один раз.

3. 3

   Дайте себе полный доступ

   Сразу после установки командами LuckPerms не может пользоваться никто. Зайдите на сервер, откройте консоль и выполните lp user <ваш ник> permission set luckperms.* true. Дальше можно работать из игры.

Четыре понятия#

• Право (permission node) — строка вида minecraft.command.ban. Может быть true (есть), false (явно запрещено) или не задано — обычно это то же, что запрет.
• Группа — набор прав, который выдаётся игрокам целиком. Вместо того чтобы настраивать каждого, вы настраиваете группу.
• Наследование (parent) — группа или игрок получает все права родительской группы. Наследование сквозное: admin → moderator → helper → default.
• default — группа, в которой по умолчанию все игроки. Её нельзя заменить другой; разработчики советуют оставить её основной группой для всех.

Готовая схема ролей#

Создаём группы и выдаём права#

lp creategroup helper
lp creategroup moderator
lp creategroup admin

lp group helper parent add default
lp group moderator parent add helper
lp group admin parent add moderator

lp group helper permission set coreprotect.inspect true
lp group moderator permission set coreprotect.lookup true
lp group moderator permission set minecraft.command.kick true
lp group admin permission set minecraft.command.ban true
lp group admin permission set coreprotect.rollback true

Убрать право — permission unset, явно запретить — permission set <право> false. Права CoreProtect взяты из его документации; инспектор /co i и поиск по логам — главные инструменты против гриферов, см. CoreProtect.

Добавляем людей в группы#

lp user Steve parent add moderator
lp user Steve parent remove moderator
lp user Alex parent set admin
lp user Steve parent addtemp helper 7d

• parent add добавляет группу к уже имеющимся и не трогает основную группу игрока.
• parent set заменяет все группы игрока на одну (в заданном контексте) и делает её основной.
• parent addtemp выдаёт группу на время: 7d — неделя, 1mo3d13h45m — месяц, 3 дня, 13 часов и 45 минут. Удобно для испытательного срока нового помощника.

Префиксы и веса#

lp group admin meta setprefix 300 "&c[Админ] "
lp group moderator meta setprefix 200 "&9[Модер] "
lp group helper meta setprefix 100 "&a[Помощник] "
lp group admin setweight 300
lp group moderator setweight 200
lp group helper setweight 100

Вес решает конфликты: если у игрока несколько групп или префиксов, побеждает больший вес. Разработчики советуют оставлять между весами запас (шаг 100, а не 1), чтобы потом вставить новую группу между существующими без перенастройки.

Треки: повышение и понижение#

Трек — лестница групп для повышений. Он не влияет на наследование, только на то, куда игрок переходит командой promote или demote.

lp createtrack staff
lp track staff append helper
lp track staff append moderator
lp track staff append admin

lp user Steve promote staff
lp user Steve demote staff

Если игрока ещё нет на треке, promote добавит его в первую группу трека. Повышение снимает предыдущую группу трека, поэтому у Steve не окажется сразу helper и moderator.

Веб-редактор#

Команда /lp editor присылает ссылку на редактор в браузере: группы, права, наследование и префиксы — в одном окне, с автодополнением. После правок нажмите Save (или Ctrl+S): редактор покажет команду, которую нужно выполнить на сервере, чтобы изменения применились. Для одной группы — /lp group <группа> editor, для игрока — /lp user <ник> editor.

Как найти нужное право#

1. 1Посмотрите документацию плагина — у большинства есть список прав.
2. 2Выполните /lp verbose record <ник> и попросите этого игрока ввести нужную команду.
3. 3Выполните /lp verbose paste — LuckPerms выключит запись и даст ссылку на отчёт со всеми правами, которые проверялись.

Так же настраиваются права античита. Командам DGuard нужно право dguard.admin (см. установку DGuard). Выдавайте его только администраторам: команды показывают состояние лицензии и перечитывают конфиг.

Права в игре и доступ к панели#

LuckPerms управляет тем, что люди могут делать на сервере. Доступ к панели античита — отдельная история: в DGuard владелец приглашает модераторов и администраторов по почте (до 10 мест). Модератор видит статус серверов и журнал наказаний с отчётами, фильтрами и выгрузкой в CSV, администратор ещё добавляет серверы и выпускает ключи, а оплата остаётся только у владельца. Как распределить роли в команде — в статье команда модераторов.

Частые вопросы#