Skip to main content
Block events trigger when players specifically interact with functional blocks.

​
📦 Event Library

Barrel Open

Triggers when a barrel is opened.

Barrel Close

Triggers when a barrel is closed.

Beacon Power

Triggers when a beacon applies effects.

Cauldron Fill

Triggers when a cauldron is filled.

Cauldron Empty

Triggers when a cauldron is emptied.

Jukebox Play

Triggers when a disc is inserted.

​
⚙️ Configuration

​
barrel_open_event

Triggers when a player opens a barrel.
​
location
Location
Specific barrel location to monitor (optional).

​
barrel_close_event

Triggers when a player closes a barrel.
​
location
Location
Specific barrel location to monitor (optional).

​
beacon_power_event

Triggers when a beacon applies a power effect.
​
effectType
PotionEffectType
The effect being applied (e.g. SPEED, REGENERATION).

​
cauldron_fill_event

Triggers when liquid is added to a cauldron.
​
contentType
CauldronType
Type of liquid: WATER, LAVA, POWDER_SNOW.

​
cauldron_empty_event

Triggers when liquid is removed from a cauldron.
​
contentType
CauldronType
Type of liquid removed.

​
jukebox_play_event

Triggers when a music disc is inserted.
​
disc
Material
The specific music disc material (e.g. MUSIC_DISC_CAT).

​
💻 Examples

cauldron_fill_event:
  contentType: LAVA
  actions:
    - message_action:
        message: "<red>Careful with that hot lava!"