Pterohost docs

LuckPerms: настройка прав, групп и наследования в Minecraft

Полное руководство по LuckPerms 2026: установка JAR, создание групп default/vip/admin, наследование, контексты, MySQL-хранение, веб-редактор и команды /lp.

Кратко: LuckPerms - стандартный плагин прав для Minecraft 2026, поддерживает Paper/Spigot/Folia/Velocity/BungeeCord 1.8.8-1.21.x. Установка: положить JAR в plugins/, запустить, выполнить /lp creategroup default, выдать права через /lp group default permission set true, назначить игрока через /lp user <ник> parent add <группа>. Хранение по умолчанию в H2, для продакшена - MySQL/MariaDB.

LuckPerms: настройка прав, групп и наследования в Minecraft

LuckPerms - современный плагин управления правами на Minecraft-серверах, разработан автором lucko с 2016 года. На 2026-й он установлен на более чем 600 000 серверов по статистике bStats и считается стандартом отрасли. Заменил устаревшие PermissionsEx (заброшен с 2018) и GroupManager (не поддерживает 1.13+).

В этой статье - полная настройка LuckPerms с нуля: установка, создание групп default/vip/moderator/admin, наследование, контексты, перевод на MySQL, веб-редактор и интеграция с EssentialsX и Vault.

Pterohost - игровой хостинг с DDoS-защитой L4+L7, NVMe SSD и 24/7 поддержкой. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Что такое LuckPerms и почему его выбирают

LuckPerms - это плагин-permission-manager, реализующий API Bukkit Permissions с расширениями. Он не работает в одиночку: другие плагины (EssentialsX, WorldGuard, WorldEdit, ChestShop) проверяют пермишены через стандартный API, а LuckPerms говорит, есть ли у игрока такой пермишен.

Ключевые преимущества LuckPerms на 2026:

  • Поддержка всех современных платформ: Paper 1.8.8-1.21.x, Spigot, Folia, Sponge, Velocity, BungeeCord, Fabric, Forge, NeoForge.
  • Высокая производительность: проверка пермишена занимает менее 0.01 мс благодаря кэшу.
  • Гибкое хранение: YAML, JSON, H2, SQLite, MySQL, MariaDB, PostgreSQL, MongoDB.
  • Веб-редактор с drag-and-drop интерфейсом.
  • Контексты (world, server, gamemode), wildcards (essentials.*), временные пермишены, negative-пермишены.
  • Интеграция с Vault и большинством экономических плагинов.
  • Активная разработка: релизы раз в 2-4 недели.

Установка LuckPerms

Скачайте JAR с luckperms.net/download. Для Paper/Spigot/Folia это файл LuckPerms-Bukkit-X.Y.ZZZ.jar. Положите его в plugins/ и перезапустите сервер. После старта появится папка plugins/LuckPerms/ с config.yml и базой luckperms-h2-v2.mv.db.

Проверьте, что плагин загрузился:

[INFO] [LuckPerms] Enabling LuckPerms v5.4.X
[INFO] [LuckPerms] Loading storage provider... [H2]
[INFO] [LuckPerms] Successfully enabled. (took 240ms)

Если выходит ошибка Unable to load configuration, проверьте права на файлы (chown -R minecraft:minecraft plugins/LuckPerms/) и кодировку config.yml (UTF-8 без BOM).

Базовая структура групп: default / vip / moderator / admin

Стандартная иерархия для большинства серверов выглядит так:

ГруппаНазначениеВес (weight)
defaultбазовые права новичка1
vipдонат-уровень 110
premiumдонат-уровень 220
moderatorмодератор чата и игроков50
adminадминистратор сервера100
ownerвладелец, полный доступ1000

Вес (weight) определяет приоритет при конфликте пермишенов: чем выше вес, тем приоритетнее.

Создание иерархии в консоли:

/lp creategroup default
/lp creategroup vip
/lp creategroup moderator
/lp creategroup admin

/lp group default meta setweight 1
/lp group vip meta setweight 10
/lp group moderator meta setweight 50
/lp group admin meta setweight 100

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

Выдача пермишенов группам

Базовые пермишены для default (EssentialsX):

/lp group default permission set essentials.spawn true
/lp group default permission set essentials.help true
/lp group default permission set essentials.list true
/lp group default permission set essentials.msg true
/lp group default permission set essentials.r true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.afk true

Для группы vip добавим возможность установки нескольких home и более коротких кулдаунов:

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

Для moderator - модераторские команды:

/lp group moderator permission set essentials.mute true
/lp group moderator permission set essentials.kick true
/lp group moderator permission set essentials.tempban true
/lp group moderator permission set essentials.vanish true
/lp group moderator permission set essentials.tphere true
/lp group moderator permission set worldguard.region.bypass.* true

Для admin удобно использовать wildcards:

/lp group admin permission set essentials.* true
/lp group admin permission set worldguard.* true
/lp group admin permission set worldedit.* true
/lp group admin permission set luckperms.* true

Wildcards работают только для плагинов, которые регистрируют пермишены с поддержкой звёздочки. EssentialsX, WorldEdit, WorldGuard, LuckPerms - поддерживают. Если плагин не поддерживает, придётся выписывать пермишены поштучно.

Наследование групп (parent)

Наследование означает, что группа автоматически получает все права своего родителя. Команда:

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

Теперь admin имеет все права default + vip + moderator + свои собственные. Это удобнее, чем дублировать пермишены в каждой группе.

Важно: при удалении пермишена у родителя он исчезнет и у потомков. Если нужно отключить пермишен только для потомка, используйте negative-пермишен:

/lp group moderator permission set -essentials.god true

Префикс - означает явный запрет, который перебивает разрешение родителя.

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

После регистрации игрок автоматически попадает в группу default. Чтобы перевести его в другую группу:

/lp user Steve parent set vip

Команда parent set заменяет основную группу. Чтобы добавить вторую группу без удаления первой:

/lp user Steve parent add moderator

У игрока может быть несколько родительских групп. Приоритет определяется через primary-group или вес группы.

Временное членство - игрок получает права на ограниченное время:

/lp user Steve parent addtemp vip 30d
/lp user Steve parent addtemp premium 7d12h

Форматы времени: s (секунды), m, h, d (дни), w (недели), mo (месяцы), y. Удобно для платных тарифов и временных банов.

UUID и offline-mode серверы

LuckPerms идентифицирует игроков по UUID. На лицензионных серверах (online-mode=true) UUID берётся из Mojang API и одинаков на всех серверах. На пиратских (offline) UUID генерируется детерминированно из ника по алгоритму MD5(“OfflinePlayer:” + name).

Если игрок сменит ник на cracked-сервере, его UUID изменится и права пропадут. Решение - использовать AuthMe и привязку аккаунта.

Посмотреть UUID игрока:

/lp user Steve info

В выводе будет строка Unique ID: 069a79f4-44e9-4726-a5be-fca90e38aaf5.

Контексты: разные права в разных мирах

Контексты ограничивают пермишен по условиям. Самый частый случай - разрешить fly только в мире creative или lobby:

/lp user Steve permission set essentials.fly true world=lobby
/lp group vip permission set essentials.fly true world=creative

Поддерживаемые контексты:

  • world=<имя> - конкретный мир.
  • server=<имя> - сервер в сети (для BungeeCord/Velocity).
  • gamemode=<creative|survival|adventure|spectator>.
  • dimension=<overworld|nether|end>.
  • Пользовательские контексты от других плагинов.

В config.yml серверу нужно задать имя для multi-server context:

server: lobby

Хранение в MySQL для продакшена

H2 подходит для домашних серверов. Для продакшена и сетей серверов нужен MySQL или MariaDB. Откройте plugins/LuckPerms/config.yml:

storage-method: mariadb

data:
  address: 127.0.0.1:3306
  database: luckperms
  username: lpuser
  password: 'СильныйПароль2026'

  pool-settings:
    maximum-pool-size: 10
    minimum-idle: 10
    maximum-lifetime: 1800000
    connection-timeout: 5000

  table-prefix: 'luckperms_'

Создайте базу:

CREATE DATABASE luckperms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'lpuser'@'localhost' IDENTIFIED BY 'СильныйПароль2026';
GRANT ALL PRIVILEGES ON luckperms.* TO 'lpuser'@'localhost';
FLUSH PRIVILEGES;

Перенесите существующие данные:

/lp export backup.json.gz
# перенастройте config.yml на mariadb, перезапустите сервер
/lp import backup.json.gz

Для сети серверов (lobby + survival + creative) укажите одинаковые storage-method и data во всех LuckPerms - права будут синхронизированы.

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

Веб-редактор - графический интерфейс для редактирования групп и пермишенов. Вызов:

/lp editor

Требует пермишен luckperms.editor. По умолчанию выдан только OP. Плагин ответит ссылкой вида https://luckperms.net/editor/abc123.... Откройте её в браузере, внесите изменения, нажмите Apply Changes. Сервер автоматически применит правки через WebSocket.

Альтернатива - команда /lp tree показывает структуру пермишенов в чате.

Интеграция с Vault и префиксы в чате

Vault - API-мост между плагинами экономики и прав. Скачайте Vault с SpigotMC, положите в plugins/, перезапустите. LuckPerms автоматически зарегистрируется как permission provider.

Префиксы и суффиксы в чате (требуется EssentialsXChat или DeluxeChat):

/lp group default meta setprefix 1 "&7[Игрок] "
/lp group vip meta setprefix 10 "&a[VIP] "
/lp group moderator meta setprefix 50 "&b[Модератор] "
/lp group admin meta setprefix 100 "&c[Админ] "

Цифра после setprefix - вес префикса (priority), показывается префикс с наибольшим весом.

Цвета по &-кодам: &0-&9, &a-&f (цвета), &l (жирный), &o (курсив), &n (подчёркнутый), &k (обфускация), &r (сброс).

Console-команды и автоматизация

LuckPerms можно вызывать из консоли, скриптов и других плагинов. Префикс перед командой не нужен. Из планировщика (например, при покупке доната):

lp user %player% parent addtemp vip 30d
lp user %player% permission set essentials.fly true world=spawn

Через /lp bulkupdate - массовые операции:

/lp bulkupdate users set permission essentials.tp true where permission == essentials.teleport

Команда /lp sync принудительно синхронизирует кэш с базой, нужна после ручных правок в MySQL.

Типичные проблемы и решения

Игрок не получает права после /lp user parent set vip. Причина - игрок не перелогинился. Команда /lp user <ник> permission info покажет актуальные пермишены сразу.

Пермишен есть, но команда не работает. Проверьте написание пермишена точно как в plugin.yml плагина. Регистр важен. Пример: EssentialsX.spawn != essentials.spawn.

После рестарта права пропали. Если используете YAML/JSON-хранение и несколько серверов писали одновременно - возникает race condition. Переходите на MySQL.

Could not load permissions в логе. Поврежден файл H2. Восстановите из бэкапа plugins/LuckPerms/backups/ или импортируйте через /lp import.

Связанные материалы

Расширьте функционал командами EssentialsX - они тесно интегрируются с LuckPerms. Для приватных регионов на сервере настройте WorldGuard и приваты. Подборка топовых плагинов поможет собрать сервер с нуля.

Заключение

LuckPerms на 2026-й - безальтернативный выбор для управления правами на Minecraft-серверах. Установка занимает 5 минут, базовая настройка 4-х групп (default/vip/moderator/admin) - 15 минут. Веб-редактор и поддержка MySQL делают LuckPerms подходящим как для домашних серверов, так и для больших сетей с десятками тысяч игроков.

Pterohost - игровой хостинг с DDoS-защитой L4+L7, NVMe SSD и 24/7 поддержкой. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг