LuckPerms: команды, права и префиксы

LuckPerms: стандартный плагин прав для серверов Minecraft: группы, наследование, префиксы, временные донат-группы и веб-редактор в браузере. Работает от 1.8.8 до актуальных версий, на Paper, прокси и модовых ядрах, бесплатный и с открытым кодом.

Установка и права для себя

  1. Скачайте jar под своё ядро на luckperms.net/download: для Paper и Spigot версия Bukkit, для прокси отдельные Velocity и BungeeCord.
  2. Положите файл в папку plugins, удалите старый jar LuckPerms, если он был, и полностью перезапустите сервер через stop.
  3. Удалите другие плагины прав (PermissionsEx, GroupManager): LuckPerms должен быть единственным.
  4. В консоли выдайте себе доступ ко всем командам плагина.
lp user <ваш_ник> permission set luckperms.* true

При первом старте плагин скачивает библиотеки. Если хостинг режет исходящие соединения, в логе будет DependencyDownloadException: попросите хостера открыть libraries.luckperms.net и repo1.maven.org или перенесите папку plugins/LuckPerms/libs с сервера, где интернет есть.

Данные лежат в файле luckperms-h2-v2.mv.db, удалять его нельзя. Для сети за BungeeCord или Velocity нужен общий MySQL: одинаковые storage-method: mysql и доступы к базе на всех серверах, плюс messaging-service: sql для синхронизации.

Как выдать права игроку и группе

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

/lp creategroup admin
/lp group admin permission set minecraft.command.ban true
/lp user Steve parent add admin
/lp user Steve permission set essentials.fly true

parent set заменяет все группы игрока одной и меняет основную группу, parent add добавляет группу к имеющимся. Наследование: /lp group admin parent add mod даёт admin все права mod.

Право только в одном мире или на одном сервере сети задаётся контекстом в конце команды:

/lp user Steve permission set minecraft.command.gamemode true server=lobby world=world_nether

Временные группы и права удобны для доната. Длительность пишется как 1mo3d13h45m или unix-время окончания:

/lp user Steve parent addtemp vip 30d
/lp user Steve permission settemp essentials.fly true 3h

Префикс в LuckPerms

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

/lp group admin meta addprefix 100 "&c[Admin] "
/lp group mod meta addprefix 90 "&d[Mod] "
/lp user Steve meta setprefix 200 "&6[Легенда] "

Чтобы заменить префикс группы, сначала удалите старый по приоритету: /lp group admin meta removeprefix 100. Пробел перед закрывающей кавычкой отделяет префикс от ника.

Сам LuckPerms чат не форматирует. На Paper и Spigot для вывода префикса нужны Vault и чат-плагин: EssentialsX Chat, VaultChatFormatter, ChatControl, CarbonChat и другие. Для TAB, скорборда и голограмм есть плейсхолдеры PlaceholderAPI %luckperms_prefix%, %luckperms_suffix%, %luckperms_primary_group_name%. Расширение ставится командами /papi ecloud download LuckPerms и /papi reload.

Веб-редактор luckperms.net/editor

/lp editor присылает ссылку вида luckperms.net/editor/…, где в браузере видны все группы и игроки. Отдельную группу или игрока открывают /lp group <группа> editor и /lp user <ник> editor. Хостить страницу не нужно, работает с любым типом хранения.

Права добавляются с автоподсказкой, а родитель, вес и префикс задаются узлами group.<группа>, weight.<число>, prefix.<приоритет>.<текст>. После правок нажмите Save (Ctrl+S): редактор сгенерирует команду /lp applyedits <код>, её надо выполнить в консоли или в игре. Без выхода сервера в интернет редактор не откроется: данные передаются через сервис bytebin.

Треки: повышение по рангам

/lp createtrack staff
/lp track staff append helper
/lp track staff append mod
/lp track staff append admin
/lp user Steve promote staff
/lp user Steve demote staff

promote переводит игрока на следующую группу трека и снимает предыдущую. Если игрока на треке нет, он попадёт в первую группу.

Почему не работают права или префикс

  • Стоит второй плагин прав. Оставьте только LuckPerms.
  • Неверный узел права. Включите /lp verbose on, выполните действие игроком и посмотрите, какое право проверяется; выключение /lp verbose off.
  • Префикс не виден. Проверьте /lp user <ник> info: если префикс там есть, дело в чат-плагине или отсутствии Vault. С Essentials нужны именно EssentialsX и EssentialsX Chat.
  • Показывается не тот префикс: у префиксов одинаковый приоритет, смотрите /lp user <ник> meta info.
  • На Fabric права не действуют на ванильные команды, это ограничение Fabric, нужен отдельный мод.
  • Сервер выключается после установки: его гасит AuthMe. В config.yml AuthMe поставьте forceVaultHook: true.

Команды и права LuckPerms

КомандаЧто делаетПраво
/lp user <ник> permission set <право> trueвыдать право игрокуluckperms.user.permission.set
/lp user <ник> permission unset <право>снять правоluckperms.user.permission.unset
/lp user <ник> permission settemp <право> true <время>временное правоluckperms.user.permission.settemp
/lp group <группа> permission set <право> trueвыдать право группеluckperms.group.permission.set
/lp user <ник> parent set <группа>оставить игроку одну группуluckperms.user.parent.set
/lp user <ник> parent add <группа>добавить группу к имеющимсяluckperms.user.parent.add
/lp user <ник> parent remove <группа>убрать группуluckperms.user.parent.remove
/lp user <ник> parent addtemp <группа> <время>группа на время, например донат на месяцluckperms.user.parent.addtemp
/lp creategroup <группа> [вес]создать группуluckperms.creategroup
/lp deletegroup <группа>удалить группуluckperms.deletegroup
/lp listgroupsсписок группluckperms.listgroups
/lp group <группа> setweight <вес>вес группыluckperms.group.setweight
/lp group <группа> meta addprefix <приоритет> "<префикс>"префикс группыluckperms.group.meta.addprefix
/lp user <ник> meta setprefix [приоритет] "<префикс>"личный префикс игрокаluckperms.user.meta.setprefix
/lp user <ник> infoгруппы и данные игрокаluckperms.user.info
/lp editorоткрыть веб-редакторluckperms.editor
/lp applyedits <код>применить правки из веб-редактораluckperms.applyedits
/lp user <ник> promote <трек>повысить по трекуluckperms.user.promote
/lp verbose onпоказывать проверки прав в реальном времениluckperms.verbose
/lp syncперечитать данные из хранилищаluckperms.sync

Частые вопросы про LuckPerms

Как выдать права в LuckPerms?
Игроку: /lp user <ник> permission set <право> true. Группе: /lp group <группа> permission set <право> true, затем /lp user <ник> parent add <группа>. Точное имя права смотрите в документации нужного плагина или через /lp verbose on.
Как сделать префикс в LuckPerms?
Для группы: /lp group <группа> meta addprefix 100 "&c[Admin] ", где 100 это приоритет. Чтобы префикс появился в чате, на сервере должны стоять Vault и чат-плагин, например EssentialsX Chat.
Почему префикс LuckPerms не отображается?
LuckPerms не форматирует чат сам. Проверьте /lp user <ник> info: если префикс там виден, поставьте Vault и чат-плагин. Если показывается не тот префикс, выставьте разные приоритеты.
Как открыть LuckPerms editor?
Выполните /lp editor и перейдите по ссылке luckperms.net/editor/… После правок нажмите Save и выполните выданную команду /lp applyedits <код> на сервере.
Как выдать себе все права LuckPerms?
В консоли сервера: lp user <ваш_ник> permission set luckperms.* true. Это даст доступ ко всем командам LuckPerms, но не к правам других плагинов.
Как выдать донат на время?
Командой /lp user <ник> parent addtemp <группа> 30d. Длительность задаётся как 1mo3d13h45m, по истечении срока группа снимется сама.
Где скачать LuckPerms для 1.21?
На официальной странице luckperms.net/download или на Modrinth. Один jar Bukkit подходит для версий от 1.8.8 до актуальных 1.21.x и 26.x.

Не хочется настраивать самому

LuckPerms уже стоит и настроен в готовых сборках Cloud Delight: права, меню, защита и донат собраны в одно целое. Скачали, запустили, играете.