Введение: порядок в правах — порядок на сервере

LuckPerms — это современный плагин для управления правами и группами игроков. Он пришёл на смену устаревшим PermissionsEx и GroupManager и стал стандартом де-факто для серверов Minecraft. LuckPerms работает на Paper, Spigot, BungeeCord, Velocity, Fabric и даже на ванильном сервере. В этом гайде я разберу ВСЁ: от установки до создания сложных иерархий прав с наследованием и временными привилегиями.

Шаг 1: Установка LuckPerms

1. Скачайте LuckPerms с официальной страницы на SpigotMC или Modrinth. Выберите версию для вашего ядра (Bukkit для Paper/Spigot).
2. Поместите JAR-файл в папку plugins на сервере.
3. Перезапустите сервер. LuckPerms создаст папку plugins/LuckPerms с конфигурацией и базой данных.
4. Проверьте установку: выполните команду /lp в консоли. Вы должны увидеть список доступных подкоманд.

Шаг 2: Выбор хранилища данных

По умолчанию LuckPerms использует H2 (встроенная база данных, файл в папке плагина). Этого достаточно для небольших серверов. Для сети серверов или высоконагруженных проектов рекомендуется MySQL.

Настройка MySQL в конфиге config.yml:

storage-method: MySQL
data:
  address: localhost:3306
  database: minecraft_luckperms
  username: root
  password: ваш_пароль

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

Шаг 3: Создание групп (рангов)

Группы — это наборы прав, которые присваиваются игрокам. Типичная иерархия сервера:

default (игрок) → vip → premium → elite → moderator → admin → owner

Создание группы default:

/lp group default create
/lp group default set displayname "&7Игрок"
/lp group default setprefix "&7[Игрок] "

Создание группы vip:

/lp group vip create
/lp group vip set displayname "&aVIP"
/lp group vip setprefix "&a[VIP] "
/lp group vip parent add default

Команда parent add default означает, что VIP наследует ВСЕ права группы default. Вам не нужно копировать права — достаточно указать родителя.

Назначение группы игроку:

/lp user Игрок parent set vip

Шаг 4: Выдача прав (permissions)

Права определяют, какие команды и функции доступны группе. Каждый плагин регистрирует свои права.

Пример: права для группы default (базовый игрок):

/lp group default permission set essentials.home true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.warp true
/lp group default permission set essentials.msg true
/lp group default permission set griefprevention.claimblock true

Пример: права для группы vip (привилегии):

/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.feed true
/lp group vip permission set essentials.hat true
/lp group vip permission set essentials.heal true
/lp group vip permission set griefprevention.claimblock.multiply 2
/lp group vip permission set essentials.sethome.multiple.vip true

Право-звёздочка (ОПАСНО): никогда не выдавайте право * (звезда). Оно даёт ВООБЩЕ ВСЕ права, включая /op, /stop, /reload. Это верный способ потерять сервер.

Шаг 5: Временные права и группы

LuckPerms позволяет выдавать права и группы на определённое время. Это идеально для доната: игрок покупает VIP на 30 дней, и привилегия автоматически снимается.

Выдача временной группы:

/lp user Игрок parent settemp vip 30d

Поддерживаемые форматы времени: 30d (30 дней), 7h (7 часов), 90m (90 минут), 60s (60 секунд).

Выдача временного права:

/lp user Игрок permission settemp essentials.fly true 7d

Шаг 6: Контексты (Contexts) — продвинутая настройка

Контексты позволяют выдавать права с УСЛОВИЯМИ. Например, право на /fly работает ТОЛЬКО в мире survival, но не в мире creative. Или право на /god работает ТОЛЬКО на спавне.

Право, ограниченное миром:

/lp group vip permission set essentials.fly true world=survival

Право, ограниченное сервером (для BungeeCord):

/lp group vip permission set essentials.fly true server=survival

Право, действующее только в определённом регионе WorldGuard:

/lp group vip permission set essentials.god true world=survival region=spawn

Шаг 7: Мета-данные (Meta) — префиксы, суффиксы, веса

Мета-данные используются плагинами чата (EssentialsX Chat, ChatControl) для отображения префиксов и суффиксов.

Установка префикса и суффикса для группы:

/lp group vip meta setprefix 1 "&a[VIP] &f"
/lp group vip meta setsuffix 1 " &b✪"

Вес группы (определяет, кто отображается выше в Tab-списке):

/lp group vip setweight 10
/lp group premium setweight 20

Шаг 8: Веб-редактор (Web Editor)

LuckPerms имеет встроенный веб-редактор, который позволяет управлять правами через браузер с удобным интерфейсом.

Запуск веб-редактора:

1. Выполните команду: /lp editor.
2. Сервер выдаст ссылку вида https://luckperms.net/editor/session/XXXXXX.
3. Откройте ссылку в браузере. Вы увидите графический интерфейс для управления группами, пользователями, правами.
4. Внесите изменения и нажмите «Save» — LuckPerms применит их на сервере.

Безопасность: ссылка на редактор одноразовая и действительна 10 минут. Никому не передавайте её.

Шаг 9: Импорт с других плагинов прав

Если вы переезжаете с PermissionsEx, GroupManager или другого плагина — LuckPerms умеет импортировать данные.

/lp migration PermissionsEx
/lp migration GroupManager

Команда перенесёт все группы, пользователей и права в LuckPerms. После импорта удалите старый плагин и перезапустите сервер.

Шаг 10: Типичные ошибки и их решение

Ошибка 1: «У игрока нет права, хотя я его выдал»

• Проверьте, к какой группе принадлежит игрок: /lp user Игрок info.
• Проверьте, что право написано БЕЗ ОШИБОК (регистр важен: essentials.fly, а не Essentials.fly).
• Проверьте контексты — возможно, право ограничено миром или сервером.
• Проверьте, что плагин, предоставляющий право, ЗАГРУЖЕН (/pl).

Ошибка 2: «Группы не отображаются в чате»

• Убедитесь, что плагин чата (EssentialsX Chat, ChatControl) настроен на использование LuckPerms.
• В конфиге EssentialsX: use-displayname: true и change-displayname: true.

Ошибка 3: «После перезапуска сервера права сбросились»

• Проверьте хранилище данных. Если вы использовали H2 — файл базы данных мог повредиться. Перейдите на MySQL.
• Проверьте, что папка LuckPerms доступна для записи.

💡 Совет профи

Создайте группу-шаблон «donate-base» без префикса и отображения, но со ВСЕМИ донатными правами. Все VIP-группы наследуют этот шаблон: /lp group vip parent add donate-base. Теперь, чтобы добавить новую донатную возможность, вы меняете права ОДНОЙ группы-шаблона, и изменения применяются ко ВСЕМ донатным группам сразу. Это экономит часы рутины при обновлении привилегий.