Полный гайд по настройке LuckPerms: группы, права, префиксы и Web Editor

Управление правами доступа — основа безопасности и стабильности любого сервера Minecraft. Если игроки случайно получат доступ к запрещенным командам или, наоборот, не смогут взаимодействовать с сундуками на спавне, проект быстро потеряет аудиторию.

Стандартом де-факто в Minecraft с версии 1.12 и вплоть до современных 1.21+ является LuckPerms. В отличие от устаревших PermissionsEx и GroupManager, он работает молниеносно, не расходует лишнюю память, поддерживает веб-интерфейс и масштабируется на целые сети серверов.

В этом руководстве разберем полную настройку LuckPerms: от первичного запуска до сложных иерархий и связки с базами данных.

1. Установка и первый запуск#

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

lp user <Ваш_Никнейм> permission set luckperms.* true

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

2. Использование Web Editor (Веб-редактора)#

Главное преимущество LuckPerms — интерактивный веб-редактор. Больше не нужно вручную редактировать громоздкие .yml-файлы и рисковать синтаксисом табуляции.

Как запустить Web Editor:#

1. Введите в игре или в консоли:

/lp editor

2. Плагин сгенерирует уникальную защищенную ссылку вида:

https://luckperms.net/editor/AbCdEfGhIj

3. Перейдите по ссылке в браузере. Вы увидите удобную панель со всеми группами, треками и пользователями.
4. Внесите изменения (добавьте права, создайте группы).
5. Нажмите кнопку Save в правом верхнем углу.
6. Скопируйте готовую команду применения (например, /lp applyedits XYZ123) и отправьте ее в консоль или чат игры. Все изменения применятся мгновенно без перезагрузки сервера!

3. Иерархия групп и наследование (Inheritance)#

Грамотная архитектура прав строится на наследовании. Каждая последующая группа должна получать все права предыдущей, дополняя их новыми возможностями.

[ default ] (Обычные игроки)
    └── [ vip ] (Базовые бонусы, цвета в чате, /fly в лобби)
          └── [ premium ] (Расширенные слоты приватов, /hat, /workbench)
                └── [ moder ] (Кик, мут, бан, просмотр логов CoreProtect)
                      └── [ admin ] (Полный доступ, * права)

Создание базовых групп через команды:#

# 1. Создаем группы
/lp creategroup vip
/lp creategroup premium
/lp creategroup moder
/lp creategroup admin

# 2. Настраиваем наследование групп (VIP наследует default, Premium наследует VIP и т.д.)
/lp group vip parent add default
/lp group premium parent add vip
/lp group moder parent add premium
/lp group admin parent add moder

Благодаря такой структуре, если вы добавите новое право для default (например, команду /rules), оно автоматически появится у всех групп выше по цепочке.

4. Настройка префиксов, суффиксов и веса (Weight)#

Чтобы ники игроков в табе и чате отображались красиво с префиксами (например, [VIP] Steve), каждой группе задается вес (чем выше вес, тем выше приоритет группы) и метаданные префикса.

Команды настройки веса и префиксов:#

# Задаем вес группам
/lp group default setweight 10
/lp group vip setweight 20
/lp group premium setweight 30
/lp group moder setweight 80
/lp group admin setweight 100

# Устанавливаем префиксы (формат: /lp group <группа> meta setprefix <приоритет> "<префикс>")
/lp group default meta setprefix 10 "&7Игрок &8| &7"
/lp group vip meta setprefix 20 "&aVIP &8| &a"
/lp group premium meta setprefix 30 "&6PREMIUM &8| &6"
/lp group moder meta setprefix 80 "&9МОДЕР &8| &9"
/lp group admin meta setprefix 100 "&cАДМИН &8| &c"

Совет: для отображения префиксов в чате обязательно установите плагин Vault и современный чат-менеджер, например LPC (LuckPerms Chat) или EssentialsXChat.

5. Выдача прав и проверка работы#

Права в плагинах представляют собой строковые узлы (permission nodes), например essentials.spawn или coreprotect.inspect.

# Выдать право группе
/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.fly false

# Выдать временные права (например, VIP на 30 дней)
/lp user Notch parent addtemp vip 30d

# Проверить, почему у игрока есть или нет конкретное право (дерево резолва)
/lp user Notch permission check essentials.fly

Инструмент /lp verbose позволяет в реальном времени мониторить запросы прав в игре:

# Включить логирование запросов прав для игрока Steve
/lp verbose on Steve
# Выключить мониторинг
/lp verbose off

6. Синхронизация между серверами (MySQL / PostgreSQL)#

Если вы строите сеть из нескольких серверов (Хаб, Выживание, Анархия) через Velocity или BungeeCord, права игроков должны быть едиными.

В файле plugins/LuckPerms/config.yml настройте подключение к общей базе данных:

# Тип хранилища: h2, mariadb, mysql, postgresql
storage-method: MariaDB

data:
  address: 127.0.0.1:3306
  database: luckperms_db
  username: minecraft_user
  password: "StrongPasswordHere"
  pool-settings:
    maximum-pool-size: 10
    minimum-idle: 5
    max-lifetime: 1800000
    connection-timeout: 5000

# Режим синхронизации в реальном времени (NATS / Redis / SQL)
messaging-service: sql

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

7. Резервное копирование и экспорт прав#

Никогда не пренебрегайте сохранением структуры прав перед масштабными обновлениями:

# Экспорт всех прав в один компактный файл
/lp export backup-2026.json.gz

# Восстановление из сохраненного экспорта
/lp import backup-2026.json.gz

LuckPerms — надежный инструмент, на котором держатся крупнейшие проекты. Настроив его один раз по правилам наследования и связав с базой данных, вы избавите себя от 99% проблем с безопасностью и доступом.

📚 Смотрите также в Wiki:

• Установка и обновление плагинов
• Управление правами оператора (команда /op)
• Белый список и доступ к серверу