# Settings

{% hint style="warning" %}
Available on ItemsAdder 3.6.1+
{% endhint %}

## `events_settings`

Special item attribute to customize some properties of events.

### Cooldown

You can set a cooldown which won't allow the player to trigger any of the actions for this item.\
Useful to avoid players to spam a special item.

```yaml
  healing_crystals:
    display_name: display-name-healing_crystals
    permission: healing_crystals
    ## .... item properties
    events_settings:
      cooldown:
        indicator: HUD
        ticks: 120
    events:
    ## .... your events
```

### Cooldown indicator

You can customize the cooldown indicator and decide from some different indicator types:

#### HIDDEN

Won't show any indicator.

```yaml
  healing_crystals:
    display_name: display-name-healing_crystals
    permission: healing_crystals
    ## .... item properties
    events_settings:
      cooldown:
        indicator: HIDDEN
        ticks: 120
    events:
    ## .... your events
```

#### HUD

Shows a custom HUD on-screen.

<figure><img src="https://content.gitbook.com/content/WB6PL7uF5qp9PZUWPeXS/blobs/nqBgPLaj6dLhdxXvo0Ap/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
`custom_hud` property is not mandatory, `_iainternal:small_cooldown_bar` will be used instead if not specified, which is the built-in custom hud.

<mark style="color:red;">⚠️</mark> Make sure you didn't disable `extract_internal_utility_assets` in `config.yml`!
{% endhint %}

```yaml
  healing_crystals:
    display_name: display-name-healing_crystals
    permission: healing_crystals
    ## .... item properties
    events_settings:
      cooldown:
        indicator: HUD
        ticks: 120
        custom_hud: my_items:custom_hud_1
    events:
    ## .... your events
```

{% hint style="info" %}
If you want to create a custom HUD, but you don't want to waste time coloring, you can use [this guide](../../../../other/bulk-colorize-images) to colorize images in one click.
{% endhint %}

#### TITLE

Shows a big on-screen title indicator.

<figure><img src="https://content.gitbook.com/content/WB6PL7uF5qp9PZUWPeXS/blobs/0oUEsY8pQuAT5TBYrJ0s/image.png" alt=""><figcaption></figcaption></figure>

```yaml
  healing_crystals:
    display_name: display-name-healing_crystals
    permission: healing_crystals
    ## .... item properties
    events_settings:
      cooldown:
        indicator: TITLE
        ticks: 120
    events:
    ## .... your events
```

#### BOSSBAR

Shows a bossbar on-screen.

<figure><img src="https://content.gitbook.com/content/WB6PL7uF5qp9PZUWPeXS/blobs/bi1hcW60wj55bpV49pI3/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
`color` and `style` properties are not mandatory, the ones from `config.yml` will be used instead if not specified.
{% endhint %}

```yaml
  healing_crystals:
    display_name: display-name-healing_crystals
    permission: healing_crystals
    ## .... item properties
    events_settings:
      cooldown:
        indicator: BOSSBAR
        ticks: 120
        bossbar:
          color: WHITE
          style: SOLID
    events:
    ## .... your events
```
