LuckPerms 教程：权限组、等级与命令

安装 LuckPerms 并给自己授权

1. 下载对应版本：前往 luckperms.net——Paper 和 Spigot 使用 Bukkit 版，Fabric、NeoForge 或 Velocity 则使用各自的版本。它需要 Java 11 或更高版本，目前所有服务器都满足。
2. 把 jar 放进 plugins（Fabric 和 NeoForge 放进 mods），删除其他所有权限插件，然后完整重启服务器。
3. 在控制台给自己授权。一开始任何人都不能使用 LuckPerms 命令，包括你自己：

lp user YourName permission set luckperms.* true

之后你就可以在游戏内使用 /lp 了。首次启动时 LuckPerms 会下载一些依赖库，因此服务器需要能访问互联网。

权限组、继承、权重与晋升路线

• 权限节点就是权限的键名，例如 essentials.home 或 minecraft.command.gamemode。每个节点可以是 true、false 或未设置。
• 权限组用来存放权限。每个玩家都在 default 组里；其余的组由你添加。
• 继承：一个组可以有父组，并获得父组的全部权限。如果 admin 继承 mod，mod 又继承 default，那么管理员就拥有这三个组的权限。
• 权重决定两个组冲突时谁生效——数字越大越优先。以 100 为间隔设置，可以为以后新增的组留出空间。
• 晋升路线（track）就是晋升阶梯，例如 default → helper → mod → admin，配合 promote 和 demote 使用。它本身不会改变继承关系。
• 上下文把权限限制在某个服务器或世界，例如在命令末尾加上 world=survival。

一套现成的玩家、协管和管理员配置

创建权限组，把它们串联起来，再给每个组分配所需权限。下面的节点名对应 EssentialsX 命令；请替换成你所用插件的节点。

lp creategroup mod
lp creategroup admin
lp group mod parent add default
lp group admin parent add mod
lp group mod setweight 100
lp group admin setweight 200

lp group default permission set essentials.home true
lp group default permission set essentials.sethome true
lp group default permission set essentials.spawn true
lp group default permission set essentials.tpa true
lp group default permission set essentials.tpaccept true
lp group default permission set essentials.msg true

lp group mod permission set essentials.kick true
lp group mod permission set essentials.mute true
lp group mod permission set essentials.tempban true

lp group admin permission set essentials.* true
lp group admin permission set luckperms.* true

lp user Steve parent add mod

然后创建一条晋升路线：

lp createtrack staff
lp track staff append default
lp track staff append mod
lp track staff append admin

lp user Steve promote staff 会让 Steve 晋升一级。完整的 EssentialsX 命令和节点列表见 EssentialsX 教程。

聊天中的前缀和等级

给一个组设置前缀：

lp group admin meta setprefix "&c[Admin] "

LuckPerms 只负责存储前缀，显示它需要聊天插件。请安装 Vault 以及能从中读取前缀的聊天插件，例如 EssentialsX Chat。如果玩家属于多个组，会使用优先级最高的前缀——用 meta setprefix 100 "..." 设置优先级。

LuckPerms 网页编辑器

要做较大的改动，用编辑器比敲命令更方便。执行 /lp editor，打开它输出的链接，就能在浏览器里编辑组、用户和晋升路线。保存后，编辑器会给出一条命令——在游戏内或控制台执行它，改动就会生效。在执行这条命令之前，服务器上不会有任何变化。

常用的 LuckPerms 命令

不确定某个命令需要哪个节点？执行 /lp verbose record，以该玩家身份使用命令，再执行 /lp verbose upload——报告会列出所有被检查过的权限。

在 HytHost 服务器或群组服上使用 LuckPerms

• 安装：通过文件管理器或 SFTP 把 jar 上传到 plugins，然后在面板中重启。第一条 lp user ... luckperms.* 命令请在 Console 标签页中执行。
• 单个服务器：默认的 H2 存储就够用。
• 群组服：在代理端和每个后端服务器上都安装 LuckPerms，并在 config.yml 中设置 storage-method: mysql，让它们全部连接同一个 MySQL 数据库。每个 HytHost Minecraft 套餐都包含 MySQL 数据库；代理本身的搭建见如何搭建 Velocity 代理。