Гайд по LuckPerms: группы, ранги и команды

Установите LuckPerms и выдайте себе доступ

1. Скачайте нужную сборку с luckperms.net — Bukkit для Paper и Spigot или сборку Fabric, NeoForge либо Velocity для этих платформ. Нужна Java 11 или новее, которая есть на любом актуальном сервере.
2. Положите jar в plugins (или в mods на Fabric и NeoForge), удалите любой другой плагин прав и полностью перезапустите сервер.
3. Выдайте себе доступ из консоли. Поначалу команды LuckPerms не может использовать никто, даже вы:

lp user YourName permission set luckperms.* true

После этого можно использовать /lp в игре. При первом запуске LuckPerms скачивает несколько библиотек, поэтому серверу нужен доступ в интернет.

Группы, наследование, вес и треки

• Узлы прав (permission nodes) — это ключи, например essentials.home или minecraft.command.gamemode. Каждый может быть true, false или не задан.
• Группы содержат права. Каждый игрок состоит в default; остальные добавляете вы.
• Наследование: у группы могут быть родительские группы, и она получает всё, что есть у них. Если admin наследует mod, а mod наследует default, у администраторов есть права всех трёх.
• Вес решает, какая группа побеждает при конфликте, — выигрывает большее число. Шаг 100 оставляет место для групп, которые вы добавите позже.
• Треки — это лестницы повышения, например default → helper → mod → admin, используются с promote и demote. Сами по себе они наследование не меняют.
• Контексты ограничивают право сервером или миром, например world=survival в конце команды.

Готовая схема: игрок, модератор и администратор

Создайте группы, свяжите их цепочкой и выдайте каждой нужные права. Узлы ниже относятся к командам EssentialsX; подставьте узлы своих плагинов.

lp creategroup mod
lp creategroup admin
lp group mod parent add default
lp group admin parent add mod
lp group mod setweight 100
lp group admin setweight 200

lp group default permission set essentials.home true
lp group default permission set essentials.sethome true
lp group default permission set essentials.spawn true
lp group default permission set essentials.tpa true
lp group default permission set essentials.tpaccept true
lp group default permission set essentials.msg true

lp group mod permission set essentials.kick true
lp group mod permission set essentials.mute true
lp group mod permission set essentials.tempban true

lp group admin permission set essentials.* true
lp group admin permission set luckperms.* true

lp user Steve parent add mod

Затем трек для повышений:

lp createtrack staff
lp track staff append default
lp track staff append mod
lp track staff append admin

lp user Steve promote staff поднимает Steve на одну ступень. Полный список команд и узлов EssentialsX — в гайде по EssentialsX.

Префиксы и ранги в чате

Задайте префикс группе:

lp group admin meta setprefix "&c[Admin] "

LuckPerms хранит префикс, а показывать его должен плагин чата. Установите Vault и плагин чата, который берёт данные из него, например EssentialsX Chat. Если у игрока несколько групп, используется префикс с наивысшим приоритетом — задайте его через meta setprefix 100 "...".

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

Для крупных изменений редактор удобнее команд. Выполните /lp editor, откройте выведенную ссылку и редактируйте группы, пользователей и треки в браузере. После сохранения редактор покажет команду — выполните её в игре или в консоли, и изменения применятся. Пока вы не выполните эту команду, на сервере ничего не изменится.

Команды LuckPerms, которые вам понадобятся

Не знаете, какой узел нужен команде? Выполните /lp verbose record, используйте команду от имени игрока, затем /lp verbose upload — в отчёте будет каждое проверенное право.

LuckPerms на сервере или сети HytHost

• Установка: загрузите jar в plugins через файловый менеджер или по SFTP, затем перезапустите сервер из панели. Первую команду lp user ... luckperms.* выполните во вкладке Console.
• Один сервер: стандартного хранилища H2 достаточно.
• Сеть: установите LuckPerms на прокси и на каждый бэкенд и подключите их все к одной базе MySQL через storage-method: mysql в config.yml. Каждый тариф Minecraft от HytHost включает базы данных MySQL; настройка самого прокси описана в гайде как настроить прокси Velocity.