Установка LuckPerms и базовая настройка групп

LuckPerms — стандарт для управления правами на серверах Bukkit, Spigot, Paper, Velocity и BungeeCord. Установка LuckPerms занимает пару минут, а вот структура групп, которую вы зададите на старте, останется с вами надолго — переделывать её на живом сервере с сотней игроков неприятно. Разберу оба этапа: как поставить и как сразу собрать нормальную иерархию.

Что нужно перед началом

• Ядро на базе Bukkit: Paper, Spigot или Purpur (для Fabric есть отдельная сборка)
• Java 17 или новее
• Доступ к папке plugins через панель или SFTP

Если на сервере уже стоит PermissionsEx, GroupManager или UltraPermissions — сначала снесите их. Два плагина прав одновременно дают непредсказуемый результат: команды выполняются, а права не применяются.

Шаг 1. Скачивание нужной сборки

На странице загрузки LuckPerms несколько вариантов, и выбрать надо строго свой (порядок установки для каждой платформы — в официальной инструкции):

Файл под прокси на обычный сервер не встанет и наоборот. Если у вас сеть из нескольких серверов, ставить нужно и на прокси, и на каждый бэкенд, с общей базой данных — сборку сети разбирал материал про BungeeCord и Velocity.

Шаг 2. Установка LuckPerms на сервер

Порядок стандартный для любого плагина:

1. Откройте Файлы → папка plugins
2. Загрузите LuckPerms-Bukkit-5.4.xxx.jar
3. Перезапустите сервер полностью

Через SFTP путь тот же — подключение описано в инструкции по SFTP. Общий порядок работы с плагинами — в разделе про установку плагинов.

После рестарта в консоли появится:

[LuckPerms] Loading configuration...
[LuckPerms] Loading storage provider... [H2]
[LuckPerms] Successfully enabled. (took 340ms)

Проверить, что плагин жив:

/lp info

Шаг 3. Выбор хранилища

По умолчанию LuckPerms использует встроенную базу H2 — файл в plugins/LuckPerms/. Для одиночного сервера этого достаточно и ничего настраивать не нужно.

MySQL нужен в двух случаях: сеть из нескольких серверов с общими правами и желание держать данные вне файлов сервера. Настройка в plugins/LuckPerms/config.yml:

storage-method: mysql
data:
  address: 127.0.0.1:3306
  database: luckperms
  username: lp_user
  password: пароль
  table-prefix: luckperms_

Для сети дополнительно включается синхронизация между серверами:

messaging-service: sql
sync-minutes: 3

После правки конфига — полный рестарт. Данные из H2 переносятся командой:

/lp export backup
/lp import backup

Первую выполняете на старом хранилище, вторую — после переключения на новое.

Шаг 4. Базовая структура групп

Не создавайте двадцать групп сразу. Рабочая схема для сервера выживания:

default  →  vip  →  premium
default  →  helper  →  moderator  →  admin

Создаём:

/lp creategroup vip
/lp creategroup premium
/lp creategroup helper
/lp creategroup moderator
/lp creategroup admin

Группа default создаётся автоматически и выдаётся всем новым игрокам — отдельно её делать не надо.

Шаг 5. Наследование

Ключевая идея LuckPerms: группа наследует все права родителя, а вы дописываете только разницу.

/lp group vip parent add default
/lp group premium parent add vip
/lp group helper parent add default
/lp group moderator parent add helper
/lp group admin parent add moderator

Теперь право, выданное default, автоматически есть у всех. Право, выданное helper, есть у модератора и админа.

Это экономит часы работы. Без наследования каждую новую команду пришлось бы прописывать пяти группам вручную.

Шаг 6. Веса групп

Вес (weight) решает, чей префикс показывается игроку с несколькими группами и кто кого может наказывать в плагинах модерации.

/lp group default setweight 1
/lp group vip setweight 10
/lp group premium setweight 20
/lp group helper setweight 50
/lp group moderator setweight 70
/lp group admin setweight 100

Оставляйте зазоры между значениями — потом захочется вставить группу посередине, и не придётся перенумеровывать всё.

Шаг 7. Префиксы

/lp group vip meta setprefix "&6[VIP] "
/lp group premium meta setprefix "&b[PREMIUM] "
/lp group moderator meta setprefix "&2[Модер] "
/lp group admin meta setprefix "&c[Админ] "

Пробел в конце префикса нужен, иначе ник приклеится к скобке. Для отображения префикса в чате нужен чат-плагин (EssentialsChat, ChatControl) или скорборд-плагин — сам LuckPerms только хранит значение.

Установка EssentialsX, который чаще всего берут для чата и базовых команд, описана в соседнем разделе.

Шаг 8. Первые права

Минимальный набор для default на выживании:

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

Для VIP — то, за что платят:

/lp group vip permission set essentials.sethome.multiple.vip true
/lp group vip permission set essentials.kit.vip true
/lp group vip permission set essentials.fly true

Для модератора:

/lp group moderator permission set essentials.mute true
/lp group moderator permission set essentials.kick true
/lp group moderator permission set essentials.vanish true
/lp group moderator permission set litebans.ban.temp true

Полный разбор синтаксиса и всех рабочих команд — в материале про команды LuckPerms.

Право * не выдавайте никому, кроме себя. Оно даёт доступ ко всему, включая команды плагинов, которые вы поставите через полгода.

Шаг 9. Веб-редактор

Самая недооценённая функция плагина:

/lp editor

Команда выдаёт ссылку на веб-интерфейс, где вся структура групп видна деревом, права переключаются галочками, а изменения применяются одной кнопкой. Для настройки с нуля это в разы быстрее, чем набирать десятки команд в консоли.

Ссылка живёт ограниченное время и содержит слепок ваших данных — не выкладывайте её публично.

Шаг 10. Выдача групп игрокам

Постоянно:

/lp user Nick parent set vip

На срок (для платных статусов):

/lp user Nick parent addtemp vip 30d accumulate

Проверить, что у игрока сейчас:

/lp user Nick info

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

Типичные ошибки

Права не применяются после команды. На одиночном сервере изменения LuckPerms действуют сразу. Выполните /lp user Nick permission check <право> и посмотрите, откуда берётся значение — часто право перебивается явным false в другой группе. В сети с прокси проверьте синхронизацию (/lp networksync).

Два плагина прав одновременно. Удалите лишний, иначе поведение непредсказуемо.

Наследование настроено «наоборот». Частая путаница: parent add добавляет родителя текущей группе, а не наоборот. /lp group vip parent add default означает «vip наследует default».

Оператор перебивает права. У игрока с /op работает всё независимо от групп. Снимайте OP у модераторов и выдавайте права группами — про операторов и whitelist есть отдельный раздел.

Забыли бэкап. Перед крупной переделкой прав делайте /lp export backup — восстановление занимает секунды.

Более развёрнутый разбор с контекстами и трек-группами — в статье как настроить LuckPerms.

Если сервер только поднимается и вы собираете стартовый набор плагинов — подобрать подходящий тариф можно на странице цен.