Triggers

EmakiSkills uses active triggers and passive triggers.

• Active triggers are global slot triggers. Players bind skills to trigger slots in the GUI, then cast them while cast mode is enabled.
• Passive triggers are declared in skill definitions through trigger_type: passive and passive_triggers.

Active triggers

Trigger	Operation
left_click	Left click.
right_click	Right click.
shift_left_click	Shift + left click.
shift_right_click	Shift + right click.
drop_q	Drop key.
hotbar_1 ~ hotbar_9	Number keys 1-9.

Active triggers are configured globally in config.yml under triggers:

triggers:
  right_click:
    display_name: "[Right Click]"
    enabled: true
    incompatible_with:
      - shift_right_click

Passive triggers

id: lifesteal_passive
trigger_type: passive
passive_triggers:
  - attack
cooldown_ticks: 60

Trigger	When it fires
attack	When the player hits an entity.
damaged	When the player takes damage.
damaged_by_entity	When the player is damaged by an entity.
death	When the player dies.
kill_entity	When the player kills a non-player entity.
kill_player	When the player kills another player.
shoot_bow	When the player shoots a bow.
arrow_hit	When an arrow hits an entity.
arrow_land	When an arrow lands without hitting an entity.
shoot_trident	When the player throws a trident.
trident_hit	When a trident hits an entity.
trident_land	When a trident lands.
break_block	When the player breaks a block.
place_block	When the player places a block.
drop_item	When the player drops an item.
shift_drop_item	Shift + drop item.
swap_items	Swap main hand and off hand.
shift_swap_items	Shift + swap hands.
login	Player login.
sneak	Sneak toggle.
teleport	Player teleport.
timer	Periodic trigger.
combo_attack	Combo attack trigger.

consume must be registered in config.yml yourself

The listener dispatches consume for PlayerItemConsumeEvent (eating or drinking), but consume is neither a built-in default trigger nor present in the bundled config.yml > passive_triggers. Unregistered triggers are dropped at dispatch time, so writing passive_triggers: [consume] alone has no effect and raises no error.

To enable it, add a section under config.yml > passive_triggers first:

passive_triggers:
  consume:
    display_name: "[Consume]"
    enabled: true
    incompatible_with: []

Cron passive trigger

When a skill definition sets cron_expression, a passive trigger with the ID cron_<skill id> is registered automatically and added to that skill's passive_triggers; you do not write it by hand. The expression uses the same 6-field Quartz format as spawn_rules. cron_max_executions caps the total number of firings; 0 means unlimited.

Passive trigger settings

passive_trigger_settings:
  timer_interval_ticks: 20
  combo_timeout_ticks: 60

Field	Description
timer_interval_ticks	Check interval for the timer passive trigger.
combo_timeout_ticks	Time before combo state resets.

Cast mode

Active skills require cast mode. By default, the F key toggles cast mode through the server-visible hand-swap action.

cast_mode:
  entry_key: "f"
  restore_last_state_on_join: true