==================================================
权限插件安装（LuckPerms）
==================================================

本节介绍 Minecraft 群组服中最常用的权限插件 LuckPerms 的安装、配置、批量导入与管理方法，适用于 Proxy 和各分区服务端。

插件简介
==================================================
LuckPerms 是当前最流行的权限管理插件，具备以下特点：

- 快速：高性能、可扩展
- 可靠：被数千服务器和大型网络信任
- 易用：支持命令、配置文件、Web 编辑器
- 灵活：多种数据存储，适配多种服务端
- 免费：开源、长期维护

.. image:: ./imgs/图形化编辑权限.jpg
   :width: 600px
   :align: center

关键链接
==================================================
- 官网与文档：https://luckperms.net/wiki/Home
- 下载页面：https://luckperms.net/download
- Web 编辑器：https://luckperms.net/editor
- 权限命令参考：https://luckperms.net/wiki/Permission-Commands

下载安装
==================================================
1. **准备数据库**  
   推荐 MariaDB/MySQL，需提前创建好 `d_luckperms` 数据库。详见 :ref:`数据库的安装`。

2. **下载插件**  
   - Velocity 版（代理端用）
   - Bukkit/Paper 版（核心端用）

3. **安装到 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 启动无报错。

4. **安装到各分区（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 正常加载。

配置文件修改
==================================================
- `storage-method: MariaDB`
- `address: 127.0.0.1`
- `database: d_luckperms`
- `username: mc`
- `password: '你的密码'`
- `server: <分区名>`


首次授权
==================================================
LuckPerms 默认无管理权限，需手动授权：

.. code-block:: bash

    # 进入服务端控制台
    lp user <你的ID> permission set luckperms.* true

批量导入权限（推荐）
==================================================
LuckPerms 支持批量导入分组、权限、meta 信息等，极大提升效率。  
详细方法见 :ref:`批量导入权限`。

简要步骤如下：

1. 将所有 LuckPerms 命令（不带 `/` 前缀）保存为 txt 文件（如 `user_info.txt`）。
2. 上传到 `/plugins/LuckPerms/imports/` 目录。
3. 控制台或游戏内执行：
   ```
   /lp import user_info.txt
   ```
4. LuckPerms 会自动批量执行所有命令。

更多批量命令生成和导入技巧，详见 :ref:`用户级别规划` 章节。

图形化管理与调试
==================================================
- 游戏内输入 `/lp editor` 或 `/lpv editor` 获取 Web 编辑器链接，浏览器可可视化编辑权限。
- 使用 `/lp tree` 查看权限树，辅助查找插件权限节点。
- 使用 `/lp verbose` 进行权限调试，定位缺失权限。

.. image:: ./imgs/页面设置权限.jpg
.. image:: ./imgs/图形权限.jpg

常见问题 QA
==================================================
:Q1:  为什么 LuckPerms 权限没生效？  
:A1:  检查数据库配置、分区 server 字段、插件是否加载成功，查看日志排查。

:Q2:  权限批量导入失败？  
:A2:  检查命令格式、文件编码、LuckPerms 版本，确保命令无 `/` 前缀。

:Q3:  Web 编辑器打不开？  
:A3:  检查服务器网络，或尝试更换浏览器。

:Q4:  权限分组如何升级？  
:A4:  参考 :ref:`用户级别规划`，结合 LuckPerms 的 track/promote 功能实现。

优化建议
==================================================
- 定期备份 LuckPerms 配置和数据库，防止误操作导致权限丢失
- 建议所有分区统一数据库，便于跨服同步权限
- 利用批量导入和 Web 编辑器大幅提升权限管理效率

.. note::
   权限系统是服务器管理的核心，建议定期备份配置和数据库，防止误操作导致权限