mcMMO 把挖矿、伐木、战斗、钓鱼等核心玩法做成可升级的 RPG 技能：练级解锁子技能，部分技能可触发超能力，并支持队伍经验分享与传送。

• 默认 Retro 模式（0–1000）；可在 config 切换 Standard（0–100）
• 力量等级 = 非子技能等级之和；单技能上限默认 0（不限制）
• 数据：FlatFile 或 MySQL（表前缀 mcmmo_）；区块数据在世界目录 mcmmo_regions
• 公共 API：ExperienceAPI · PartyAPI · AbilityAPI · SkillAPI · ChatAPI · DatabaseAPI
• 服务器可在 General.Locale: zh_CN 启用简中；运行时 /mcmmoreloadlocale 热重载语言

XP 公式（experience.yml + FormulaManager）

• 力量等级 Power Level = 全部非子技能等级之和（分解/冶炼不计入）
• 全局倍率：Experience_Formula.Multiplier.Global（默认 1.0）；PVP 倍率独立
• 默认开启前期加速、战斗 XP 上限（单次伤害 100）；刷怪笼/刷蛋生物 XP 默认 0
• 收益递减 Diminished_Returns 默认关闭；开启后阈值约 20000 XP/10 分钟，最低保留 5%
• 升级里程碑广播默认每 100 级

技能分类（源码 SkillTools）

升级所需经验

累计约：Retro 100 级 ≈ 20.1 万 XP，1000 级 ≈ 1101 万 XP。Retro/Standard 切换不改变总肝度。

倍率链

最终XP = 原始XP × Skill_Multiplier × max(Global, /xprate) × CustomXPPerk(默认1.25)

• /xprate 与 Global 取 max，不叠加
• 等级或力量等级到 Cap → 不再给经验
• Cumulative_Curve 建议保持 false；曲线建议 LINEAR

采集 / 生产 XP 一览

炼药 Alchemy

XP = getPotionXP(阶段) × 瓶数
酿造台 3 瓶，每个成功瓶位各算一次

速刷链：粗制(666) → 效果(1111) → 萤石(1750) → 火药(2250)，三瓶全程约 17331 XP。催化：酿造速度 1→4 倍；混合：8 阶解锁材料层（用 /alchemy 查看）。默认可漏斗自动酿造。

剑术 Swords（子技能数值）

剑术升级 = 用剑亲手打掉怪物血量（见「战斗经验机制」）；子技能增强战斗，不单独产出 XP。

其它技能要点

• 斧技：暴击 1/1；精通每级约 +1 伤；强烈冲击 25/250；破甲每阶约 6.5 耐久
• 弓术：技巧射击每阶约 +10%（有上限）；距离 XP ×0.025
• 格斗：铁臂式 1–20 阶；缴械 25/250；铁腕 60/600；狂暴 5/50 +50% 伤
• 驯兽：利爪 +2；嗜血 ×2；毛皮伤害÷2；爆炸÷6；召唤消耗材料，约 240s
• 杂技：闪避 800 / 翻滚 600 / 坠落 600；羽落靴 ×2；单怪闪避 XP 有限（防刷）
• 超能力时长：2 + min(Cap,等级)/步进，满级约 22s；多数 CD 240s（爆破开采 60s）

单次命中XP = min(本次实际打掉的血量, 100)
          × 怪物倍率 × 10 × 通用倍率链

三条硬规则：

• 按实际扣血算，不是武器面板伤害；超杀不给 XP
• 单次伤害 XP 上限按 100 计（Damage_Limit）
• 每次攻击事件结算一次；剑术利刃突刺等 AoE 不给 XP

怪物倍率（Experience_Values.Combat.Multiplier）

单只收益速算（满血击杀）

伤害类型：什么不算 XP

• 摔落、岩浆、窒息、溺水、营火、仙人掌
• 铁傀儡 / 雪傀儡 / 狼 / 其它生物造成的伤害与击杀
• 药水、中毒、凋灵等效果伤害
• 摔落残血塔：摔到 0.5 血再补刀，XP 掉到约 1/40–1/80
• 玩家自己放置/活塞推移的方块：采集类无经验

各战斗技能 XP 差异

* 持续时间公式：2 + min(上限, 技能等级) ÷ 步进（标准：Cap 100 / 步进 5 → 满级 22 秒；复古：Cap 1000 / 步进 50）。

• 激活：手持对应工具右键就绪；/mcability 可关闭右键就绪
• 冷却后提示「技能冷却完毕!」；查看 /mccooldown
• VIP 权限可延长持续 +4/+8/+12 秒，或减少冷却 1/3、1/2、1/4
• 伐木工失败：「那棵树太大了!」；耐久失败：「你的斧头变成了一堆碎片!」
• 超能力结束后可选刷新区块（General.Refresh_Chunks，默认关）

杂技 Acrobatics

炼金 Alchemy

箭术 Archery

斧技 Axes

挖矿 Mining

草药学 Herbalism

剑术 Swords

格斗 Unarmed

伐木 Woodcutting

钓鱼 Fishing

修理 / 分解 / 冶炼 Repair / Salvage / Smelting

驯兽 / 弩术 / 重锤 / 矛 / 三叉戟 Taming / Crossbows / Maces / Spears / Tridents

生成来源判定（SpawnReason）

按 CreatureSpawnEvent 原因打标记，不是按农场外形：

ExploitFix 与倍率

战斗农场原则

• 必须自然生成（NATURAL），不要用刷怪笼方块
• 怪要满血由玩家亲手击杀；禁止摔落/岩浆/宠物预处理
• 落差 ≤3 格（摔伤 = 落差 − 3）
• 高血量怪分多刀，每刀 ≤100 伤以吃满上限；一击秒 20 血小怪最省事
• 注意世界黑名单与其它插件 NPC 判定

加速开关（调平衡）

默认关闭。开启后死亡按百分比损失技能，击杀可吸取对方技能（吸血）。

mcMMO 不改原版生存主循环，而是在其上叠加技能等级、被动触发、主动超能力、队伍协作与成长目标。

• 技能详情命令如 /mining /swords 可随时查看 XP 与子技能
• 被动几乎不打断操作；主动超能力有冷却，需规划战斗/采集节奏
• 服务器常用 PlaceholderAPI 排行榜、记分板（默认关）展示成长

组队共享经验、聊天、传送与物品分配。Party.Enabled 默认 true；人数上限默认 MaxSize: -1（无限）。

队伍经验分享公式

shareBonus = min(1.1 + 队伍人数 × 1.05, 1.5)
每人获得 XP = 总 XP ÷ 人数 × shareBonus
（仅 EQUAL 模式；分享半径默认 75 格）

队伍等级解锁（config.yml）

传送配置

• /ptp 冷却 120s，预热 5s，受伤后冷却 60s，请求超时 300s
• 需对方接受（Accept_Required）；管理员可 /mcchatspy 监视队伍聊天

自动踢人：默认约 7 天未上线（检查间隔 12 小时）。队伍友伤需双方均拥有 mcmmo.party.friendlyfire。

玩家

各技能详情命令

每个技能都有同名命令，例如 /mining /swords /woodcutting /fishing /alchemy 等，用于查看该技能等级、XP 与子技能。

管理员

• General.RetroMode.Enabled：Retro / Standard 模式
• General.Locale：语言（服务器可改为 zh_CN）
• General.Level_Up_Chat_Broadcasts：升级广播与里程碑间隔
• General.Save_Interval：玩家数据保存间隔（分钟，默认 10）
• General.Power_Level_Cap：力量等级上限（0 表示不限制）
• General.Refresh_Chunks：超级碎石机等结束后刷新区块（性能换正确性）
• coreskills.yml：按技能开关子技能（如 Acrobatics.Roll.Enabled）
• skillranks.yml：子技能解锁等级（Standard 与 RetroMode 分列）
• config.yml 在启动时加载一次，运行时不支持 /reload（可用 mcmmoreloadlocale 重载语言）

skillranks 示例（Standard / Retro）

服务器管理员可在 skillranks.yml 将全部 Rank 调为 0，使子技能开局即全部可用。

经验数值抽样（Experience_Values）

PlaceholderAPI 常用占位符

• 排行榜缓存：PlaceholderAPI 最多跟踪约 100 名；SQL 刷新约 60s
• 侧边栏记分板默认关闭；可配合 /mcscoreboard

• 奇美拉之翼（Chimaera Wing）：飞行/传送类道具；冷却约 240s，预热 5s，受伤后冷却约 60s；地下使用受限（Prevent_Use_Underground: true）；权限 mcmmo.item.chimaerawing
• 焰铸镐 / Flux：与冶炼「祝融之镐」等相关挖矿即熔炼玩法
• 生物血条：Mob_Healthbar 默认开启（如心形，短暂显示）
• MOTD / 升级广播 / 升级音效：可在 config 开关
• 数据存储：FlatFile 或 MySQL（前缀 mcmmo_）；方块记录在 mcmmo_regions/*.mcm
• 兼容：WorldGuard、CombatTag、HealthBar、PlaceholderAPI、ProtocolLib、ViaVersion（软依赖）
• Folia：支持 Folia 线程模型；调度使用 FoliaLib
• Hardcore / Scoreboard / 四月愚人节 等活动与开关：见 config 注释

默认玩家组通常含 mcmmo.commands.defaults、mcmmo.motd、mcmmo.party.all 等。

• 仓库：github.com/mcMMO-Dev/mcMMO · 官方 Wiki：wiki.mcmmo.org
• 构建：mvn clean install（输出 target/mcMMO.jar）
• Maven 坐标：com.gmail.nossr50.mcMMO:mcMMO
• 测试：JUnit 5；SQL 相关需 Docker（Testcontainers）
• 调度须使用 FoliaLib；API 包：ExperienceAPI、PartyAPI、AbilityAPI 等
• 发行渠道：Spigot（spigot.mcmmo.org）· Polymart

1. 各技能冲满（Retro 1000 / Standard 100，部分后期技能更高）
2. 解锁全部子技能 Rank 与 Limit Break
3. 超能力熟练运用：CD 规划 + 采集/战斗爆发窗口
4. Hardcore 服挑战：死亡损失 / 击杀吸级规则下的生存
5. 排行榜：/mctop 与力量等级榜；PAPI 集成到计分板/称号插件
6. 与其它插件联动：公会、经济、地牢（如本服数据包）——mcMMO 提供成长线，数据包提供内容线

避免误写成合成数据包。

mcMMO 不添加合成配方。

插件无合成

工作台

→

—

配置见 experience.yml / config.yml。

对照：钻石长剑

工作台

→

钻石长剑

仅服务器对照。