Skip to content

Timers and Events

Keep your server on schedule — countdown timers, cron-style recurring messages, reusable templates, and event sign-ups, all from slash commands.

Changed: timer and event commands are split into public and admin halves. /timer list, /event list and /event join are open to every member; /timer templates is visible to everyone but requires Manage Server or a Timers delegation to actually read. Creating, cancelling, pausing and resuming moved to /timer-admin and /event-admin, which require Manage Server or a Timers delegation in the dashboard.

Included Command Groups

  • /timer for server timers and reusable timer templates
  • /event for event scheduling and participation

Personal reminders are handled by /remind in the Utility feature set, not in this cog.

Dashboard Scope (Current)

The dashboard Timers page currently manages timer templates only.

  • Create, edit, and delete reusable templates
  • Review template usage counts

Creating live timers and events is done through slash commands in Discord.

Timers (/timer)

Available Commands

  • /timer list — any member
  • /timer templates — Manage Server or a Timers delegation
  • /timer-admin create name:<name> message:<message> duration:<duration> [recurring]
  • /timer-admin create-cron name:<name> schedule:<cron> message:<message> [channel]
  • /timer-admin cancel id:<timer_id>
  • /timer-admin pause id:<timer_id>
  • /timer-admin resume id:<timer_id>
  • /timer-admin save name:<name> message:<message> duration:<duration> [recurring]
  • /timer-admin fromtemplate template_id:<template_id>

Duration and Recurrence

  • Duration examples: 10m, 2h, 1d
  • Recurrence values: daily, weekly, monthly
  • Cron format: minute hour day month day_of_week
  • Supported cron tokens: *, */n, n, n,m, n-m

Example

/timer-admin create name:hydrate message:"Drink water." duration:1h
/timer-admin create-cron name:weekly_standup schedule:"0 9 * * 1" message:"Weekly standup starts now" channel:#team

Events (/event)

Available Commands

  • /event list — any member
  • /event join event_id:<event_id> — any member
  • /event-admin create name:<name> description:<description> start_time:<YYYY-MM-DD HH:MM>
  • /event-admin cancel id:<event_id>

Example

/event-admin create name:"Town Hall" description:"Quarterly update" start_time:"2026-04-20 18:00"
/event join event_id:5

Notes

  • Scheduler data is handled in UTC.
  • Cron timers compute next runs in UTC.
  • Permission and feature checks are enforced at runtime for timer/event management operations.