Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Appendix E — Advancement Trigger Reference

Every advancement criterion needs a trigger: the event that the game watches for. When the trigger fires and all of the criterion’s conditions pass, that criterion is marked complete. This appendix lists every trigger type the wiki documents for current Java Edition, with a short note on when it fires.

These are the values you put in a criterion’s "trigger" field, like this:

"criteria": {
  "my_criterion": {
    "trigger": "minecraft:consume_item",
    "conditions": {
      "item": { "items": "minecraft:golden_apple" }
    }
  }
}

The trigger decides when the game checks; the conditions decide whether the check passes. Triggers like minecraft:tick and minecraft:location fire constantly, so they are only useful with conditions attached. See Chapter 19 for how to build advancements that detect player events.

The triggers

  • minecraft:allay_drop_item_on_block — Triggers when an allay drops an item on a block.
  • minecraft:any_block_use — Triggers under the same conditions as both minecraft:default_block_use and minecraft:item_used_on_block.
  • minecraft:arbitrary_player_tick — Triggers every tick for one player only.
  • minecraft:avoid_vibration — Triggers when a vibration event is ignored because the source player is crouching.
  • minecraft:bee_nest_destroyed — Triggers when the player breaks a bee nest or beehive.
  • minecraft:bred_animals — Triggers after the player breeds 2 animals.
  • minecraft:brewed_potion — Triggers after the player takes any item out of a brewing stand.
  • minecraft:changed_dimension — Triggers after the player travels between two dimensions.
  • minecraft:channeled_lightning — Triggers after the player successfully uses the Channeling enchantment on an entity or a lightning rod.
  • minecraft:construct_beacon — Triggers after the player changes the structure of a beacon (when the beacon updates itself).
  • minecraft:consume_item — Triggers when the player consumes an item.
  • minecraft:crafter_recipe_crafted — Triggers when the player is ±8 blocks on any axis of a crafter when it crafts a recipe.
  • minecraft:cured_zombie_villager — Triggers when the player cures a zombie villager.
  • minecraft:default_block_use — Triggers when the player activates a block’s default use action (opening a door, pushing a button, opening a crafting grid, etc.).
  • minecraft:effects_changed — Triggers after the player gets a status effect applied or taken from them.
  • minecraft:enchanted_item — Triggers after the player enchants an item through an enchanting table (not through an anvil or commands).
  • minecraft:enter_block — Triggers once for each block the player’s hitbox is inside (up to 12 blocks), twice per tick plus once more for every time the player moves or looks around during the same tick. This can fire tens or even hundreds of times per tick.
  • minecraft:entity_hurt_player — Triggers after a player gets hurt (even when it’s not caused by an entity).
  • minecraft:entity_killed_player — Triggers after a living entity kills a player.
  • minecraft:fall_after_explosion — Triggers when a player lands after being launched upward by an explosion or wind burst.
  • minecraft:fall_from_height — Triggers when a player lands after falling.
  • minecraft:filled_bucket — Triggers after the player fills a bucket.
  • minecraft:fishing_rod_hooked — Triggers after the player successfully catches an item with a fishing rod or pulls an entity with a fishing rod.
  • minecraft:hero_of_the_village — Triggers when a raid ends in victory and the player has attacked at least one raider from that raid.
  • minecraft:impossible — Never triggers.
  • minecraft:inventory_changed — Triggers after any changes happen to the player’s inventory.
  • minecraft:item_delivered_to_player — Triggers when an allay delivers an item to the player.
  • minecraft:item_durability_changed — Triggers after any item in the inventory has been damaged in any form.
  • minecraft:item_used_on_block — Triggers when the player uses their hand or an item on a block (the item must be able to interact with the block).
  • minecraft:kill_mob_near_sculk_catalyst — Triggers after a player is the source of a mob or player being killed within the range of a sculk catalyst.
  • minecraft:killed_by_arrow — Triggers after the player kills a mob or player using an arrow in ranged combat.
  • minecraft:levitation — Triggers when the player has the levitation status effect.
  • minecraft:lightning_strike — Triggers when a lightning bolt disappears from the world, only for players within a 256-block radius of the lightning bolt.
  • minecraft:location — Triggers every 20 ticks (1 second).
  • minecraft:nether_travel — Triggers when the player travels to the Nether and then returns to the Overworld.
  • minecraft:placed_block — Triggers when the player places a block.
  • minecraft:player_damaged — Triggers when the player receives damage.
  • minecraft:player_generates_container_loot — Triggers when the player generates the contents of a container with a loot table set.
  • minecraft:player_hurt_entity — Triggers after the player hurts a mob or player.
  • minecraft:player_interacted_with_entity — Triggers when the player interacts with an entity.
  • minecraft:player_killed_entity — Triggers after a player is the source of a mob or player being killed.
  • minecraft:player_sheared_equipment — Triggers after a player shears equipment off of a mob, such as wolf armor.
  • minecraft:recipe_crafted — Triggers when the player crafts a recipe in a crafting table, stonecutter or smithing table.
  • minecraft:recipe_unlocked — Triggers after the player unlocks a recipe (using a knowledge book, for example).
  • minecraft:ride_entity_in_lava — Triggers when a player mounts an entity walking on lava and while the entity moves with them.
  • minecraft:safely_harvest_honey — Triggers when the player harvests honey from a bee nest/beehive with a campfire below it.
  • minecraft:shot_crossbow — Triggers when the player shoots a crossbow.
  • minecraft:slept_in_bed — Triggers when the player enters a bed.
  • minecraft:slide_down_block — Triggers when the player slides down a block.
  • minecraft:started_riding — Triggers when the player starts riding a vehicle, or an entity starts riding a vehicle currently ridden by the player.
  • minecraft:summoned_entity — Triggers after an entity has been summoned (works with iron golems, snow golems, copper golems, the ender dragon, and the wither; using dispensers, commands, or pistons still activates it).
  • minecraft:tame_animal — Triggers after the player tames an animal.
  • minecraft:target_hit — Triggers when the player shoots a target block.
  • minecraft:thrown_item_picked_up_by_entity — Triggers after the player throws an item and another entity picks it up.
  • minecraft:thrown_item_picked_up_by_player — Triggers when a player picks up an item thrown by another entity.
  • minecraft:tick — Triggers every tick (20 times a second).
  • minecraft:used_ender_eye — Triggers when the player uses an eye of ender (in a world where strongholds generate).
  • minecraft:used_totem — Triggers when the player uses a totem.
  • minecraft:using_item — Triggers for every tick that the player uses an item that is used continuously (bows, crossbows, honey bottles, milk buckets, potions, shields, spyglasses, tridents, food items, eyes of ender, etc.). Single-click items like fishing rods do not affect this trigger.
  • minecraft:villager_trade — Triggers after the player trades with a villager or a wandering trader.
  • minecraft:voluntary_exile — Triggers when the player causes a raid.