Cooldowns

Event cooldowns

Cooldowns stop an event from being started again too quickly.

cooldown:
  enabled: true
  duration: 1h

When the event finishes naturally, EventForge starts the cooldown.

While the cooldown is active, the event cannot be started manually, by schedule, by voting, by API, or through compatible addons.

---

Cooldown behaviour

Cooldowns work like this:

natural event finish starts the cooldown
forced stop does not start the cooldown
reload/shutdown does not start the cooldown
manual starts respect cooldowns
scheduled starts respect cooldowns
voting winners respect cooldowns
scheduled voting winners respect cooldowns
API starts respect cooldowns
Skript addon starts respect cooldowns through the API

tip

Use cooldowns for events that should feel special, such as boss fights, relic hunts, supply drops or larger competitions.

---

Cooldown persistence

Cooldowns are saved to:

plugins/EventForge/cooldowns.yml

This means cooldowns can survive restarts.

info

You usually do not need to edit cooldowns.yml manually.

---

Cooldown example

id: relic_hunt
enabled: true
display-name: "&6Relic Hunt"
duration: 5m

cooldown:
  enabled: true
  duration: 1h

schedule:
  enabled: true
  type: INTERVAL
  every: 30m
  announce-before:
    - 1m
    - 30s

In this example, the schedule checks every 30 minutes, but the event cannot start if it is still on cooldown.

---