Права и группы на сервере Minecraft — плагин LuckPerms

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 13:39, 17 ноября 2026; Maintenance script (обсуждение | вклад) (Новая статья: Права и группы на сервере Minecraft — плагин LuckPerms (проверено на Ubuntu 24.04, со снимками экрана))
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

LuckPerms — плагин, который управляет правами на сервере Minecraft: кому можно летать, кто ставит приваты, кто может выгнать нарушителя. Без него на сервере два сорта игроков — обычные и операторы, которым можно всё. С ним появляются группы — «игрок», «VIP», «модератор», «администратор» — у каждой свой набор прав, своя приставка в чате и своё место в лестнице должностей. В статье — установка LuckPerms на сервер Paper, группы и наследование, приставки, права отдельных игроков, повышение по лестнице и резервная копия. Всё проверено 17 ноября 2026 года на Ubuntu 24.04.4: Paper 26.3, LuckPerms 5.5.91; снимки экрана сняты с настоящего сервера.

Сервер установлен по статье Установка и настройка Spigot-Paper сервера; общие сведения о плагинах — Настройка плагинов для Minecraft сервера.

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

  • Право (permission) — строка вида worldguard.region.claim. Её придумывает автор плагина: в описании каждого плагина есть список его прав. У команд самой игры права начинаются с minecraft.command..
  • Группа — именованный набор прав. Все игроки сразу состоят в группе default.
  • Наследование — группа получает все права другой группы. Модератор наследует VIP, администратор — модератора: права не приходится перечислять заново.
  • Вес — число, по которому LuckPerms решает, какая группа игрока главная: её приставка и показывается в чате.

Как вводить команды

Команды LuckPerms начинаются с lp. Вводить их можно в игре (с косой чертой: /lp …, нужны права оператора) или в консоли сервера — без косой черты. Чтобы не открывать консоль ради каждой команды, удобно завести маленький скрипт, который отправляет команды в консоль и показывает ответ:

sudo nano /usr/local/bin/mcc
#!/bin/bash
# mcc "команда" ["команда" ...] — отправить команды в консоль сервера Minecraft и показать её ответ
L=/opt/minecraft/server/logs/latest.log; n=$(wc -l < $L)
for c in "$@"; do sudo -u minecraft tmux send-keys -t minecraft "$c" Enter; sleep 1; done
sleep 1; tail -n +$((n+1)) $L | sed 's/^\[[0-9:]*\] \[[^]]*\]: //' | cut -c1-108
sudo chmod +x /usr/local/bin/mcc

Дальше в статье команды записаны через mcc; то, что в кавычках, — и есть команда консоли.

1. Установка

sudo systemctl stop minecraft
sudo -u minecraft bash -c 'cd /opt/minecraft/server/plugins && curl -sLO "$(curl -s https://metadata.luckperms.net/data/downloads | jq -r .downloads.bukkit)" && ls'
sudo systemctl start minecraft
grep -E "LuckPerms\] (Enabling|Successfully)|Done \(" /opt/minecraft/server/logs/latest.log | cut -c34-110
mcc "lp info" | head -n 9

Вторая команда узнаёт у разработчиков адрес последней версии и скачивает её в каталог plugins. В журнале — «Successfully enabled», а lp info показывает версию плагина и то, что права хранятся во встроенной базе H2.

2. Группы, права, наследование

mcc "lp creategroup vip" "lp creategroup moderator" "lp creategroup admin"
mcc "lp group vip permission set worldguard.region.claim true" "lp group moderator permission set coreprotect.inspect true" "lp group moderator permission set minecraft.command.kick true"
mcc "lp group moderator parent add vip" "lp group admin parent add moderator" "lp group admin permission set * true"

Что сделано:

  • созданы три группы;
  • VIP получили право ставить приват (право плагина WorldGuard), модераторы — смотреть журнал действий (CoreProtect) и выгонять игроков;
  • модератор наследует VIP, администратор — модератора; администратору дано * — все права сразу.
Команда Что делает
lp creategroup имя Создать группу
lp group имя permission set право true Дать группе право
lp group имя permission set право false Запретить — даже если право пришло по наследству
lp group имя permission unset право Убрать запись о праве
lp group имя parent add группа Унаследовать права другой группы
lp group имя permission info Показать права группы
lp deletegroup имя Удалить группу

Права обычных игроков задаются группе default: lp group default permission set ….

3. Вес и приставки в чате

mcc "lp group vip setweight 10" "lp group moderator setweight 50" "lp group admin setweight 100"
mcc "lp group vip meta setprefix 10 &6[VIP]&r" "lp group moderator meta setprefix 50 &a[Mod]&r" "lp group admin meta setprefix 100 &c[Admin]&r"
mcc "lp listgroups"
mcc "lp group moderator permission info"

Число после setprefix — приоритет приставки: у игрока, состоящего в нескольких группах, показывается приставка с наибольшим. Знаки &6, &a, &c — цвета (золотой, зелёный, красный), &r — сброс цвета.

Сам LuckPerms приставки только хранит. Чтобы они появились в чате, нужен плагин оформления чата, который их читает, — например, EssentialsX Chat вместе с Vault.

4. Права отдельного игрока

mcc "lp user Steve parent add vip"
mcc "lp user Steve permission settemp minecraft.command.gamemode true 7d"
mcc "lp user Steve permission check worldguard.region.claim"

  • первая команда добавляет игрока в группу VIP;
  • вторая даёт право на неделю (7d; бывает 12h, 30d) — по истечении срока оно снимется само. Так оформляют временные привилегии;
  • третья отвечает на вопрос «почему у игрока есть это право»: на снимке — «Result: true», причина — группа vip.

Вместо Steve подставьте имя игрока. По имени LuckPerms находит только тех, кто хотя бы раз заходил на сервер; на снимке вместо имени указан идентификатор игрока (UUID) — так можно выдать права заранее.

Команда Что делает
lp user имя info Группы, приставка и главная группа игрока
lp user имя parent add группа Добавить в группу
lp user имя parent set группа Оставить только эту группу
lp user имя parent addtemp группа 30d Добавить в группу на срок
lp user имя parent remove группа Убрать из группы
lp user имя permission set право true Дать право лично игроку

5. Лестница должностей

Лестница (track) — порядок групп, по которому игрока повышают и понижают одной командой:

mcc "lp createtrack staff" "lp track staff append vip" "lp track staff append moderator" "lp track staff append admin"
mcc "lp user Steve promote staff"
mcc "lp user Steve info" | grep -A 4 "Parent Groups"
mcc "lp user Steve demote staff"

На снимке игрок повышен с VIP до модератора (в его группах теперь moderator), затем понижен обратно.

6. Где хранятся права и как сделать копию

mcc "lp export backup-2026-11-17"
sudo ls -l /opt/minecraft/server/plugins/LuckPerms/
sudo grep -E "^(server|storage-method):" /opt/minecraft/server/plugins/LuckPerms/config.yml

Файл Что это
luckperms-h2-v2.mv.db База с группами и правами
config.yml Настройки плагина
backup-….json.gz Выгрузка всех прав командой lp export. Загрузить обратно — lp import имя-файла

Выгрузку удобно делать перед большими переделками прав и хранить вместе с копией мира: Настройка автоматических бэкапов Minecraft.

Две настройки в config.yml, о которых стоит знать:

  • storage-method — где хранить права. h2 подходит одному серверу. Если серверов несколько и права должны быть общими (сеть с прокси), все серверы подключают к одной базе MySQL или MariaDB: Установка и конфигурация MySQL/MariaDB;
  • server — имя этого сервера в сети. С ним право можно выдать только на одном сервере: lp user Steve permission set право true server=survival.

Есть и веб-редактор: команда lp editor выдаёт ссылку на страницу, где группы и права правятся таблицей. Данные на время правки передаются на сайт разработчиков LuckPerms; для небольшого сервера удобнее команды.

Что не проверено

Проверены: установка, группы, права, наследование, вес и приставки, права и временные права игрока, проверка права, лестница, выгрузка. Команды выполнялись в консоли сервера, вместо имени игрока использовался идентификатор. Не проверены: действие прав на игрока в игре, показ приставок в чате, веб-редактор и общая база для нескольких серверов.

Если что-то пошло не так

Что видите Причина и решение
«A user for … could not be found» Игрок с таким именем ещё не заходил на сервер. Пусть зайдёт, либо укажите его UUID
Право выдано, а команда у игрока не работает Неверно написано право — сверьте с описанием плагина. Проверка: lp user имя permission check право
У игрока действует право, которого ему не давали Оно пришло по наследству или игрок — оператор. Операторам (op) разрешено всё помимо LuckPerms: снимите статус командой deop имя
Приставка не видна в чате Нет плагина оформления чата, который читает приставки LuckPerms
В игре «у вас нет прав» на команды /lp Нужны права оператора или право luckperms.*. Первый раз выдайте его себе из консоли: lp user имя permission set luckperms.* true
После переноса сервера права пропали Не перенесён каталог plugins/LuckPerms — права лежат в нём, а не в каталоге мира

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: