1.1.9. 权限插件安装（LuckPerms）
本节介绍 Minecraft 群组服中最常用的权限插件 LuckPerms 的安装、配置、批量导入与管理方法，适用于 Proxy 和各分区服务端。
1.1.9.1. 插件简介
LuckPerms 是当前最流行的权限管理插件，具备以下特点：
快速：高性能、可扩展
可靠：被数千服务器和大型网络信任
易用：支持命令、配置文件、Web 编辑器
灵活：多种数据存储，适配多种服务端
免费：开源、长期维护
1.1.9.2. 关键链接
1.1.9.3. 下载安装
准备数据库 推荐 MariaDB/MySQL，需提前创建好 d_luckperms 数据库。详见 数据库的安装。
下载插件 - Velocity 版（代理端用） - Bukkit/Paper 版（核心端用）
安装到 Proxy（Velocity） .. code-block:: bash
cp /home/mc/softs/LuckPerms-Velocity-5.5.10.jar /home/mc/instances/proxy/plugins/ systemctl restart mc_proxy
修改 /home/mc/instances/proxy/plugins/luckperms/config.yml，设置数据库连接信息（storage-method、address、database、username、password 等）。
server字段确认为proxy
重启 proxy，确认 LuckPerms 启动无报错。
安装到各分区（Paper/Bukkit） .. code-block:: bash
cp /home/mc/softs/LuckPerms-Bukkit-5.5.10.jar /home/mc/instances/login/plugins/ systemctl restart mc_login
复制到其他分区并修改 server 字段（如 dp1、sc1、sc2），保持数据库配置一致。
重启所有分区，确保 LuckPerms 正常加载。
1.1.9.4. 配置文件修改
storage-method: MariaDB
address: 127.0.0.1
database: d_luckperms
username: mc
password: '你的密码'
server: <分区名>
1.1.9.5. 首次授权
LuckPerms 默认无管理权限，需手动授权：
# 进入服务端控制台
lp user <你的ID> permission set luckperms.* true
1.1.9.6. 批量导入权限（推荐）
LuckPerms 支持批量导入分组、权限、meta 信息等，极大提升效率。 详细方法见 批量导入方法1。
简要步骤如下：
将所有 LuckPerms 命令（不带 / 前缀）保存为 txt 文件（如 user_info.txt）。
上传到 /plugins/LuckPerms/imports/ 目录。
控制台或游戏内执行：
` /lp import user_info.txt `LuckPerms 会自动批量执行所有命令。
更多批量命令生成和导入技巧，详见 用户级别规划 章节。
1.1.9.7. 图形化管理与调试
游戏内输入 /lp editor 或 /lpv editor 获取 Web 编辑器链接，浏览器可可视化编辑权限。
使用 /lp tree 查看权限树，辅助查找插件权限节点。
使用 /lp verbose 进行权限调试，定位缺失权限。
1.1.9.8. 常见问题 QA
- Q1:
为什么 LuckPerms 权限没生效？
- A1:
检查数据库配置、分区 server 字段、插件是否加载成功，查看日志排查。
- Q2:
权限批量导入失败？
- A2:
检查命令格式、文件编码、LuckPerms 版本，确保命令无 / 前缀。
- Q3:
Web 编辑器打不开？
- A3:
检查服务器网络，或尝试更换浏览器。
- Q4:
权限分组如何升级？
- A4:
参考 用户级别规划，结合 LuckPerms 的 track/promote 功能实现。
1.1.9.9. 优化建议
定期备份 LuckPerms 配置和数据库，防止误操作导致权限丢失
建议所有分区统一数据库，便于跨服同步权限
利用批量导入和 Web 编辑器大幅提升权限管理效率
备注
权限系统是服务器管理的核心，建议定期备份配置和数据库，防止误操作导致权限