Settings

Available on ItemsAdder 3.6.1+

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.

  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.

  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.

custom_hud property is not mandatory, _iainternal:small_cooldown_bar will be used instead if not specified, which is the built-in custom hud.

⚠️ Make sure you didn't disable extract_internal_utility_assets in config.yml!

  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

If you want to create a custom HUD, but you don't want to waste time coloring, you can use this guide to colorize images in one click.

TITLE

Shows a big on-screen title indicator.

  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.

color and style properties are not mandatory, the ones from config.yml will be used instead if not specified.

  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