Placeholder Reference

PlaceholderAPI Placeholders

Expansion identifier: emakiskills

When PlaceholderAPI is installed, EmakiSkills registers the following placeholders.

Global Placeholders

Placeholder	Description	Example
%emakiskills_cast_mode%	Whether the player is in cast mode.	true
%emakiskills_global_cooldown%	Global cooldown remaining (seconds, 1 decimal).	1.5
%emakiskills_unlocked_count%	Total number of unlocked skills.	8
%emakiskills_slot_count%	Total number of skill slots.	6
%emakiskills_level_total%	Sum of all skill levels.	24

Skill Placeholders

Placeholder	Description	Example
%emakiskills_level_<skill_id>%	Level of the specified skill.	3
%emakiskills_cooldown_<skill_id>%	Remaining cooldown in seconds.	12.5

Skill Slot Placeholders

Placeholder	Description	Example
%emakiskills_slot_<n>_skill%	Skill ID bound to slot n.	fireball
%emakiskills_slot_<n>_name%	Display name of skill in slot n.	Fireball
%emakiskills_slot_<n>_trigger%	Trigger ID for slot n.	right_click
%emakiskills_slot_<n>_empty%	Whether slot n is empty.	false

Resource Placeholders

Placeholder	Description	Example
%emakiskills_resource_<id>_current%	Current value of the resource.	85
%emakiskills_resource_<id>_max%	Maximum value of the resource.	120
%emakiskills_resource_<id>_percent%	Resource percentage.	70

Usage Example

lore:
  - '<gray>Cast Mode: <white>%emakiskills_cast_mode%'
  - '<gray>Fireball Level: <white>%emakiskills_level_fireball%'
  - '<gray>Cooldown: <white>%emakiskills_cooldown_fireball%s'
  - '<gray>Mana: <aqua>%emakiskills_resource_mana_current%/%emakiskills_resource_mana_max%'
  - '<gray>Slot 1: <white>%emakiskills_slot_0_name% (%emakiskills_slot_0_trigger%)'

Action Context Variables

When skill upgrade actions (SkillUpgradeService) are triggered, the following variables are injected into the action context:

Variable	Description	Example
%skills_skill_id%	Skill definition ID.	fireball
%skills_phase%	Upgrade phase.	success

Action Example

actions:
  - type: message
    value: '<green>Skill %skills_skill_id% upgraded successfully!'

Notes

• Cooldown placeholders change frequently; avoid overly short scoreboard refresh intervals.
• <n> in slot placeholders is the slot index, starting from 0.
• <id> in resource placeholders is the resource definition ID (e.g., mana, stamina).
• CoreLib built-in context variables (%player_name%, etc.) are also available in skill actions.