Developers

Trigger reference

All 34 trigger types, generated from the same catalog the creator uses.

Every trigger the creator offers, with the fields it takes. In a data-only pack these go in a criterion: { "trigger": "inventory_changed", "item": "diamond", "amount": 3 }. In a script plugin, the same objects go in criteria.

Event triggers fire at a moment (a kill, a block mined) and can take count to need several. Checked continuously triggers are true or false at any time (holding an item, standing in a biome).

Items

inventory_changed · Collect items

Checked continuously Have ‹amount› ‹item› in your inventory

FieldTypeMeaning
item requireditem (one or a list)Item. With several items, any of them count towards the amount.
amountint, 1–2304Amount Default 1.

crafted_item · Craft an item

Event Craft ‹item›

Exact with the Beta edition (Beta Features pack). Without it, having the item counts.

FieldTypeMeaning
itemitem (one or a list)Item
blockenum: crafting_table crafter stonecutter_block smithing_table loom cartography_tableAt. Leave empty for anywhere, including the inventory grid. Beta edition only.

consume_item · Eat or drink

Event Eat or drink ‹item›

FieldTypeMeaning
itemitem (one or a list)Food or drink

item_used · Use an item

Event Use ‹item›

FieldTypeMeaning
itemitem (one or a list)Item

item_used_on_block · Use an item on a block

Event Use ‹item› on ‹block›

FieldTypeMeaning
itemitem (one or a list)Item
blockblock (one or a list)Block

equipment · Wear armour

Checked continuously Wear ‹Head›, ‹Chest›, ‹Legs› and ‹Feet›

FieldTypeMeaning
Headitem (one or a list)Head
Chestitem (one or a list)Chest
Legsitem (one or a list)Legs
Feetitem (one or a list)Feet

enchanted_item · Enchant an item

Event Enchant an item at an enchanting table

FieldTypeMeaning
levelsint, 1–3Minimum levels spent

brewed_potion · Brew a potion

Event Take a brewed potion out of a brewing stand

No fields.

smithing_trim · Trim armour

Event Trim armour at a smithing table

FieldTypeMeaning
patterntextTrim pattern. e.g. sentry, wild, coast. Leave empty for any.

fishing_catch · Fish something up

Event Fish up ‹item›

FieldTypeMeaning
itemitem (one or a list)Catch

Blocks

placed_block · Place a block

Event Place ‹block›

FieldTypeMeaning
blockblock (one or a list)Block
adjacentblock (one or a list)Next to. Only counts when placed beside one of these.

broke_block · Mine a block

Event Mine ‹block›

FieldTypeMeaning
blockblock (one or a list)Block
toolitem (one or a list)With tool

construct_beacon · Build a beacon

Checked continuously Build a level ‹level› beacon

FieldTypeMeaning
levelint, 1–4Pyramid level Default 1.

Mobs

player_killed_entity · Kill a mob

Event Kill ‹entity›

FieldTypeMeaning
entityentity (one or a list)Mob. Leave empty for any mob. family:monster matches every hostile mob.
weaponitem (one or a list)Holding
dimensiondimensionIn dimension

entity_killed_player · Be killed

Event Be killed by ‹entity›

FieldTypeMeaning
entityentity (one or a list)Killer. Leave empty for any death.

player_hurt_entity · Hit a mob

Event Hit ‹entity›

FieldTypeMeaning
entityentity (one or a list)Mob. Leave empty for any mob. family:monster matches every hostile mob.
minDamageint, 1+Minimum damage
weaponitem (one or a list)Holding

entity_hurt_player · Get hurt

Event Get hurt by ‹entity›

FieldTypeMeaning
entityentity (one or a list)Attacker. Leave empty for any mob. family:monster matches every hostile mob.
minDamageint, 1+Minimum damage

interacted_with_entity · Use an item on a mob

Event Use ‹item› on ‹entity›

FieldTypeMeaning
entityentity (one or a list)Mob. Leave empty for any mob. family:monster matches every hostile mob.
itemitem (one or a list)Item

projectile_hit_entity · Shoot a mob

Event Hit ‹entity› with ‹projectile›

FieldTypeMeaning
entityentity (one or a list)Mob. Leave empty for any mob. family:monster matches every hostile mob.
projectileentity (one or a list)Projectile. e.g. arrow, snowball, trident

tame_animal · Tame an animal

Event Tame ‹entity›

FieldTypeMeaning
entityentity (one or a list)Animal. Leave empty for any mob. family:monster matches every hostile mob.

bred_animals · Breed animals

Event Breed ‹entity›

FieldTypeMeaning
entityentity (one or a list)Animal. Leave empty for any mob. family:monster matches every hostile mob.

leashed_entity · Leash a mob

Event Put a lead on ‹entity›

FieldTypeMeaning
entityentity (one or a list)Mob. Leave empty for any mob. family:monster matches every hostile mob.

summoned_entity · Build a mob

Event Build ‹entity›

FieldTypeMeaning
entity requiredenum: iron_golem snow_golem copper_golem wither ender_dragonMob

villager_trade · Trade with a villager

Event Trade with a villager or wandering trader

No fields.

World

changed_dimension · Travel to a dimension

Event Travel from ‹from› to ‹to›

FieldTypeMeaning
fromdimensionFrom
todimensionTo

location · Go somewhere

Checked continuously Be in ‹biome›

FieldTypeMeaning
dimensiondimensionDimension
biomebiome (one or a list)Biome
minYint, -64–320At or above Y
maxYint, -64–320At or below Y
standingOnblock (one or a list)Standing on

structure · Find a structure

Checked continuously Enter ‹structure›

The structures BedrockAdvancements' own advancements use are recognised by their blocks in every edition. Every other structure, add-on (custom jigsaw) structures included, is only detected with the Beta edition (Beta Features pack).

FieldTypeMeaning
structure requiredstructureStructure. Those marked "Beta edition only" need the Beta Features pack.

riding · Ride something

Checked continuously Ride ‹vehicle›

FieldTypeMeaning
vehicleentity (one or a list)Ride
passengerentity (one or a list)With passenger
holdingitem (one or a list)Holding. In either hand.

effects_changed · Have effects

Checked continuously Have ‹effects› at once

FieldTypeMeaning
effects requiredeffect (one or a list)Effects. All of them at the same time.

playtime · Play for a while

Checked continuously Play for ‹minutes› minutes

FieldTypeMeaning
minutes requiredint, 1+Minutes

slept_in_bed · Sleep in a bed

Checked continuously Sleep in a bed

No fields.

Commands and map making

tag · Has a tag

Checked continuously Be given the tag ‹tag›

FieldTypeMeaning
tag requiredtextTag. Completes when /tag @p add <tag> runs.

scoreboard · Reach a score

Checked continuously Have a ‹objective› score of ‹min›

FieldTypeMeaning
objective requiredtextObjective
minintAt least
maxintAt most

impossible · Given by command

Checked continuously Be granted it by a command

No fields.