Команды LuckPerms: полный справочник для админа

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

Команды LuckPerms строятся по одной схеме, и как только вы её поймаете, справочник больше не понадобится. Схема такая: /lp плюс объект (user или group), плюс имя, плюс действие. Всё остальное — вариации.

код

/lp [user или group] [имя] [действие] [аргументы]

Ниже — то, чем пользуешься каждую неделю, разбитое по задачам. Полный синтаксис — в официальном справочнике команд LuckPerms. Установка плагина и структура групп разобраны в отдельном разделе.

Как устроены команды LuckPerms

/lp — то же, что /luckperms и /perms. В примерах везде короткая форма.

Все команды работают и из консоли сервера, и из игры (при наличии права luckperms.*). Из консоли безопаснее: не зависит от того, стоит ли у вас OP.

Работа с группами

Создание и удаление:

код

/lp creategroup vip
/lp deletegroup vip
/lp listgroups

Информация о группе:

код

/lp group vip info
/lp group vip permission info
/lp group vip parent info

Наследование:

код

/lp group vip parent add default
/lp group vip parent remove default
/lp group vip parent set premium

parent set очищает всех родителей и ставит одного, parent add добавляет к существующим. На больших структурах set иногда сносит то, о чём вы забыли — привыкайте к add и remove.

Вес и переименование:

код

/lp group vip setweight 10
/lp group vip rename gold
/lp group vip clone silver

clone удобен, когда нужна ещё одна группа с почти теми же правами: клонируете и правите разницу.

Права: выдача и снятие

код

/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.god false
/lp group vip permission unset essentials.fly

Разница между set false и unset принципиальная:

unset — право просто не задано, работает наследование от родителя
set false — явный запрет, который перебивает наследование

Именно set false используют, когда нужно у одной группы отобрать то, что есть у родителя.

Пользователю напрямую:

код

/lp user Nick permission set worldedit.wand true
/lp user Nick permission unset worldedit.wand
/lp user Nick permission info

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

Проверка: почему право не работает

Самая полезная команда во всём плагине:

код

/lp user Nick permission check essentials.fly

Выводит не просто да/нет, а откуда взялось значение: из какой группы, с каким контекстом, с каким приоритетом. Девять из десяти вопросов «почему не работает» закрываются ей за секунду.

Дополнительно:

код

/lp user Nick info
/lp user Nick parent info
/lp verbose on Nick

verbose on включает трассировку: каждая проверка права для игрока будет писаться в чат. Включили, попросили игрока выполнить команду, посмотрели точное имя права, выключили:

код

/lp verbose off
/lp verbose paste

Последняя команда выгружает результат на веб-страницу — удобно, когда проверок много.

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

Постоянно:

код

/lp user Nick parent set vip
/lp user Nick parent add donor
/lp user Nick parent remove vip

Временно (для платных статусов):

код

/lp user Nick parent addtemp vip 30d accumulate
/lp user Nick parent addtemp vip 7d replace
/lp user Nick parent settemp vip 30d

Режимы срока:

Режим	Что делает
`accumulate`	Прибавляет к оставшемуся времени — правильный вариант при продлении подписки
`replace`	Заменяет срок новым
`deny`	Не даёт продлить, если группа уже есть

Снять досрочно:

код

/lp user Nick parent removetemp vip

Связка с автоматической выдачей после оплаты описана в статье про приём платежей.

Временные права

Тот же механизм работает и для отдельных прав:

код

/lp user Nick permission settemp essentials.fly true 1h
/lp group vip permission settemp essentials.kit.event true 2d

Удобно для ивентов: выдали всей группе доступ к варпу арены на выходные, дальше право снимется само. Про сами события есть материал про ивенты на сервере.

Мета: префиксы, суффиксы, значения

код

/lp group vip meta setprefix "&6[VIP] "
/lp group vip meta setsuffix " &7★"
/lp group vip meta removeprefix 100
/lp user Nick meta setprefix 100 "&d[Топ] "

Число перед текстом — приоритет. Если игрок состоит в нескольких группах, показывается префикс с наибольшим приоритетом.

Произвольные значения читают другие плагины:

код

/lp group vip meta set homes 5
/lp group premium meta set homes 10

Дальше плагин домов берёт лимит из меты, и не нужно плодить права вида essentials.sethome.multiple.vip.

Временный префикс — тоже возможен:

код

/lp user Nick meta addtempprefix 200 "&e[Победитель] " 7d

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

Контекст ограничивает действие права условием.

код

/lp group vip permission set essentials.fly true world=lobby
/lp group default permission set worldedit.* false world=survival
/lp user Nick parent add builder server=creative

Типичное применение: полёт разрешён в лобби и на креативе, запрещён в выживании. Или права строителя действуют только на одном сервере сети.

Посмотреть, какие контексты видит плагин:

код

/lp user Nick info

В сети за прокси контекст server= работает, только если LuckPerms стоит и на прокси, и на бэкендах с общей базой — про сборку сети есть материал про BungeeCord и Velocity.

Трек-группы: повышения по лестнице

Трек — это упорядоченная цепочка групп:

код

/lp createtrack donate
/lp track donate append vip
/lp track donate append premium
/lp track donate append deluxe

Дальше игрока двигают по лестнице одной командой:

код

/lp user Nick promote donate
/lp user Nick demote donate

promote переводит на следующую ступень, demote — на предыдущую. Для донат-лестниц и системы рангов персонала это заметно удобнее, чем менять группы вручную.

Веб-редактор и бэкапы

код

/lp editor
/lp editor group
/lp editor user Nick

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

Экспорт и импорт:

код

/lp export backup-2026-09
/lp import backup-2026-09

Файл ложится в plugins/LuckPerms/. Делайте экспорт перед любой крупной переделкой прав — восстановление занимает секунды, а восстановление вручную по памяти не занимает ничего, потому что не получается.

Обслуживание

код

/lp reloadconfig
/lp sync
/lp networksync
/lp info

sync подтягивает изменения из базы, если правки делались снаружи или на другом сервере сети. reloadconfig перечитывает config.yml без рестарта (не относится к смене хранилища — там нужен полный перезапуск).

Очистка данных ушедших игроков:

код

/lp user Nick clear
/lp bulkupdate users delete "permission == essentials.fly"

bulkupdate работает по всей базе сразу и необратим. Перед ним обязательно export.

Частые ошибки в командах

parent add перепутан местами. /lp group vip parent add default означает, что vip наследует default, а не наоборот.
Забытый пробел в префиксе. "&6[VIP]" без пробела склеит скобку с ником.
Кавычки не поставлены. Префикс с пробелами обязательно в двойных кавычках.
Право выдано, но не работает. Проверяйте permission check и снимайте OP — у оператора работает всё, и вы не увидите реальную картину. Про операторов есть отдельный раздел.
Изменения не видны на другом сервере сети. Нужен /lp networksync и общая база MySQL.

Развёрнутый разбор структуры групп с примерами конфигурации — в статье как настроить LuckPerms, а базовые команды для игроков обычно приходят вместе с EssentialsX — его установка описана здесь.

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