mcMMO API 文档

概述

mcMMO 是一个 Minecraft 技能插件，为开发者提供了 API 接口和 PlaceholderAPI 支持。

核心包名

主要 API 包

1. com.gmail.nossr50.api – 包含公共静态辅助方法
2. com.gmail.nossr50.events – 包含大量 mcMMO 事件
3. com.gmail.nossr50.mcMMO – 插件的主类，包含有用的公共静态 API
4. com.gmail.nossr50.util.player.UserManager – 包含获取玩家 mcMMO 相关状态的公共静态方法

PlaceholderAPI 占位符

技能相关占位符

每个技能都有以下占位符，将 <skillname> 替换为技能名称（例如 "mining"）：

1. %mcmmo_level_% – 技能等级
2. %mcmmo_xp_needed_% – 升级所需经验
3. %mcmmo_xp_% – 当前技能经验
4. %mcmmo_xp_remaining_% – 剩余升级经验
5. %mcmmo_rank_% – 技能排名
6. %mcmmo_xprate_% – 技能经验获取率

支持的技能列表

• Acrobatics (杂技)
• Alchemy (炼金术)
• Archery (箭术)
• Axes (斧头)
• Crossbows (弩)
• Excavation (挖掘)
• Fishing (钓鱼)
• Herbalism (草药学)
• Maces (钉头锤)
• Mining (采矿)
• Repair (修理)
• Swords (剑术)
• Taming (驯服)
• Tridents (三叉戟)
• Unarmed (徒手)
• Woodcutting (伐木)

其他占位符

1. %mcmmo_power_level% – 总力量等级
2. %mcmmo_power_level_cap% – 力量等级上限
3. %mcmmo_in_party% – 是否在队伍中
4. %mcmmo_party_name% – 队伍名称
5. %mcmmo_is_party_leader% – 是否为队伍队长
6. %mcmmo_party_leader% – 队伍队长
7. %mcmmo_party_size% – 队伍大小
8. %mcmmo_is_xp_event_active% – 经验事件是否激活
9. %mcmmo_xprate% – 总经验获取率

API 使用说明

注意事项

1. mcMMO 是一个遗留代码库，如果遇到理解困难，可以在 mcMMO Discord 中提问
2. API 页面仍在建设中，社区可以贡献内容
3. 插件内置了 PlaceholderAPI 支持，无需额外安装

开发建议

1. 使用 com.gmail.nossr50.api 包中的辅助方法
2. 监听 com.gmail.nossr50.events 包中的事件
3. 通过 UserManager 获取玩家状态
4. 使用 mcMMO 主类中的静态方法

示例用法（待补充）

根据文档说明，示例部分仍在建设中，但开发者可以通过上述包名和方法进行开发。

版本信息

• 文档来源：mcMMO Wiki (https://wiki.mcmmo.org/)
• 最后更新：基于当前 wiki 内容
• 状态：部分页面仍在建设中