Как управлять рангами и правами с помощью LuckPerms
Установите LuckPerms на сервер Minecraft Paper, создайте ранги, назначьте права и префиксы, затем проверьте конфигурацию и сохраните её резервную копию.
На этой странице
LuckPerms — это плагин, который определяет, что разрешено делать каждому игроку на вашем сервере. Это руководство объясняет, как установить его, создать иерархию рангов (игрок, VIP, модератор, администратор), распределить по ним игроков и проверить результат.
Предварительные требования
- Сервер на Paper с командой
mc-console, настроенной по руководству Установка и обновление плагинов на Paper - Отсутствие других плагинов прав: LuckPerms должен быть единственным
- Ваш ник в Minecraft и игроки, которые уже заходили на сервер хотя бы один раз
В этом руководстве Steve и Alex — примеры: замените их настоящими никами.
Основные понятия
| Понятие | Значение |
|---|---|
| Право | Разрешение в текстовом виде, например minecraft.command.ban. Его значение — true (разрешено) или false (запрещено) |
| Группа | Набор прав, назначаемый игрокам: это и есть ваш ранг |
| Родитель | Группа, от которой наследуются права. Игрок наследует от своих групп, а группа может наследовать от другой группы |
| Вес | Приоритет группы при конфликте. Побеждает наибольшее число |
| Контекст | Условие применения права, например конкретный мир |
| Трек (track) | Лестница рангов, позволяющая повышать или понижать игрока |
По умолчанию все игроки входят в группу default, которая существует сразу после установки.
Установка LuckPerms
Загрузите версию для Bukkit/Paper в папку plugins:
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
URL=$(curl -fsSL https://metadata.luckperms.net/data/all | jq -r '.downloads.bukkit')
curl -fLO "$URL"
ls -l LuckPerms-*.jar
exitЗатем перезапустите сервер и дождитесь строки Done:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fВыйдите из просмотра журнала клавишами Ctrl+C, затем проверьте, что плагин отвечает:
sudo mc-console 'lp info'В ответе указаны версия LuckPerms и используемый тип хранилища.
Выбор хранилища
По умолчанию LuckPerms хранит данные в локальной базе H2, в файле plugins/LuckPerms/luckperms-h2-v2.mv.db. Этот вариант подходит для одного сервера, и менять ничего не нужно.
Если вы предпочитаете читаемые и редактируемые файлы, укажите storage-method: yaml в plugins/LuckPerms/config.yml и перезапустите сервер. Если у вас несколько серверов с общими рангами, нужна удалённая база данных, например MySQL или MariaDB. Определитесь сейчас: это проще сделать до создания групп.
Получение доступа к командам
Сразу после установки никто не может использовать /lp в игре. Доступ есть только у консоли. Выдайте себе все права на LuckPerms:
sudo mc-console 'lp user Steve permission set luckperms.* true'После этого вы можете использовать /lp в игре или продолжать работу из консоли, как далее в этом руководстве.
Создание рангов
Вот иерархия из примера. Оставляйте промежутки между весами, чтобы позже можно было добавить новый ранг.
| Группа | Вес | Наследует от | Роль |
|---|---|---|---|
default |
1 | нет | Все игроки |
vip |
10 | default |
Привилегированные игроки |
moderator |
50 | vip |
Модерация |
admin |
100 | moderator |
Администрирование |
Создайте группы и задайте их веса:
sudo mc-console 'lp creategroup vip'
sudo mc-console 'lp creategroup moderator'
sudo mc-console 'lp creategroup admin'
sudo mc-console 'lp group default setweight 1'
sudo mc-console 'lp group vip setweight 10'
sudo mc-console 'lp group moderator setweight 50'
sudo mc-console 'lp group admin setweight 100'Затем настройте наследование. Оно передаётся по цепочке: admin также получает права vip и default.
sudo mc-console 'lp group vip parent add default'
sudo mc-console 'lp group moderator parent add vip'
sudo mc-console 'lp group admin parent add moderator'Назначение прав
Команды Minecraft используют права вида minecraft.command.<команда>. Дайте модераторам возможность выгонять и банить игроков, а администраторам — дополнительные права:
sudo mc-console 'lp group moderator permission set minecraft.command.kick true'
sudo mc-console 'lp group moderator permission set minecraft.command.ban true'
sudo mc-console 'lp group moderator permission set minecraft.command.pardon true'
sudo mc-console 'lp group admin permission set minecraft.command.gamemode true'
sudo mc-console 'lp group admin permission set minecraft.command.whitelist true'Чтобы убрать право или явно его запретить:
sudo mc-console 'lp group moderator permission unset minecraft.command.pardon'
sudo mc-console 'lp group vip permission set minecraft.command.kick false'unset удаляет запись, а false активно запрещает право, даже если оно унаследовано откуда-то ещё. Эти две команды приведены для примера: выполняйте их, только если вам действительно нужны такие изменения.
Права плагина описаны в его документации. Также можно посмотреть, какие права проверяет сервер, когда игрок вводит команду:
sudo mc-console 'lp verbose on Steve'Попросите игрока ввести команду, прочитайте журнал с помощью sudo journalctl -u minecraft.service -n 30 --no-pager, затем отключите отслеживание:
sudo mc-console 'lp verbose off'Распределение игроков по рангам
# Заменяет все группы игрока этим рангом
sudo mc-console 'lp user Steve parent set moderator'
# Добавляет ранг, не убирая остальные
sudo mc-console 'lp user Alex parent add vip'
# Убирает ранг
sudo mc-console 'lp user Alex parent remove vip'
# Выдаёт ранг на 30 дней
sudo mc-console 'lp user Alex parent addtemp vip 30d'Изменения применяются сразу, без перезапуска.
Создание трека повышения
Трек позволяет повысить или понизить игрока на одну ступень, не запоминая названия рангов. На наследование он никак не влияет.
sudo mc-console 'lp createtrack staff'
sudo mc-console 'lp track staff append default'
sudo mc-console 'lp track staff append moderator'
sudo mc-console 'lp track staff append admin'
sudo mc-console 'lp user Alex promote staff'
sudo mc-console 'lp user Alex demote staff'Добавление префиксов
Префикс отображается перед ником. Его вес определяет, какой префикс будет выбран, если игрок наследует несколько. Коды вроде &c задают цвет:
sudo mc-console 'lp group vip meta setprefix 10 "&6[VIP] "'
sudo mc-console 'lp group moderator meta setprefix 50 "&9[Modo] "'
sudo mc-console 'lp group admin meta setprefix 100 "&c[Admin] "'Сохраняйте одинарные кавычки вокруг всей команды и двойные кавычки вокруг префикса.
Ограничение права одним миром
Добавьте контекст в конец команды. При настройках по умолчанию основной мир называется world:
sudo mc-console 'lp group vip permission set minecraft.command.weather true world=world'Чтобы убрать это право, укажите тот же контекст:
sudo mc-console 'lp group vip permission unset minecraft.command.weather world=world'Использование веб-редактора
Если вы предпочитаете графический интерфейс, LuckPerms предлагает редактор в браузере:
sudo MC_CONSOLE_WAIT=5 mc-console 'lp editor'Откройте показанную ссылку, внесите изменения и сохраните их. Если редактор выдаст команду для выполнения, запустите её в консоли, чтобы применить изменения. Никому не передавайте эту ссылку: она даёт доступ к редактированию ваших прав.
Проверка результата
sudo mc-console 'lp listgroups'
sudo mc-console 'lp group moderator info'
sudo mc-console 'lp group moderator listmembers'
sudo mc-console 'lp user Steve info'
sudo mc-console 'lp user Steve permission check minecraft.command.kick'
sudo mc-console 'lp user Steve meta info'Вы должны увидеть четыре группы, Steve в moderator, право minecraft.command.kick со значением true и префикс [Modo].
Затем проведите реальную проверку с учётной записью, которая не является оператором. У оператора уже есть большинство прав, и это скрывает ошибки конфигурации. При необходимости снимите этот статус:
sudo mc-console 'deop Steve'Резервное копирование прав
Следующая команда создаёт файл plugins/LuckPerms/sauvegarde-luckperms.json.gz:
sudo MC_CONSOLE_WAIT=5 mc-console 'lp export sauvegarde-luckperms'Чтобы восстановить этот файл, размещённый в plugins/LuckPerms, укажите его расширение:
sudo MC_CONSOLE_WAIT=5 mc-console 'lp import sauvegarde-luckperms.json.gz'Регулярно копируйте этот файл за пределы сервера: резервная копия, хранящаяся там же, пропадёт вместе с ним.
Обновление LuckPerms
Поместите новую версию в plugins/update, затем перезапустите сервер. Paper заменит старый файл при запуске:
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
URL=$(curl -fsSL https://metadata.luckperms.net/data/all | jq -r '.downloads.bukkit')
curl -fLO "$URL"
exit
sudo systemctl restart minecraft.serviceПри возникновении проблем
«You do not have permission to use this command!»
У вашей учётной записи нет доступа к /lp. Выдайте себе luckperms.* из консоли, как описано выше.
«A user for Steve could not be found»
Ник написан с ошибкой, или этот игрок никогда не заходил на сервер. Проверьте написание и попросите его зайти на сервер в первый раз.
«A group named vip could not be found»
Такой группы ещё нет. Проверьте список командой sudo mc-console 'lp listgroups', затем создайте её с помощью lp creategroup.
«Cannot execute command 'lp' in plugin LuckPerms … plugin is disabled»
LuckPerms не смог запуститься. Найдите первую ошибку в журнале:
sudo journalctl -u minecraft.service --no-pager | grep -i -A5 'luckperms' | grep -iE 'error|exception|caused by' | head -20
df -h /opt/minecraftЗаполненный диск (No space left on device) или папка, не принадлежащая minecraft, не дают плагину создать свои файлы. Во втором случае выполните sudo chown -R minecraft /opt/minecraft/server, затем перезапустите сервер.
Право не работает
- Проверьте его командой
lp user Steve permission check <разрешение> - Убедитесь с помощью
sudo mc-console plugins, что не установлен другой плагин прав - Проверьте с учётной записью, не являющейся оператором
- Посмотрите, не запрещает ли его значением
falseгруппа с большим весом - Используйте
lp verbose, чтобы увидеть точное имя проверяемого права
Префикс не отображается в чате
Сначала убедитесь, что он сохранён: lp user Steve meta info. Если да, проблема в отображении: установите Vault и плагин чата. Если у двух префиксов одинаковый вес, задайте им разные веса.
Игроки Bedrock не распознаются
С Floodgate ники Bedrock начинаются с точки, а LuckPerms по умолчанию такие ники отклоняет. Порядок действий описан в руководстве Подключение игроков Bedrock с помощью Geyser и Floodgate.
Подробнее читайте в официальной вики LuckPerms.