AureliumSkills PAPI 变量文档

概述

AureliumSkills 是一款流行的 Minecraft 技能系统插件，目前没有提供直接的 API 接口供其他开发者调用。然而，插件内置了大量 PlaceholderAPI (PAPI) 变量，通过这些变量可以获取几乎所有插件相关的数据。

重要提示：以下所有变量无需额外安装变量扩展，插件加载后会自动注册。

---

变量格式说明

所有变量均以 %aureliumskills_ 开头，方括号 [] 表示需要替换的部分：

• [技能名称] – 替换为具体技能名（如：farming、mining、fighting 等）
• [属性名称] – 替换为具体属性名（如：health、strength、wisdom 等）
• [排名] – 替换为具体排名数字（如：1、2、3 等）

---

变量分类列表

1. 技能等级相关

变量格式	描述	示例
%aureliumskills_power%	综合技能等级（所有技能等级总和）	–
%aureliumskills_[技能名称]%	特定技能等级	%aureliumskills_farming%
%aureliumskills_[技能名称]_roman%	罗马数字格式的技能等级	%aureliumskills_mining_roman%
%aureliumskills_average%	平均技能等级	–
%aureliumskills_average_int%	平均技能等级（取整）	–
%aureliumskills_average_1%	平均技能等级（一位小数）	–

2. 属性值相关

变量格式	描述	示例
%aureliumskills_[属性名称]%	特定属性值	%aureliumskills_health%
%aureliumskills_[属性名称]_int%	特定属性值（取整）	%aureliumskills_strength_int%

3. 生命值与魔力值

变量格式	描述
%aureliumskills_hp%	当前生命值（取整）
%aureliumskills_hp_1%	当前生命值（一位小数）
%aureliumskills_hp_2%	当前生命值（两位小数）
%aureliumskills_hp_max%	最大生命值
%aureliumskills_hp_percent%	剩余生命值百分比
%aureliumskills_mana%	当前魔力值
%aureliumskills_mana_int%	当前魔力值（取整）
%aureliumskills_mana_max%	最大魔力值
%aureliumskills_mana_max_int%	最大魔力值（取整）

4. 排行榜相关

综合排行榜

变量格式	描述
%aureliumskills_lb_power_[排名]%	获取指定排名的玩家名称与综合等级
%aureliumskills_lb_power_[排名]_name%	获取指定排名的玩家名称
%aureliumskills_lb_power_[排名]_value%	获取指定排名的玩家综合等级

技能排行榜

变量格式	描述
%aureliumskills_lb_[技能名称]_[排名]%	获取指定技能排名的玩家名称与等级
%aureliumskills_lb_[技能名称]_[排名]_name%	获取指定技能排名的玩家名称
%aureliumskills_lb_[技能名称]_[排名]_value%	获取指定技能排名的玩家等级

5. 玩家排名相关

变量格式	描述
%aureliumskills_rank%	玩家综合技能等级排名
%aureliumskills_rank_[技能名称]%	玩家指定技能等级排名

6. 经验值相关

变量格式	描述
%aureliumskills_xp_required_formatted_[技能名称]%	升级所需经验值（格式化，如：5k）
%aureliumskills_xp_required_[技能名称]%	升级所需经验值
%aureliumskills_xp_progress_int_[技能名称]%	升级所需经验值（取整）
%aureliumskills_xp_progress_1_[技能名称]%	升级所需经验值（一位小数）
%aureliumskills_xp_progress_[技能名称]%	升级进度百分比
%aureliumskills_xp_int_[技能名称]%	当前技能经验值（取整）
%aureliumskills_xp_formatted_[技能名称]%	当前技能经验值（格式化）
%aureliumskills_xp_[技能名称]%	当前技能经验值

7. 经验倍率相关

变量格式	描述
%aureliumskills_multiplier%	全局经验倍率（两位小数）
%aureliumskills_multiplier_[技能名称]%	指定技能经验倍率（两位小数）
%aureliumskills_multiplier_percent%	全局额外经验百分比（取整）
%aureliumskills_multiplier_percent_[技能名称]%	指定技能额外经验百分比（取整）

---

使用示例

示例 1：显示玩家农耕技能信息

农耕等级: %aureliumskills_farming%
农耕经验: %aureliumskills_xp_formatted_farming% / %aureliumskills_xp_required_formatted_farming%
升级进度: %aureliumskills_xp_progress_farming%%%

示例 2：显示玩家属性

生命值: %aureliumskills_hp%/%aureliumskills_hp_max%
魔力值: %aureliumskills_mana_int%/%aureliumskills_mana_max_int%
力量属性: %aureliumskills_strength%

示例 3：显示排行榜

综合排名第1: %aureliumskills_lb_power_1_name% - Lv.%aureliumskills_lb_power_1_value%
采矿排名第1: %aureliumskills_lb_mining_1_name% - Lv.%aureliumskills_lb_mining_1_value%
我的综合排名: %aureliumskills_rank%

---

注意事项

1. 技能名称参考：

   • 常见技能：farming（农耕）、mining（采矿）、fighting（战斗）、fishing（钓鱼）、excavation（挖掘）、archery（弓箭）、defense（防御）、endurance（耐力）、agility（敏捷）、alchemy（炼金）、enchanting（附魔）、sorcery（巫术）、healing（治疗）、forging（锻造）

2. 属性名称参考：

   • 常见属性：health（生命）、strength（力量）、regeneration（恢复）、luck（幸运）、wisdom（智慧）、toughness（韧性）

3. 变量可用性：

   • 所有变量仅在玩家在线时有效
   • 排行榜变量需要服务器已启用排行榜功能
   • 部分变量可能需要玩家至少有一个技能等级才能正确显示

4. 性能考虑：

   • 排行榜相关变量可能对服务器性能有轻微影响，特别是在玩家数量较多时
   • 建议在需要时使用，避免在所有玩家的记分板上同时显示大量排行榜变量

---

文档来自SnowCutieOwO – wiki