Block Events

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!"

jukebox_play_event:
  disc: MUSIC_DISC_PIGSTEP
  actions:
    - particle_action:
        particle: NOTE