==================================================
登录基础插件的安装
==================================================
登录插件用于解决玩家身份认证问题，支持正版与离线用户共存，是群组服安全的第一道防线。

插件对比
==================================================
.. csv-table:: Minecraft认证插件对比
   :header: "插件名称", "经典程度", "免费", "GUI界面", "配置灵活性", "代理支持", "多平台兼容", "备注"
   :widths: 15, 10, 8, 10, 12, 12, 12, 21

   "AuthMe Reloaded (5.X)", "高", "是", "否", "高", "否", "是", "老牌经典，功能全面，社区支持完善"
   "xAuth", "中", "是", "否", "中", "否", "是", "轻量级，适合小型服务器"
   "CrazyLogin", "中", "是", "否", "中", "否", "是", "支持IP登录记忆，降低重复登录"
   "LoginSecurity", "中", "是", "否", "中", "否", "是", "侧重安全功能，如2FA、IP绑定"
   "AdvancedLogin (Paid)", "中", "否", "是", "高", "否", "是", "商业插件，功能丰富，GUI界面友好"
   "UltraAuth", "中", "是", "否", "中", "否", "是", "支持多种认证方式，配置较简单"
   "BungeeAuth", "低", "是", "否", "中", "是", "否", "专为BungeeCord/Waterfall设计的代理端插件"
   "AuthMeVelocity", "低", "是", "否", "中", "是", "否", "Velocity代理服务器的AuthMe分支"
   "PremiumAuth", "中", "是", "否", "低", "否", "是", "针对正版用户的轻量级认证"
   "SecureLogin", "低", "是", "否", "中", "否", "是", "支持会话记忆和多因素认证"
   "LoginX", "低", "是", "否", "中", "否", "是", "功能全面，配置简单"

推荐选择项
==================================================
- **AuthMe Reloaded**：功能最全，社区活跃，兼容性好，适合绝大多数生存/群组服。
- 其他插件可根据特殊需求选用，如 BungeeAuth（代理端专用）、AdvancedLogin（需GUI/付费）。

AuthMe Reloaded 简介
==================================================
AuthMe Reloaded 是 Minecraft 最主流的离线/混合认证插件，支持多种数据库、二次验证、反机器人、IP绑定、邮件找回等功能，兼容绝大多数服务端和插件。

- spigotmc: https://www.spigotmc.org/resources/authmereloaded.6269/
- github: https://github.com/AuthMe/AuthMeReloaded
- 官方文档: https://github.com/AuthMe/AuthMeReloaded/wiki

安装步骤
==================================================
1. 创建数据库（推荐 MariaDB/MySQL）  
   .. code-block:: sql
      create database d_authme CHARACTER SET utf8 COLLATE utf8_general_ci;

2. 下载 AuthMe Reloaded jar 包，放到所有分区 plugins 目录  
   .. code-block:: bash
      wget https://github.com/AuthMe/AuthMeReloaded/releases/download/5.6.0/AuthMe-5.6.0.jar
      cp AuthMe-5.6.0.jar /home/mc/instances/dl1/plugins/
      cp AuthMe-5.6.0.jar /home/mc/instances/dp1/plugins/
      cp AuthMe-5.6.0.jar /home/mc/instances/sc1/plugins/
      cp AuthMe-5.6.0.jar /home/mc/instances/sc2/plugins/

3. 重启所有分区服务端  
   .. code-block:: bash
      systemctl restart mc_dl1 mc_dp1 mc_sc1 mc_sc2

配置说明
==================================================
- 修改 `/home/mc/instances/login/plugins/AuthMe/config.yml`，推荐使用 MariaDB 后端，设置数据库连接信息、语言、欢迎消息等。
- 关键配置项 diff 示例（仅展示部分）：

.. code-block:: diff
    4c4
    <     backend: MARIADB
    ---
    >     backend: SQLITE
    13c13
    <     mySQLUseSSL: false
    ---
    >     mySQLUseSSL: true
    22c22
    <     mySQLUsername: mc
    ---
    >     mySQLUsername: authme
    24c24
    <     mySQLPassword: 'mc_panda_142857'
    ---
    >     mySQLPassword: '12345'
    26c26
    <     mySQLDatabase: d_authme
    ---
    >     mySQLDatabase: authme
    70c70
    <     poolSize: 100
    ---
    >     poolSize: 10
    107c107
    <         enabled: true
    ---
    >         enabled: false
    110c110
    <         timeout: 1800
    ---
    >         timeout: 10
    113c113
    <     messagesLanguage: zhcn
    ---
    >     messagesLanguage: en
    304c304
    <     useWelcomeMessage: false
    ---
    >     useWelcomeMessage: true

- 配置完成后，复制到其他分区并重启服务端。

权限配置
==================================================
.. code-block:: bash
    # 创建一个g_authme的权限组
    /lp creategroup g_authme 0 g_authme
    # 添加权限
    /lp group g_authme permission set authme.player.* true 
    # 让default用户组继承这个用户组的权限
    /lp group default parent add g_authme

常见问题 QA
==================================================
:Q1: 登录插件安装后无法注册/登录？  
:A1: 检查数据库连接、配置文件、服务端日志，确认 AuthMe 已正常加载。

:Q2: 注册/登录提示无权限？  
:A2: 检查 LuckPerms 权限配置，确保 default 组已继承 g_authme 权限组。

:Q3: 多分区需要都安装吗？  
:A3: 推荐所有分区都安装 AuthMe，保证认证一致性和安全性。

:Q4: 如何启用二次验证/邮件找回？  
:A4: 参考官方文档，配置相关功能项并测试。