如何使用 LuckPerms 管理等级和权限
在您的 Minecraft Paper 服务器上安装 LuckPerms,创建等级,分配权限和前缀,然后检查并备份您的配置。
本页内容
LuckPerms 是一款决定每位玩家在您的服务器上可以做什么的插件。本指南介绍如何安装它、创建等级体系(玩家、VIP、协管员、管理员)、将玩家分配到各等级并检查结果。
前提条件
- 运行 Paper 的服务器,并已按照在 Paper 上安装和更新插件指南配置好
mc-console命令 - 未安装其他权限插件:LuckPerms 必须是唯一的权限插件
- 您的 Minecraft 玩家名,以及至少已连接过一次的玩家
本指南中的 Steve 和 Alex 仅为示例:请替换为真实的玩家名。
基本概念
| 概念 | 含义 |
|---|---|
| 权限 | 以文本形式表示的权利,例如 minecraft.command.ban。其值为 true(授予)或 false(拒绝) |
| 组 | 分配给玩家的一组权限,也就是您的等级 |
| 父组 | 被继承的组。玩家继承其所属的组,组也可以继承另一个组 |
| 权重 | 组在发生冲突时的优先级。数值最大者优先 |
| 上下文 | 权限生效的条件,例如某个特定世界 |
| 轨道(track) | 等级阶梯,用于晋升或降级玩家 |
所有玩家默认属于 default 组,该组在安装后即存在。
安装 LuckPerms
将 Bukkit/Paper 版本下载到 plugins 文件夹:
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
URL=$(curl -fsSL https://metadata.luckperms.net/data/all | jq -r '.downloads.bukkit')
curl -fLO "$URL"
ls -l LuckPerms-*.jar
exit然后重启服务器,并等待出现 Done 这一行:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f按 Ctrl+C 退出日志跟踪,然后确认插件有响应:
sudo mc-console 'lp info'响应中会显示 LuckPerms 的版本和所使用的存储类型。
选择存储方式
默认情况下,LuckPerms 将数据保存在本地 H2 数据库中,即 plugins/LuckPerms/luckperms-h2-v2.mv.db 文件。这适合单台服务器,您无需做任何更改。
如果您更喜欢可读、可编辑的文件,请在 plugins/LuckPerms/config.yml 中设置 storage-method: yaml,然后重启服务器。如果您运行多台共享相同等级的服务器,则需要 MySQL 或 MariaDB 等远程数据库。请现在做出选择:在创建组之前更改会更简单。
为自己授予命令权限
安装刚完成时,没有人能在游戏中使用 /lp,只有控制台可以使用。为自己授予 LuckPerms 的全部权限:
sudo mc-console 'lp user Steve permission set luckperms.* true'之后您可以在游戏中使用 /lp,也可以像本指南后续内容那样继续在控制台中操作。
创建等级
以下是示例的等级体系。权重之间请留出间隔,以便日后插入新等级。
| 组 | 权重 | 继承自 | 角色 |
|---|---|---|---|
default |
1 | 无 | 所有玩家 |
vip |
10 | default |
特权玩家 |
moderator |
50 | vip |
协管 |
admin |
100 | moderator |
管理 |
创建组及其权重:
sudo mc-console 'lp creategroup vip'
sudo mc-console 'lp creategroup moderator'
sudo mc-console 'lp creategroup admin'
sudo mc-console 'lp group default setweight 1'
sudo mc-console 'lp group vip setweight 10'
sudo mc-console 'lp group moderator setweight 50'
sudo mc-console 'lp group admin setweight 100'然后定义继承关系。继承是可传递的:admin 也会获得 vip 和 default 的权限。
sudo mc-console 'lp group vip parent add default'
sudo mc-console 'lp group moderator parent add vip'
sudo mc-console 'lp group admin parent add moderator'分配权限
Minecraft 命令使用 minecraft.command.<命令> 形式的权限。为协管员授予踢出和封禁的权限,并为管理员授予额外权限:
sudo mc-console 'lp group moderator permission set minecraft.command.kick true'
sudo mc-console 'lp group moderator permission set minecraft.command.ban true'
sudo mc-console 'lp group moderator permission set minecraft.command.pardon true'
sudo mc-console 'lp group admin permission set minecraft.command.gamemode true'
sudo mc-console 'lp group admin permission set minecraft.command.whitelist true'要移除权限或明确禁止它:
sudo mc-console 'lp group moderator permission unset minecraft.command.pardon'
sudo mc-console 'lp group vip permission set minecraft.command.kick false'unset 会删除该条目,而 false 会主动拒绝该权限,即使它是从其他地方继承的。这两条命令仅为示例,请仅在确实需要这些更改时执行。
要了解某个插件的权限,请查阅其文档。您也可以观察玩家输入命令时服务器检查了哪些权限:
sudo mc-console 'lp verbose on Steve'让玩家输入该命令,使用 sudo journalctl -u minecraft.service -n 30 --no-pager 查看日志,然后关闭跟踪:
sudo mc-console 'lp verbose off'将玩家分配到等级
# 用此等级替换该玩家的所有组
sudo mc-console 'lp user Steve parent set moderator'
# 添加等级,不移除其他等级
sudo mc-console 'lp user Alex parent add vip'
# 移除等级
sudo mc-console 'lp user Alex parent remove vip'
# 授予等级 30 天
sudo mc-console 'lp user Alex parent addtemp vip 30d'更改立即生效,无需重启。
创建晋升轨道
轨道可让玩家升降一级,而无需记住等级名称。它不会改变继承关系。
sudo mc-console 'lp createtrack staff'
sudo mc-console 'lp track staff append default'
sudo mc-console 'lp track staff append moderator'
sudo mc-console 'lp track staff append admin'
sudo mc-console 'lp user Alex promote staff'
sudo mc-console 'lp user Alex demote staff'添加前缀
前缀显示在玩家名之前。当玩家继承多个前缀时,由其权重决定使用哪一个。&c 之类的代码用于定义颜色:
sudo mc-console 'lp group vip meta setprefix 10 "&6[VIP] "'
sudo mc-console 'lp group moderator meta setprefix 50 "&9[Modo] "'
sudo mc-console 'lp group admin meta setprefix 100 "&c[Admin] "'请保留整条命令外层的单引号和前缀外层的双引号。
将权限限制在某个世界
在命令末尾添加上下文。默认配置下,主世界名为 world:
sudo mc-console 'lp group vip permission set minecraft.command.weather true world=world'要移除它,请指定相同的上下文:
sudo mc-console 'lp group vip permission unset minecraft.command.weather world=world'使用网页编辑器
如果您更喜欢图形界面,LuckPerms 提供了浏览器编辑器:
sudo MC_CONSOLE_WAIT=5 mc-console 'lp editor'打开显示的链接,进行更改后保存。如果编辑器给出需要执行的命令,请在控制台中运行以应用更改。请勿分享此链接:它可用于编辑您的权限。
验证结果
sudo mc-console 'lp listgroups'
sudo mc-console 'lp group moderator info'
sudo mc-console 'lp group moderator listmembers'
sudo mc-console 'lp user Steve info'
sudo mc-console 'lp user Steve permission check minecraft.command.kick'
sudo mc-console 'lp user Steve meta info'您应该能看到四个组、moderator 中的 Steve、值为 true 的 minecraft.command.kick 权限以及 [Modo] 前缀。
然后使用非 OP 账户进行实际测试。OP 已拥有大多数权限,这会掩盖配置错误。如有需要,请移除该身份:
sudo mc-console 'deop Steve'备份权限
以下命令会创建 plugins/LuckPerms/sauvegarde-luckperms.json.gz 文件:
sudo MC_CONSOLE_WAIT=5 mc-console 'lp export sauvegarde-luckperms'要恢复放在 plugins/LuckPerms 中的此文件,请指定其扩展名:
sudo MC_CONSOLE_WAIT=5 mc-console 'lp import sauvegarde-luckperms.json.gz'请定期将此文件复制到服务器之外,因为保存在同一位置的备份会随服务器一同丢失。
更新 LuckPerms
将新版本放入 plugins/update,然后重启。Paper 会在启动时替换旧文件:
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
URL=$(curl -fsSL https://metadata.luckperms.net/data/all | jq -r '.downloads.bukkit')
curl -fLO "$URL"
exit
sudo systemctl restart minecraft.service故障排除
“You do not have permission to use this command!”
您的账户无权使用 /lp。请按前文所述,从控制台为自己授予 luckperms.*。
“A user for Steve could not be found”
玩家名拼写有误,或该玩家从未连接过。请检查拼写,并让其先连接一次。
“A group named vip could not be found”
该组尚不存在。使用 sudo mc-console 'lp listgroups' 查看列表,然后用 lp creategroup 创建。
“Cannot execute command 'lp' in plugin LuckPerms … plugin is disabled”
LuckPerms 未能启动。在日志中查找第一个错误:
sudo journalctl -u minecraft.service --no-pager | grep -i -A5 'luckperms' | grep -iE 'error|exception|caused by' | head -20
df -h /opt/minecraft磁盘已满(No space left on device)或文件夹不属于 minecraft,都会导致插件无法创建文件。对于后一种情况,请运行 sudo chown -R minecraft /opt/minecraft/server,然后重启服务器。
权限不起作用
- 使用
lp user Steve permission check <权限>进行检查 - 使用
sudo mc-console plugins确认未安装其他权限插件 - 使用非 OP 账户测试
- 查看是否有权重更高的组以
false拒绝了该权限 - 使用
lp verbose查看所检查权限的确切名称
前缀未显示在聊天中
首先使用 lp user Steve meta info 确认前缀已保存。如果已保存,则问题出在显示环节:请安装 Vault 和聊天插件。如果两个前缀权重相同,请为它们设置不同的权重。
基岩版玩家无法被识别
使用 Floodgate 时,基岩版玩家名以点号开头,而 LuckPerms 默认拒绝这类名称。操作步骤请参阅使用 Geyser 和 Floodgate 接纳基岩版玩家指南。
如需进一步了解,请查阅 LuckPerms 官方 Wiki。