MCMMO-API

## 简介


mcMMO API 专为 mcMMO 插件设计提供完整的 PlaceholderAPI 变量支持，让服务器管理员能够在计分板、TAB列表、GUI菜单、聊天、全息显示等任何支持 PlaceholderAPI 的地方显示玩家的 mcMMO 数据。

## 核心功能


### 数据获取功能

- 个人技能数据: 获取玩家所有13个技能的等级和经验
- 排名系统: 显示玩家在各技能中的服务器排名
- 总等级统计: 计算和显示玩家的总等级(Power Level)
- 经验进度: 显示技能升级进度的百分比和可视化经验条

### 排行榜功能

- 实时排行榜: 获取服务器前10名玩家数据
- 多技能支持: 支持总等级和13个技能的独立排行榜
- 智能缓存: 5分钟缓存机制，平衡性能和实时性
- 性能优化: 可配置是否包含离线玩家数据

### PlaceholderAPI 集成

- 353个变量: 提供完整的变量支持
- 即插即用: 无需额外配置，安装后自动注册
- 兼容性强: 支持所有基于 PlaceholderAPI 的插件
- 实时更新: 数据自动同步，无需手动刷新

## 支持的变量


### 基础变量 (2个)


%mcmmo_powerlevel% - 玩家总等级
%mcmmo_rank_powerlevel% - 总等级排名


### 技能相关变量 (91个)

- 技能等级: 13个技能的等级数据
- 技能经验: 当前经验和升级所需经验
- 技能排名: 各技能的服务器排名
- 技能名称: 本地化的技能显示名称
- 进度显示: 经验百分比和可视化经验条

### 排行榜变量 (260个)

- 总等级排行榜: 前10名玩家的姓名和数值
- 技能排行榜: 13个技能各自的前10名数据
- 双类型支持: 每个排名包含玩家名和数值两种变量
## 基础变量


%mcmmo_powerlevel% - 玩家总等级
%mcmmo_rank_powerlevel% - 总等级排名

## 技能等级变量


%mcmmo_mining% - 挖矿等级
%mcmmo_woodcutting% - 伐木等级
%mcmmo_herbalism% - 草药学等级
%mcmmo_excavation% - 挖掘等级
%mcmmo_fishing% - 钓鱼等级
%mcmmo_archery% - 箭术等级
%mcmmo_swords% - 剑术等级
%mcmmo_axes% - 斧技等级
%mcmmo_acrobatics% - 杂技等级
%mcmmo_repair% - 修理等级
%mcmmo_unarmed% - 格斗等级
%mcmmo_taming% - 驯兽等级
%mcmmo_alchemy% - 炼金等级

## 技能经验变量


%mcmmo_mining_xp% - 挖矿当前经验
%mcmmo_woodcutting_xp% - 伐木当前经验
%mcmmo_herbalism_xp% - 草药学当前经验
%mcmmo_excavation_xp% - 挖掘当前经验
%mcmmo_fishing_xp% - 钓鱼当前经验
%mcmmo_archery_xp% - 箭术当前经验
%mcmmo_swords_xp% - 剑术当前经验
%mcmmo_axes_xp% - 斧技当前经验
%mcmmo_acrobatics_xp% - 杂技当前经验
%mcmmo_repair_xp% - 修理当前经验
%mcmmo_unarmed_xp% - 格斗当前经验
%mcmmo_taming_xp% - 驯兽当前经验
%mcmmo_alchemy_xp% - 炼金当前经验

%mcmmo_mining_xp_to_next% - 挖矿升级所需经验
%mcmmo_woodcutting_xp_to_next% - 伐木升级所需经验
%mcmmo_herbalism_xp_to_next% - 草药学升级所需经验
%mcmmo_excavation_xp_to_next% - 挖掘升级所需经验
%mcmmo_fishing_xp_to_next% - 钓鱼升级所需经验
%mcmmo_archery_xp_to_next% - 箭术升级所需经验
%mcmmo_swords_xp_to_next% - 剑术升级所需经验
%mcmmo_axes_xp_to_next% - 斧技升级所需经验
%mcmmo_acrobatics_xp_to_next% - 杂技升级所需经验
%mcmmo_repair_xp_to_next% - 修理升级所需经验
%mcmmo_unarmed_xp_to_next% - 格斗升级所需经验
%mcmmo_taming_xp_to_next% - 驯兽升级所需经验
%mcmmo_alchemy_xp_to_next% - 炼金升级所需经验

## 技能排名变量


%mcmmo_rank_mining% - 挖矿技能排名
%mcmmo_rank_woodcutting% - 伐木技能排名
%mcmmo_rank_herbalism% - 草药学技能排名
%mcmmo_rank_excavation% - 挖掘技能排名
%mcmmo_rank_fishing% - 钓鱼技能排名
%mcmmo_rank_archery% - 箭术技能排名
%mcmmo_rank_swords% - 剑术技能排名
%mcmmo_rank_axes% - 斧技技能排名
%mcmmo_rank_acrobatics% - 杂技技能排名
%mcmmo_rank_repair% - 修理技能排名
%mcmmo_rank_unarmed% - 格斗技能排名
%mcmmo_rank_taming% - 驯兽技能排名
%mcmmo_rank_alchemy% - 炼金技能排名

## 技能显示名称变量


%mcmmo_mining_name% - 挖矿技能显示名称
%mcmmo_woodcutting_name% - 伐木技能显示名称
%mcmmo_herbalism_name% - 草药学技能显示名称
%mcmmo_excavation_name% - 挖掘技能显示名称
%mcmmo_fishing_name% - 钓鱼技能显示名称
%mcmmo_archery_name% - 箭术技能显示名称
%mcmmo_swords_name% - 剑术技能显示名称
%mcmmo_axes_name% - 斧技技能显示名称
%mcmmo_acrobatics_name% - 杂技技能显示名称
%mcmmo_repair_name% - 修理技能显示名称
%mcmmo_unarmed_name% - 格斗技能显示名称
%mcmmo_taming_name% - 驯兽技能显示名称
%mcmmo_alchemy_name% - 炼金技能显示名称

## 进度显示变量


%mcmmo_progress_mining% - 挖矿经验百分比
%mcmmo_progress_woodcutting% - 伐木经验百分比
%mcmmo_progress_herbalism% - 草药学经验百分比
%mcmmo_progress_excavation% - 挖掘经验百分比
%mcmmo_progress_fishing% - 钓鱼经验百分比
%mcmmo_progress_archery% - 箭术经验百分比
%mcmmo_progress_swords% - 剑术经验百分比
%mcmmo_progress_axes% - 斧技经验百分比
%mcmmo_progress_acrobatics% - 杂技经验百分比
%mcmmo_progress_repair% - 修理经验百分比
%mcmmo_progress_unarmed% - 格斗经验百分比
%mcmmo_progress_taming% - 驯兽经验百分比
%mcmmo_progress_alchemy% - 炼金经验百分比

%mcmmo_bar_mining% - 挖矿经验条
%mcmmo_bar_woodcutting% - 伐木经验条
%mcmmo_bar_herbalism% - 草药学经验条
%mcmmo_bar_excavation% - 挖掘经验条
%mcmmo_bar_fishing% - 钓鱼经验条
%mcmmo_bar_archery% - 箭术经验条
%mcmmo_bar_swords% - 剑术经验条
%mcmmo_bar_axes% - 斧技经验条
%mcmmo_bar_acrobatics% - 杂技经验条
%mcmmo_bar_repair% - 修理经验条
%mcmmo_bar_unarmed% - 格斗经验条
%mcmmo_bar_taming% - 驯兽经验条
%mcmmo_bar_alchemy% - 炼金经验条
## 排行榜变量


### 总等级排行榜


%mcmmo_top_powerlevel_1_name% - 总等级第1名玩家名
%mcmmo_top_powerlevel_1_value% - 总等级第1名数值
%mcmmo_top_powerlevel_2_name% - 总等级第2名玩家名
%mcmmo_top_powerlevel_2_value% - 总等级第2名数值


### 挖矿技能排行榜


%mcmmo_top_mining_1_name% - 挖矿第1名玩家名
%mcmmo_top_mining_1_value% - 挖矿第1名等级
%mcmmo_top_mining_2_name% - 挖矿第2名玩家名
%mcmmo_top_mining_2_value% - 挖矿第2名等级


### 伐木技能排行榜


%mcmmo_top_woodcutting_1_name% - 伐木第1名玩家名
%mcmmo_top_woodcutting_1_value% - 伐木第1名等级
%mcmmo_top_woodcutting_2_name% - 伐木第2名玩家名
%mcmmo_top_woodcutting_2_value% - 伐木第2名等级


### 草药学技能排行榜


%mcmmo_top_herbalism_1_name% - 草药学第1名玩家名
%mcmmo_top_herbalism_1_value% - 草药学第1名等级
%mcmmo_top_herbalism_2_name% - 草药学第2名玩家名
%mcmmo_top_herbalism_2_value% - 草药学第2名等级


### 挖掘技能排行榜


%mcmmo_top_excavation_1_name% - 挖掘第1名玩家名
%mcmmo_top_excavation_1_value% - 挖掘第1名等级
%mcmmo_top_excavation_2_name% - 挖掘第2名玩家名
%mcmmo_top_excavation_2_value% - 挖掘第2名等级


### 钓鱼技能排行榜


%mcmmo_top_fishing_1_name% - 钓鱼第1名玩家名
%mcmmo_top_fishing_1_value% - 钓鱼第1名等级
%mcmmo_top_fishing_2_name% - 钓鱼第2名玩家名
%mcmmo_top_fishing_2_value% - 钓鱼第2名等级


### 箭术技能排行榜


%mcmmo_top_archery_1_name% - 箭术第1名玩家名
%mcmmo_top_archery_1_value% - 箭术第1名等级
%mcmmo_top_archery_2_name% - 箭术第2名玩家名
%mcmmo_top_archery_2_value% - 箭术第2名等级


### 剑术技能排行榜


%mcmmo_top_swords_1_name% - 剑术第1名玩家名
%mcmmo_top_swords_1_value% - 剑术第1名等级
%mcmmo_top_swords_2_name% - 剑术第2名玩家名
%mcmmo_top_swords_2_value% - 剑术第2名等级


### 斧技技能排行榜


%mcmmo_top_axes_1_name% - 斧技第1名玩家名
%mcmmo_top_axes_1_value% - 斧技第1名等级
%mcmmo_top_axes_2_name% - 斧技第2名玩家名
%mcmmo_top_axes_2_value% - 斧技第2名等级


### 杂技技能排行榜


%mcmmo_top_acrobatics_1_name% - 杂技第1名玩家名
%mcmmo_top_acrobatics_1_value% - 杂技第1名等级
%mcmmo_top_acrobatics_2_name% - 杂技第2名玩家名
%mcmmo_top_acrobatics_2_value% - 杂技第2名等级


### 修理技能排行榜


%mcmmo_top_repair_1_name% - 修理第1名玩家名
%mcmmo_top_repair_1_value% - 修理第1名等级
%mcmmo_top_repair_2_name% - 修理第2名玩家名
%mcmmo_top_repair_2_value% - 修理第2名等级


### 格斗技能排行榜


%mcmmo_top_unarmed_1_name% - 格斗第1名玩家名
%mcmmo_top_unarmed_1_value% - 格斗第1名等级
%mcmmo_top_unarmed_2_name% - 格斗第2名玩家名
%mcmmo_top_unarmed_2_value% - 格斗第2名等级


### 驯兽技能排行榜


%mcmmo_top_taming_1_name% - 驯兽第1名玩家名
%mcmmo_top_taming_1_value% - 驯兽第1名等级
%mcmmo_top_taming_2_name% - 驯兽第2名玩家名
%mcmmo_top_taming_2_value% - 驯兽第2名等级


### 炼金技能排行榜


%mcmmo_top_alchemy_1_name% - 炼金第1名玩家名
%mcmmo_top_alchemy_1_value% - 炼金第1名等级
%mcmmo_top_alchemy_2_name% - 炼金第2名玩家名
%mcmmo_top_alchemy_2_value% - 炼金第2名等级
## 安装说明


### 前置插件

1. mcMMO - 必需，提供基础数据
2. PlaceholderAPI - 必需，变量系统支持

### 安装步骤

1. 确保服务器已安装 mcMMO 和 PlaceholderAPI 插件
2. 下载 mcmmopapi.jar 文件
3. 将插件文件放入服务器的 plugins 文件夹
4. 重启服务器或使用 /reload 命令
5. 验证安装：使用 /plugins 查看插件是否正常加载

### 验证安装

/mcmmopapi info # 查看插件信息

/papi list # 确认 mcmmo 扩展已注册


### 基础命令


/mcmmopapi reload # 重载插件配置

/mcmmopapi info [玩家] # 查看玩家信息

/mcmmopapi test [玩家] [变量] # 测试变量解析

/mcmmopapi variables # 显示所有可用变量

/mcmmopapi top <技能> [数量] # 查看排行榜

/mcmmopapi papi # 检查PlaceholderAPI状态



### 权限说明


mcmmopapi.use # 基础使用权限
mcmmopapi.admin # 管理员权限
mcmmopapi.info.self # 查看自己信息
mcmmopapi.info.others # 查看他人信息
mcmmopapi.reload # 重载插件