> For the complete documentation index, see [llms.txt](https://btarg.gitbook.io/origami-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://btarg.gitbook.io/origami-docs/events.md).

# Events

The "events" section of a block or item's YAML allows you to execute Minecraft commands when certain interactions are performed.

{% hint style="info" %}
Both blocks and items use some events by the same name, with them behaving differently depending on the context: for example, `onBroken` is used for both when a block is broken and for when an item breaks as a result of running out of durability.
{% endhint %}

```yaml
# "events" is formatted as a list of event objects:
events:
  - onRightClick: # <-- event name
      commands:
        - say block right clicked!
      cooldown: 20 # <-- cooldown in ticks
  - onBroken:
      commands:
      # this is a list of Minecraft commands, with or without the slash
        - say block broken!
        - say goodbye world!
      # adding a cooldown is optional
```

## List of event names

1. `onRightClick`:
   * **Function:** Triggered when a block or item is right-clicked.
2. `onLeftClick`:
   * **Function:** Triggered when a block or item is left-clicked.
3. `onRightClickAir`:
   * **Function:** Triggered when an item is right-clicked while looking at air.
4. `onLeftClickAir`:
   * **Function:** Triggered when an item or block is left-clicked while looking at air.
5. `onRightClickBlock`:
   * **Function:** Triggered when the player is looking at a block and a right-click is performed.
6. `onLeftClickBlock`:
   * **Function:** Triggered when the player is looking at a block and a left-click is performed.
7. `onPlaced`:
   * **Function:** Triggered when a block is placed.
8. `onBroken`:
   * **Function:** Triggered when a block or item is broken.
9. `onDamaged`:
   * **Function:** Triggered when an item or block is damaged.
10. `onPushed`:
    * **Function:** Triggered when a block is pushed by a piston.