Skip to content

Skill Action Bar

EmakiSkills can display skill slot state on the player's action bar. The display can include bound skills, trigger names, cooldown state, resource state, and empty slots.

Configuration

Action bar settings are configured in config.yml under actionbar:

yaml
actionbar:
  enabled: true
  refresh_interval_ticks: 10
  template_cast_mode: "<gold>Cast Mode</gold> %slot_1% %slot_2% %slot_3% <gray>Delay:</gray> %forced_delay%"
  template_idle: ""
FieldTypeDescription
enabledbooleanWhether action bar refreshing is enabled. No refresh task is started when disabled.
refresh_interval_ticksintegerRefresh interval in ticks. Values below 1 are treated as 1.
template_cast_modestringTemplate shown while cast mode is enabled. Falls back to a built-in default when blank.
template_idlestringIdle template. Falls back to a built-in default when blank.

The current implementation only pushes the action bar while the player is in cast mode. After leaving cast mode no further refresh happens, so template_idle is never sent to the player.

Template variables

VariableDescription
%slot_display%All slots rendered as one combined string.
%slot_1% ~ %slot_n%A single slot, based on slots.default_count.
%forced_delay%Remaining global forced cast delay.

Display data

The rendered text can combine:

  • Skill display name.
  • Slot index.
  • Trigger display name from triggers.<id>.display_name.
  • Cooldown state.
  • Empty slot state.
  • Cast mode state.

Design notes

  • Keep action bar text short; long lines are hard to read during combat.
  • Use colors consistently for ready, cooldown, and unavailable states.
  • If the display appears stale, check the update interval and whether the player has active skill profile data.