PlaceholderAPI 占位符

EmakiSkills 提供了一组 PlaceholderAPI 外部占位符，可在计分板、HUD、ActionBar 等任何支持 PAPI 的场景中使用。

前置条件

服务器需安装 PlaceholderAPI 插件。EmakiSkills 会在启动时自动检测并注册，无需手动配置。

标识符

emakiskills

技能等级

占位符	说明	示例返回值
%emakiskills_level_<skill_id>%	玩家某技能的当前等级	3
%emakiskills_unlocked_count%	玩家已解锁的技能总数	5

示例

%emakiskills_level_fireball%        → 3
%emakiskills_level_heal%            → 1
%emakiskills_unlocked_count%        → 5

施法模式

占位符	说明	示例返回值
%emakiskills_cast_mode%	玩家是否处于施法模式	true / false

槽位绑定

槽位索引从 0 开始。

占位符	说明	示例返回值
%emakiskills_slot_<n>_skill%	第 n 个槽位绑定的技能 ID	fireball
%emakiskills_slot_<n>_name%	第 n 个槽位绑定的技能显示名称	火球术
%emakiskills_slot_<n>_trigger%	第 n 个槽位绑定的触发器 ID	left_click
%emakiskills_slot_<n>_empty%	第 n 个槽位是否为空	true / false

示例

%emakiskills_slot_0_skill%          → fireball
%emakiskills_slot_0_name%           → 火球术
%emakiskills_slot_0_trigger%        → left_click
%emakiskills_slot_1_empty%          → true

冷却时间

占位符	说明	示例返回值
%emakiskills_cooldown_<skill_id>%	某技能剩余冷却秒数（0 表示可用）	2.5
%emakiskills_global_cooldown%	公共冷却剩余秒数	0.5

冷却值以秒为单位，保留一位小数。当冷却结束时返回 0。

示例

%emakiskills_cooldown_fireball%     → 2.5
%emakiskills_global_cooldown%       → 0

本地资源

本地资源占位符格式为 %emakiskills_resource_<resource_id>_<field>%。

占位符	说明	示例返回值
%emakiskills_resource_<id>_current%	资源当前值	75.5
%emakiskills_resource_<id>_max%	资源上限	100
%emakiskills_resource_<id>_percent%	资源百分比（0~100）	75.5

示例

%emakiskills_resource_mana_current%     → 75.5
%emakiskills_resource_mana_max%         → 100
%emakiskills_resource_mana_percent%     → 75.5