Event Schedules

Per-event schedules

Per-event schedules are configured inside each event file.

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

This starts the event every 30 minutes and announces it before it begins.

---

Disable a per-event schedule

If you want an event to be started manually only, disable its schedule.

schedule:
  enabled: false

The event can still be started by command, API, manual voting, scheduled voting or compatible addons.

---

Interval schedules

Interval schedules repeat every configured amount of time.

schedule:
  enabled: true
  type: INTERVAL
  every: 1h

Supported time examples:

30s
5m
1h
2d

---

Announce before start

Use announce-before to warn players before an event begins.

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

This is useful for larger events where players need time to prepare.

---

Manual queue events from schedules

If a scheduled event uses manual participation, EventForge opens its queue instead of starting the event instantly.

participation:
  mode: MANUAL
  queue-duration: 30s
  min-players: 2

Scheduled flow:

schedule triggers
→ EventForge checks cooldowns and conditions
→ manual queue opens
→ players join with /events join <event>
→ event starts if enough players joined

This keeps scheduled events compatible with the v1.0.3 hype phase system.

---