占位符参考

PlaceholderAPI 占位符

扩展标识符：emakiskills

安装 PlaceholderAPI 后，EmakiSkills 会自动注册以下占位符。

全局占位符

占位符	说明	示例
%emakiskills_cast_mode%	是否处于施法模式。	true
%emakiskills_global_cooldown%	全局冷却剩余秒数（1 位小数）。	1.5
%emakiskills_unlocked_count%	已解锁的技能总数。	8
%emakiskills_slot_count%	玩家技能槽总数。	6
%emakiskills_level_total%	所有技能等级之和。	24

技能占位符

占位符	说明	示例
%emakiskills_level_<skill_id>%	指定技能的等级。	3
%emakiskills_cooldown_<skill_id>%	指定技能的剩余冷却秒数。	12.5

技能槽占位符

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

资源占位符

占位符	说明	示例
%emakiskills_resource_<id>_current%	指定资源的当前值。	85
%emakiskills_resource_<id>_max%	指定资源的最大值。	120
%emakiskills_resource_<id>_percent%	指定资源的百分比。	70

使用示例

lore:
  - '<gray>施法模式: <white>%emakiskills_cast_mode%'
  - '<gray>火球术等级: <white>%emakiskills_level_fireball%'
  - '<gray>冷却: <white>%emakiskills_cooldown_fireball%s'
  - '<gray>法力: <aqua>%emakiskills_resource_mana_current%/%emakiskills_resource_mana_max%'
  - '<gray>槽位1: <white>%emakiskills_slot_0_name% (%emakiskills_slot_0_trigger%)'

动作上下文变量

技能升级动作（SkillUpgradeService）触发时，以下变量会注入到 Action 上下文中：

变量	说明	示例
%skills_skill_id%	技能定义 ID。	fireball
%skills_phase%	升级阶段。	success

动作示例

actions:
  - type: message
    value: '<green>技能 %skills_skill_id% 升级成功！'

说明

• 冷却类占位符会频繁变化，计分板刷新间隔不宜过短。
• 技能槽的 <n> 为槽位索引，从 0 开始。
• 资源占位符中的 <id> 为资源定义 ID（如 mana、stamina）。
• CoreLib 的内置上下文变量（%player_name% 等）在技能动作中同样可用。