LuckPerms 安装 Paper生存服配置权限组

一、安装 LuckPerms

1. 下载
   从 LuckPerms 官网 或 SpigotMC 下载适合你服务器版本的 LuckPerms 插件（Bukkit/Paper 版本）。

2. 安装
   将下载的 .jar 文件放入服务器的 plugins 文件夹。

3. 重启服务器
   执行 stop 命令关闭服务器，然后重新启动，让 LuckPerms 生成配置文件。

4. 初次配置（可选）
   编辑 plugins/LuckPerms/config.yml，可以调整存储方式（默认使用 H2 本地数据库），一般保持默认即可。如果服务器有多个后端，可以配置 MySQL 等，但单服务器用默认 H2 足够。

---

二、创建权限组

使用 LuckPerms 的命令行接口（需拥有 luckperms.* 权限或处于控制台）创建四个基本组：

bash

/lp creategroup default
/lp creategroup member
/lp creategroup builder
/lp creategroup admin

注意： 组名区分大小写，建议全小写。

---

三、配置权限组

1. 默认组（default）—— 所有新玩家自动拥有

bash

# 基础 Minecraft 指令（建议只给必要指令，避免滥用）
/lp group default permission set minecraft.command.me true
/lp group default permission set minecraft.command.msg true
/lp group default permission set minecraft.command.tell true
/lp group default permission set minecraft.command.help true# EssentialsX 基础生存指令
/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.tpdeny true
/lp group default permission set essentials.sethome true          # 允许设置一个家
/lp group default permission set essentials.delhome true
/lp group default permission set essentials.home true
/lp group default permission set essentials.list true
/lp group default permission set essentials.motd true
/lp group default permission set essentials.rules true
/lp group default permission set essentials.pay true              # 转账（如果有经济）
/lp group default permission set essentials.balance true
/lp group default permission set essentials.balancetop true# 领地插件 GriefPrevention 基础权限
/lp group default permission set griefprevention.claim true        # 创建领地
/lp group default permission set griefprevention.claiminfo true    # 查看领地信息
/lp group default permission set griefprevention.trust true        # 信任他人
/lp group default permission set griefprevention.untrust true
/lp group default permission set griefprevention.basicclaims true# 核心查熊插件 CoreProtect 的查询权限（只允许查看，不能回滚）
/lp group default permission set coreprotect.inspect true          # /co inspect
/lp group default permission set coreprotect.lookup true           # /co lookup
/lp group default permission set coreprotect.page true             # /co page# 箱子商店 ChestShop 权限（如果需要）
/lp group default permission set chestshop.shop true
/lp group default permission set chestshop.buy true
/lp group default permission set chestshop.sell true# 通用插件权限（如 Vault、PlaceholderAPI 等通常不需要显式设置）

2. 会员组（member）—— 活跃老玩家

bash

# 首先继承 default 组的所有权限
/lp group member parent add default# 增加更多家数量
/lp group member permission set essentials.sethome.multiple 5      # 允许设置5个家
/lp group member permission set essentials.home.multiple 5         # 允许使用5个家
/lp group member permission set essentials.delhome.multiple 5# 传送便利
/lp group member permission set essentials.back true               # 返回死亡点
/lp group member permission set essentials.tpahere true            # 请求他人传送到自己
/lp group member permission set essentials.warp true               # 使用公共传送点
/lp group member permission set essentials.warps true# 经济商店增强
/lp group member permission set essentials.sell true               # 直接出售手中物品（如果配置了）
/lp group member permission set essentials.shop true               # 打开服务器商店# 聊天相关（如果有聊天插件如 VentureChat 或 Essentials 的聊天）
/lp group member permission set essentials.chat.color true         # 允许聊天彩色
/lp group member permission set essentials.msg.color true

3. 建筑师组（builder）—— 协助建筑、美化

bash

# 继承 member 组
/lp group builder parent add member# WorldEdit 权限（仅限特定世界，需配合 Multiverse 等，或在权限插件中按世界设置）
# 注意：WorldEdit 权限默认是 all 或特定节点，这里仅给基础常用节点
/lp group builder permission set worldedit.* true                   # 谨慎，最好按需分配# 或者只给常用命令（推荐）：
/lp group builder permission set worldedit.wand true                # 获取木斧
/lp group builder permission set worldedit.selection.pos true
/lp group builder permission set worldedit.set true                 # //set
/lp group builder permission set worldedit.replace true             # //replace
/lp group builder permission set worldedit.copy true
/lp group builder permission set worldedit.paste true
/lp group builder permission set worldedit.undo true
/lp group builder permission set worldedit.redo true
/lp group builder permission set worldedit.cyl true
/lp group builder permission set worldedit.hcyl true
/lp group builder permission set worldedit.sphere true# 飞行权限（仅限特定世界，如建筑世界）
/lp group builder permission set essentials.fly true                # 允许飞行
# 但为了公平，可以在生存世界禁用飞行，需要按世界设置（见后文高级设置）# 游戏模式切换（仅在建筑世界允许创造模式，可通过按世界权限实现）
/lp group builder permission set essentials.gamemode true           # 谨慎，若不想让他们随意切换可分开设置
# 或者更精确： essentials.gamemode.creative, essentials.gamemode.survival 等

4. 管理员组（admin）—— 服务器管理员

bash

# 继承所有权限，但一般不推荐继承 builder，因为 builder 有 WorldEdit 可能冲突，建议直接给全部权限
/lp group admin permission set * true                               # 给予所有权限（超级管理员）# 或者按需分配（推荐精确控制）：
/lp group admin permission set luckperms.* true                     # 管理权限插件自身
/lp group admin permission set essentials.* true                    # 所有 Essentials 命令
/lp group admin permission set griefprevention.* true               # 所有领地管理命令
/lp group admin permission set coreprotect.* true                   # 所有查熊命令（包括回滚）
/lp group admin permission set worldedit.* true                     # 创世神
/lp group admin permission set minecraft.command.* true             # 所有原版命令
# 等等

---

四、设置组继承关系

继承关系已经通过上面的 parent add 命令设置好了。检查继承关系可以使用：

bash

/lp group member parents
/lp group builder parents

如果想移除继承，使用 parent remove。

---

五、设置默认组

所有新玩家进入服务器时，应自动归入 default 组。LuckPerms 默认有一个 default 组，如果你自己创建了同名的，需要设置为默认：

bash

/lp group default setdefault true

检查默认组：

bash

/lp group default info

---

六、将玩家添加到组

将已有玩家添加到会员组：

bash

/lp user <玩家名> parent add member

添加建筑师组（通常需要手动审核）：

bash

/lp user <玩家名> parent add builder

添加管理员组：

bash

/lp user <玩家名> parent add admin

查看玩家的权限和组：

bash

/lp user <玩家名> info

---

七、设置组的前缀/后缀（用于聊天显示）

使用 LuckPerms 的上下文（Context）配合聊天插件（如 Essentials 的聊天格式或 PlaceholderAPI）来显示组前缀。

设置前缀：

bash

/lp group default meta set prefix "&7[游客] &f"
/lp group member meta set prefix "&a[会员] &f"
/lp group builder meta set prefix "&b[建筑师] &f"
/lp group admin meta set prefix "&c[管理员] &f"

说明：

• &7 是灰色，&a 绿色，&b 青色，&c 红色。

• 如果使用 Essentials 的聊天格式，需要在 config.yml 中启用 luckperms 元数据变量。具体格式：{LUCKPERMS_PREFIX}。

• 也可以配合 PlaceholderAPI 使用 %luckperms_prefix%。

设置后缀（例如显示称号）：

bash

/lp group member meta set suffix " &6[老玩家]"

---

八、高级设置

1. 按世界分配权限

有些权限（如飞行、WorldEdit）可能只允许在特定世界使用，例如建筑师只能在资源世界使用 WorldEdit，在生存主世界不能。可以用 world=<世界名> 上下文。

示例：在生存世界禁止 builder 飞行：

bash

/lp group builder permission set essentials.fly false world=生存世界名

同样，可以给 WorldEdit 只在建筑世界有效：

bash

/lp group builder permission set worldedit.* true world=建筑世界名

2. 设置组权重（用于聊天排序）

权重值越高，在 Tab 列表或聊天中越靠前。

bash

/lp group default setweight 0
/lp group member setweight 10
/lp group builder setweight 20
/lp group admin setweight 100

3. 临时权限或临时组

例如给玩家 7 天的会员体验：

bash

/lp user <玩家名> parent add temp member 7d

4. 配置权限文件的批量导入

如果你有很多权限要设置，可以编写一个 YAML 文件，然后使用 /lp import 导入。详细格式参考 LuckPerms 维基。

---

九、常见插件权限节点参考

EssentialsX 常用节点

• essentials.home – 回家

• essentials.sethome – 设家

• essentials.sethome.multiple.<数量> – 多人家数量

• essentials.tpa – 请求传送

• essentials.tpaccept – 接受传送

• essentials.back – 返回死亡点

• essentials.warp – 使用传送点

• essentials.fly – 飞行

• essentials.gamemode – 切换游戏模式（通常只给管理员）

• essentials.eco – 经济管理（只给管理员）

• essentials.kit – 领取礼包

GriefPrevention 常用节点

• griefprevention.claim – 创建领地

• griefprevention.claiminfo – 查看领地信息

• griefprevention.trust – 信任他人

• griefprevention.untrust – 取消信任

• griefprevention.bypassclaims – 绕过领地保护（只给管理员）

• griefprevention.deleteclaims – 删除领地（管理员）

CoreProtect 常用节点

• coreprotect.inspect – 检查方块记录

• coreprotect.lookup – 查询玩家记录

• coreprotect.rollback – 回滚操作（只给管理员）

• coreprotect.restore – 恢复操作（管理员）

WorldEdit 常用节点

• worldedit.wand – 获取木斧

• worldedit.selection – 选区相关

• worldedit.clipboard – 复制粘贴

• worldedit.region – 区域操作（set, replace 等）

• worldedit.undo – 撤销

• worldedit.scripting – 使用脚本（危险，限制）

LuckPerms 自身节点

• luckperms.* – 所有 LuckPerms 管理权限

• luckperms.user.info – 查看玩家权限信息（可给会员查看自己权限）

• luckperms.user.promote – 晋升玩家（可给管理员）

---

十、注意事项与最佳实践

1. 权限测试
   设置完成后，用普通玩家账号登录测试，确保功能正常，权限不过度。可以使用 /lp user <玩家名> permission check <节点> 检查某个权限是否生效。

2. 日志记录
   安装 CoreProtect 或类似的日志插件，记录所有 OP 操作和重要命令，方便追责。

3. 定期备份
   LuckPerms 的数据文件位于 plugins/LuckPerms/，定期备份以防数据丢失。

4. 避免使用通配符
   给普通玩家组（如 default）不要使用 * 权限，否则可能开放过多危险命令。

5. 权限分组不要过于复杂
   对于小型公益服，三个组（default, member, admin）通常就够。builder 组可酌情添加。

6. 明确规则
   在服务器介绍中明确各组权限的获取方式（如会员需要在线时长、建筑师需要申请审核），避免争议。

7. 利用临时权限做活动
   节日期间可以给全体玩家临时飞行或更多家数量，增加趣味。