==================================================
技能系统的安装
==================================================
mcMMO 是一个用于 Minecraft 服务器的插件，旨在增强游戏中的角色扮演和多人合作体验。

插件简介
==================================================
- 丰富的技能系统：包含多种技能类型，如挖掘、剑术、弓箭、杂技、格斗、钓鱼、伐木、采矿等。玩家可以通过不断使用这些技能来提高能力，例如提升挖矿速度、增加攻击力等。
- 经验与等级机制：玩家使用特定技能时会获得经验值，达到一定经验值后可升级。技能等级通常无上限，玩家可以不断提升技能水平，从而在游戏中获得优势。
- 掉落物品增强：mcMMO 可以扩展掉落规则，使一些稀有或强大的物品仅在特定条件下掉落，如击败特殊怪物或完成特定任务，这增加了玩家探索和挑战游戏世界的动力。
- 排行榜与成就系统：支持自定义排行榜和成就系统，玩家可以展示自己的实力和成就，增加了游戏的竞争性和社交元素。
- 高度可定制性：服务器管理员可以根据需要自定义 mcMMO 的设置，包括技能增益速度、经验值获取规则、排行榜等内容，让每个安装了 mcMMO 的服务器都独具特色。
- 支持 MySQL 数据库后端，数据可跨服同步
- 支持 PlaceholderAPI、LuckPerms 等插件联动
- 免费开源，长期维护

.. image:: https://wiki.mcmmo.org/images/2/2c/McMMO_Logo.png
   :width: 400px
   :align: center

关键链接
==================================================
- GitHub:  https://github.com/mcMMO-Dev/mcMMO/releases
- Wiki: https://wiki.mcmmo.org/
- 权限参考: https://github.com/mcMMO-Dev/mcMMO/blob/master/src/main/resources/plugin.yml

安装步骤
==================================================
1. 下载 mcMMO.jar，放到所有分区的 plugins 目录
2. 启动服务端，自动生成配置文件
3. 推荐所有分区都安装，保证技能数据同步

.. code-block:: bash

    wget https://github.com/mcMMO-Dev/mcMMO/releases/latest/download/mcMMO.jar
    cp mcMMO.jar /home/mc/instances/dl1/plugins/
    cp mcMMO.jar /home/mc/instances/dp1/plugins/
    cp mcMMO.jar /home/mc/instances/sc1/plugins/
    cp mcMMO.jar /home/mc/instances/sc2/plugins/
    # 重启所有服务端

创建数据库
==================================================
.. code-block:: sql 

    CREATE DATABASE d_mcmmo CHARACTER SET utf8 COLLATE utf8_general_ci;

配置修改
==================================================
- 修改 config.yml，设置数据库类型为 MySQL，并填写数据库连接信息，确保所有分区共用同一数据库，实现技能进度同步。
- 其他参数如技能经验倍率、排行榜等可按需调整。

.. code-block:: diff

    # config.yml 数据库配置差异
    10c10
    <   type: sqlite
    ---
    >   type: mysql
    13,16c13,16
    <   host: "localhost"
    <   port: 3306
    <   database: "mcmmo"
    <   username: "root"
    <   password: ""
    ---
    >   host: "127.0.0.1"
    >   port: 3306
    >   database: "d_mcmmo"
    >   username: "mc"
    >   password: "mc_panda_142857"

权限配置
==================================================
虽然 mcMMO 默认无需特殊权限，建议仍然创建权限组，便于后续扩展和管理。

.. code-block:: bash 

    # 创建 mcMMO 普通权限组
    /lp creategroup g_mcmmo 0 g_mcmmo
    # 将 default 组继承 mcMMO 权限组
    /lp group default parent add g_mcmmo
    # 给 g_mcmmo 组分配基础权限
    /lp group g_mcmmo permission set mcmmo.defaults true


常见问题 QA
==================================================
:Q1: 技能数据不同步？  
:A1: 检查所有分区是否都连接同一个数据库，配置是否一致。

:Q2: 玩家技能无法升级或经验不增加？  
:A2: 检查权限配置，确认已授权 mcmmo.defaults，查看服务端日志。

:Q3: 数据库连接失败？  
:A3: 检查数据库地址、用户名、密码、端口等配置，查看服务端日志。

:Q4: PlaceholderAPI 变量无效？  
:A4: 检查 PlaceholderAPI 是否安装并加载 mcMMO 扩展。