Events.

Every event a rule can wait for, with its filters, its fields, and how often it fires.

Game.

Challenge started
challenge_started · Fires once; has no player; can't be cancelled.
Fires once when the challenge starts.
Timer
timer · Fires now and then; has no player; can't be cancelled.
Fires on the challenge clock, every so often or once after a delay.
Every few ticks
tick · Fires often; has no player; can't be cancelled.
Fires every so many game ticks (20 a second at normal speed): the way to do something continuously.
Command run
command_run · Fires now and then; always has a player; can't be cancelled.
A player runs one of the challenge's commands; filtered to one command, its arguments are fields.
Filters
command
commands
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
command
text. The command's name.
Goal completed
objective_completed · Fires rarely; sometimes has a player; can't be cancelled.
An objective is completed.
Filters
objective
goals
Fields
player
a player. The player who set it off.
objective
text. The objective's text.
Variable changed
variable_changed · Fires now and then; sometimes has a player; can't be cancelled.
A variable changes value.
Filters
variable
variables
Fields
player
a player. The player who set it off.
old
a number. The value before (numbers only).
new
a number. The value after (numbers only).
Signal received
signal_received · Fires now and then; sometimes has a player; can't be cancelled.
A step sends a signal with Send a signal.
Filters
signal
names
Fields
player
a player. The player who set it off.
signal
text. The signal's name.

Blocks.

Block broken
block_broken · Fires often; always has a player; can be cancelled.
A player breaks a block.
Filters
block
kinds of block, tags included
dimension
dimensions
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
block
a block. The block.
block_type
a kind of block. The kind of block.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Block placed
block_placed · Fires often; always has a player; can be cancelled.
A player places a block.
Filters
block
kinds of block, tags included
dimension
dimensions
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
block
a block. The block.
block_type
a kind of block. The kind of block.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Block burned
block_burned · Fires now and then; has no player; can be cancelled.
Fire burns a block away.
Filters
block
kinds of block, tags included
dimension
dimensions
Fields
place
a place. Where it happened.
block
a block. The block.
block_type
a kind of block. The kind of block.
Blocks exploded
block_exploded · Fires rarely; has no player; can be cancelled.
An explosion is about to destroy blocks; once per explosion, with all of them.
Filters
dimension
dimensions
Fields
place
a place. Where it happened.
blocks
blocks. The blocks it would destroy.
count
a number. How many blocks it would destroy.
Block used
block_interacted · Fires now and then; always has a player; can be cancelled.
A player right-clicks a block.
Filters
block
kinds of block, tags included
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
block
a block. The block.
block_type
a kind of block. The kind of block.
item
an item. The item.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.

Combat.

Mob killed
entity_killed · Fires often; sometimes has a player; is about a mob; can't be cancelled.
A mob or other entity dies; the player is whoever killed it, if a player did.
Filters
entity
kinds of mob, tags included
dimension
dimensions
tag
names
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Player hurt
player_damaged · Fires often; always has a player; is about a mob; can be cancelled.
A player takes damage.
Filters
cause
kinds of damage
dimension
dimensions
attacker
kinds of mob, tags included
attacker_tag
names
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
damage
a number. How much damage, in health points (2 is a heart).
health
a number. The player's health before the hit.
cause
text. What hurt them, such as fall or lava.
attacker
an entity. Whatever did it, if something did.
Player died
player_died · Fires rarely; always has a player; can't be cancelled.
A player dies.
Filters
dimension
dimensions
cause
kinds of damage
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
cause
text. What killed them.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Player hit a player
player_attacked_player · Fires now and then; always has a player and a victim; can be cancelled.
A player hits another player.
Fields
player
a player. The player who set it off.
victim
a player. The other player: who was hit or killed.
place
a place. Where it happened.
damage
a number. How much damage, in health points (2 is a heart).
Player hit a mob
player_attacked_entity · Fires often; always has a player; is about a mob; can be cancelled.
A player hits a mob or other entity.
Filters
entity
kinds of mob, tags included
tag
names
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
damage
a number. How much damage, in health points (2 is a heart).
Player killed a player
player_killed_player · Fires rarely; always has a player and a victim; can't be cancelled.
A player kills another player.
Fields
player
a player. The player who set it off.
victim
a player. The other player: who was hit or killed.
place
a place. Where it happened.
Bow shot
bow_shot · Fires now and then; always has a player; can be cancelled.
A player shoots a bow or crossbow.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
force
a number. How far the bow was drawn, 0 to 1.
Projectile thrown
projectile_thrown · Fires now and then; always has a player; is about a mob; can be cancelled.
A player throws or fires a projectile, such as a snowball, pearl, trident or arrow.
Filters
entity
kinds of mob, tags included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
Projectile hit
projectile_hit · Fires now and then; always has a player; is about a mob; can't be cancelled.
A projectile a player fired hits something.
Filters
entity
kinds of mob, tags included
tag
names
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Totem used
totem_used · Fires rarely; always has a player; can't be cancelled.
A totem of undying saves a player.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Mob hurt
mob_damaged · Fires often; sometimes has a player; is about a mob; can be cancelled.
A mob takes damage; the player is whoever hit it, if a player did.
Filters
entity
kinds of mob, tags included
tag
names
cause
kinds of damage
dimension
dimensions
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
damage
a number. How much damage, in health points (2 is a heart).
health
a number. The mob's health before the hit.
cause
text. What hurt it.
attacker
an entity. Whatever did it, if something did.

Mobs.

Mob died
mob_died · Fires now and then; has no player; is about a mob; can't be cancelled.
A mob or other entity dies, whoever or whatever killed it; entity_killed is the player's kills.
Filters
entity
kinds of mob, tags included
dimension
dimensions
tag
names
Fields
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
attacker
an entity. Whatever did it, if something did.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Animals bred
entity_bred · Fires rarely; always has a player; is about a mob; can't be cancelled.
A player breeds two animals.
Filters
entity
kinds of mob, tags included
tag
names
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
Animal tamed
entity_tamed · Fires rarely; always has a player; is about a mob; can't be cancelled.
A player tames an animal.
Filters
entity
kinds of mob, tags included
tag
names
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
Sheared
entity_sheared · Fires rarely; always has a player; is about a mob; can be cancelled.
A player shears a sheep or another animal.
Filters
entity
kinds of mob, tags included
tag
names
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
Mob right-clicked
entity_interacted · Fires now and then; always has a player; is about a mob; can be cancelled.
A player right-clicks a mob.
Filters
entity
kinds of mob, tags included
tag
names
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.

Players.

Player teleported
player_teleported · Fires now and then; always has a player; can be cancelled.
A player is moved somewhere at once: a portal, a command, a challenge's teleport.
Filters
dimension
dimensions
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
from
a place. Where they left.
Player healed
player_healed · Fires often; always has a player; can be cancelled.
A player regains health: regeneration, food, a potion, a totem.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
amount
a number. How many health points, before the cap.
health
a number. The player's health before the heal.
cause
text. What healed them, such as regen, eating or magic.
Changed dimension
player_changed_dimension · Fires rarely; always has a player; can't be cancelled.
A player arrives in another dimension.
Filters
dimension
dimensions
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Player joined
player_joined · Fires rarely; always has a player; can't be cancelled.
A player joins the challenge, or comes into its world from outside it.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Player left
player_left · Fires rarely; always has a player; can't be cancelled.
A player leaves the server.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Player respawned
player_respawned · Fires rarely; always has a player; can't be cancelled.
A player respawns after dying.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Player moved
player_moved_block · Fires often; always has a player; can't be cancelled.
A player moves onto another block.
Filters
dimension
dimensions
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Entered a chunk
player_entered_chunk · Fires now and then; always has a player; can't be cancelled.
A player walks into another chunk.
Filters
dimension
dimensions
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
chunk
a chunk. The chunk they entered.
chunk_x
a number. The chunk's X.
chunk_z
a number. The chunk's Z.
Player jumped
player_jumped · Fires now and then; always has a player; can be cancelled.
A player jumps.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Started sneaking
player_sneaked · Fires now and then; always has a player; can't be cancelled.
A player starts sneaking.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Started sprinting
player_started_sprinting · Fires now and then; always has a player; can't be cancelled.
A player starts sprinting.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Started gliding
player_started_gliding · Fires rarely; always has a player; can't be cancelled.
A player opens their elytra.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Swapped hands
player_swapped_hands · Fires now and then; always has a player; can be cancelled.
A player presses the swap-hands key (F by default).
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Chat message
player_chatted · Fires now and then; always has a player; can't be cancelled.
A player sends a chat message.
Filters
text
words
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
message
text. What they wrote.
Levelled up
player_leveled_up · Fires rarely; always has a player; can't be cancelled.
A player reaches a higher level.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
level
a number. The new level.
Gained experience
player_gained_xp · Fires now and then; always has a player; can't be cancelled.
A player picks up experience.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
amount
a number. How many points.
Got into bed
player_entered_bed · Fires rarely; always has a player; can be cancelled.
A player gets into a bed.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Advancement
advancement_earned · Fires rarely; always has a player; can't be cancelled.
A player earns an advancement.
Filters
advancement
advancements
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
advancement
text. The advancement's title.

Items.

Item crafted
item_crafted · Fires now and then; always has a player; can be cancelled.
A player crafts an item.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
count
a number. How many items.
Item used
item_used · Fires now and then; always has a player; can be cancelled.
A player right-clicks with an item.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
Ate or drank
item_consumed · Fires now and then; always has a player; can be cancelled.
A player eats or drinks something.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
Item dropped
item_dropped · Fires now and then; always has a player; can be cancelled.
A player drops an item.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
count
a number. How many items.
Item picked up
item_picked_up · Fires now and then; always has a player; can be cancelled.
A player picks up an item.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
count
a number. How many items.
Item held
item_held · Fires now and then; always has a player; can be cancelled.
A player switches to another hotbar slot.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
slot
a number. The hotbar slot now held, 0 to 8.
Inventory changed
inventory_changed · Fires often; always has a player; can't be cancelled.
A player's inventory changed in any way: at most once a tick per player.
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
Item smelted
item_smelted · Fires rarely; always has a player; can't be cancelled.
A player takes smelted items out of a furnace.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
count
a number. How many items.
Item enchanted
item_enchanted · Fires rarely; always has a player; can be cancelled.
A player enchants an item at a table.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
levels
a number. The levels it cost.
Tool broke
item_broke · Fires rarely; always has a player; can't be cancelled.
A player's tool, weapon or armour breaks.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
Armour put on
armor_equipped · Fires rarely; always has a player; can't be cancelled.
A player puts on a piece of armour.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
Fish caught
fish_caught · Fires rarely; always has a player; can't be cancelled.
A player catches something with a fishing rod.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
Traded
villager_traded · Fires rarely; always has a player; can't be cancelled.
A player trades with a villager or wandering trader.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
Bucket filled
bucket_filled · Fires rarely; always has a player; can be cancelled.
A player fills a bucket.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.
Bucket emptied
bucket_emptied · Fires rarely; always has a player; can be cancelled.
A player empties a bucket.
Filters
item
items, custom ones included
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
item
an item. The item.

World.

Day starts
day_started · Fires rarely; has no player; can't be cancelled.
The sun rises in the challenge's world.
Night falls
night_started · Fires rarely; has no player; can't be cancelled.
Night falls in the challenge's world.
Weather changed
weather_changed · Fires rarely; has no player; can't be cancelled.
The weather changes.
Filters
weather
clear, rain or thunder
Fields
weather
text. The new weather.
Mob spawned
entity_spawned · Fires often; has no player; is about a mob; can be cancelled.
A mob spawns by itself, not one a challenge spawns.
Filters
entity
kinds of mob, tags included
dimension
dimensions
Fields
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Explosion
entity_exploded · Fires now and then; has no player; is about a mob; can be cancelled.
An entity explodes, such as a creeper or TNT.
Filters
entity
kinds of mob, tags included
dimension
dimensions
tag
names
Fields
place
a place. Where it happened.
mob
a mob. The mob it is about.
mob_type
a kind of mob. The kind of mob.
x
a number. The place's X.
y
a number. The place's Y.
z
a number. The place's Z.
Chunk loaded
chunk_loaded · Fires often; has no player; can't be cancelled.
A chunk of the challenge's world loads, a new one included once it is generated.
Filters
dimension
dimensions
Fields
chunk
a chunk. The chunk.
chunk_x
a number. The chunk's X.
chunk_z
a number. The chunk's Z.
Chunk unloaded
chunk_unloaded · Fires often; has no player; can't be cancelled.
A chunk of the challenge's world unloads.
Filters
dimension
dimensions
Fields
chunk
a chunk. The chunk.
chunk_x
a number. The chunk's X.
chunk_z
a number. The chunk's Z.

Menus.

Menu clicked
menu_clicked · Fires now and then; always has a player; can't be cancelled.
A player clicks a slot of one of the challenge's menus.
Filters
menu
menus
slot
numbers from 0 to 53
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
menu
text. The menu's id.
slot
a number. The slot clicked, 0 up.
item
an item. The item.
Menu closed
menu_closed · Fires now and then; always has a player; can't be cancelled.
A player closes one of the challenge's menus.
Filters
menu
menus
Fields
player
a player. The player who set it off.
place
a place. Where it happened.
menu
text. The menu's id.

Docs Getting started Examples

Events.

Game.

Challenge started

Timer

Every few ticks

Command run

Goal completed

Variable changed

Signal received

Blocks.

Block broken

Block placed

Block burned

Blocks exploded

Block used

Combat.

Mob killed

Player hurt

Player died

Player hit a player

Player hit a mob

Player killed a player

Bow shot

Projectile thrown

Projectile hit

Totem used

Mob hurt

Mobs.

Mob died

Animals bred

Animal tamed

Sheared

Mob right-clicked

Players.

Player teleported

Player healed

Changed dimension

Player joined

Player left

Player respawned

Player moved

Entered a chunk

Player jumped

Started sneaking

Started sprinting

Started gliding

Swapped hands

Chat message

Levelled up

Gained experience

Got into bed

Advancement

Items.

Item crafted

Item used

Ate or drank

Item dropped

Item picked up

Item held

Inventory changed

Item smelted

Item enchanted

Tool broke

Armour put on

Fish caught

Traded

Bucket filled

Bucket emptied

World.

Day starts

Night falls

Weather changed

Mob spawned

Explosion

Chunk loaded

Chunk unloaded

Menus.

Menu clicked

Menu closed