Triggers
All 74. The filters column is which filter keys the trigger can honour; a config using another key gets a warning.
Blocks
| trigger |
when |
filters |
mine_block |
A block is broken |
blocks, worlds, biomes, held |
place_block |
A block is placed |
blocks, worlds, biomes, held |
mine_ore |
An ore block is broken |
blocks, worlds, biomes, held |
harvest_crop |
A fully grown crop is broken |
blocks, worlds, biomes, held |
chop_log |
A log is broken |
blocks, worlds, biomes, held |
interact_block |
A block is right-clicked |
blocks, worlds, held |
ignite_block |
A block is set on fire by the player |
blocks, worlds |
shear_block |
A block is sheared (pumpkin, beehive) |
blocks, worlds |
Combat
| trigger |
when |
filters |
melee_attack |
The player hits something in melee |
entities, worlds, held, victim_conditions |
ranged_attack |
The player hits something with a projectile |
entities, worlds, held, victim_conditions |
any_attack |
The player damages anything by any means |
entities, worlds, held, victim_conditions |
take_damage |
The player takes damage from anything |
causes, worlds |
take_entity_damage |
The player is hurt by an entity |
entities, causes, worlds, victim_conditions |
block_attack |
The player blocks a hit with a shield |
entities, worlds |
kill_mob |
The player kills a non-player entity |
entities, worlds, held |
kill_player |
The player kills another player |
worlds, held |
kill_boss |
The player kills a boss (dragon, wither, warden, elder guardian) |
entities, worlds |
kill_any |
The player kills anything |
entities, worlds, held |
die |
The player dies |
causes, worlds |
respawn |
The player respawns |
worlds |
shoot_bow |
The player fires a bow or crossbow |
held, worlds |
throw_projectile |
The player throws or launches any projectile |
projectiles, worlds |
projectile_hit |
A projectile the player launched lands |
projectiles, blocks, entities, worlds |
item_damage |
A held item loses durability |
items, worlds |
Movement
| trigger |
when |
filters |
move |
The player moves to a new block |
worlds, biomes |
jump |
The player jumps |
worlds |
sneak |
The player starts sneaking |
worlds |
unsneak |
The player stops sneaking |
worlds |
sprint |
The player starts sprinting |
worlds |
fall |
The player takes fall damage |
worlds |
swim |
The player starts swimming |
worlds |
fly |
The player starts flying (elytra or creative) |
worlds |
teleport |
The player is teleported |
worlds, causes |
change_world |
The player changes world |
worlds |
enter_vehicle |
The player mounts a vehicle |
entities, worlds |
exit_vehicle |
The player dismounts |
entities, worlds |
enter_bed |
The player lies down |
worlds |
enter_portal |
A portal is used |
worlds |
Items and inventory
| trigger |
when |
filters |
craft |
The player crafts an item |
items, worlds |
smelt |
The player takes a smelted item from a furnace |
items, worlds |
enchant |
The player enchants at a table |
items, worlds |
brew |
A brewing stand the player used finishes |
worlds |
consume |
The player eats or drinks |
items, worlds |
pickup_item |
The player picks up an item |
items, worlds |
drop_item |
The player drops an item |
items, worlds |
swap_hands |
The player swaps hands |
held, worlds |
change_held |
The player changes hotbar slot |
held, worlds |
break_item |
A held item breaks |
items, worlds |
open_inventory |
The player opens an inventory |
inventories, worlds |
close_inventory |
The player closes an inventory |
inventories, worlds |
trade |
The player completes a villager trade |
items, worlds |
Entities
| trigger |
when |
filters |
breed |
The player breeds two animals |
entities, worlds |
tame |
The player tames an animal |
entities, worlds |
shear |
The player shears an entity |
entities, worlds |
milk |
The player milks a cow |
worlds |
fish_catch |
The player catches something |
items, worlds |
fish_cast |
The player casts a rod |
worlds |
interact_entity |
The player right-clicks an entity |
entities, worlds, held |
leash |
The player leashes an entity |
entities, worlds |
Progression and state
| trigger |
when |
filters |
gain_xp |
The player gains experience |
worlds |
level_up |
The player's XP level rises |
worlds |
advancement |
The player earns an advancement |
advancements, worlds |
chat |
The player sends a chat message |
worlds |
command |
The player runs a command |
commands, worlds |
join |
The player joins the server |
- |
quit |
The player leaves the server |
- |
toggle_flight |
The player toggles flight |
worlds |
gamemode |
The player's gamemode changes |
worlds |
potion_applied |
A potion effect is applied to the player |
effects, worlds |
potion_expired |
A potion effect on the player ends |
effects, worlds |
regain_health |
The player regains health |
worlds |
hunger_change |
The player's food level changes |
worlds |
time_tick |
Every second while the player is online (use with conditions) |
worlds |
permanent |
Always on while conditions hold (no trigger needed) |
- |
Custom triggers
Any plugin can add one and fire it:
JobsAPI.registerTrigger(new Trigger("vote", "The player votes", "worlds"));
JobsAPI.fire(new Context("vote", player).value(1));
Every job listening for vote runs. Server owners' own plugins get the same
API through Ember Jobs Premium.