> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Block Events

> React to block interactions like barrels, beacons, and cauldrons.

Block events trigger when players specifically interact with functional blocks.

## Event Library

<CardGroup cols={2}>
  <Card title="Barrel Open" icon="box-open" href="#barrel-open-event">
    Triggers when a barrel is opened.
  </Card>

  <Card title="Barrel Close" icon="box" href="#barrel-close-event">
    Triggers when a barrel is closed.
  </Card>

  <Card title="Beacon Power" icon="tower-broadcast" href="#beacon-power-event">
    Triggers when a beacon applies effects.
  </Card>

  <Card title="Cauldron Fill" icon="water" href="#cauldron-fill-event">
    Triggers when a cauldron is filled.
  </Card>

  <Card title="Cauldron Empty" icon="bucket" href="#cauldron-empty-event">
    Triggers when a cauldron is emptied.
  </Card>

  <Card title="Jukebox Play" icon="compact-disc" href="#jukebox-play-event">
    Triggers when a disc is inserted.
  </Card>
</CardGroup>

## Configuration

### `barrel_open_event`

Triggers when a player opens a barrel.

<ResponseField name="location" type="Location">
  Specific barrel location to monitor (optional).
</ResponseField>

### `barrel_close_event`

Triggers when a player closes a barrel.

<ResponseField name="location" type="Location">
  Specific barrel location to monitor (optional).
</ResponseField>

### `beacon_power_event`

Triggers when a beacon applies a power effect.

<ResponseField name="effectType" type="PotionEffectType">
  The effect being applied (e.g. `SPEED`, `REGENERATION`).
</ResponseField>

### `cauldron_fill_event`

Triggers when liquid is added to a cauldron.

<ResponseField name="contentType" type="CauldronType">
  Type of liquid: `WATER`, `LAVA`, `POWDER_SNOW`.
</ResponseField>

### `cauldron_empty_event`

Triggers when liquid is removed from a cauldron.

<ResponseField name="contentType" type="CauldronType">
  Type of liquid removed.
</ResponseField>

### `jukebox_play_event`

Triggers when a music disc is inserted.

<ResponseField name="disc" type="Material">
  The specific music disc material (e.g. `MUSIC_DISC_CAT`).
</ResponseField>

## Examples

<CodeGroup>
  ```yaml Cauldron Fill theme={null}
  cauldron_fill_event:
    contentType: LAVA
    actions:
      - message_action:
          message: "<red>Careful with that hot lava!"
  ```

  ```yaml Jukebox theme={null}
  jukebox_play_event:
    disc: MUSIC_DISC_PIGSTEP
    actions:
      - particle_action:
          particle: NOTE
  ```
</CodeGroup>