Skip to content

Timers and Events

This section documents the scheduler command groups implemented in the timer cog.

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 create name:<name> message:<message> duration:<duration> [recurring]
  • /timer create_cron name:<name> schedule:<cron> message:<message> [channel]
  • /timer list
  • /timer cancel id:<timer_id>
  • /timer pause id:<timer_id>
  • /timer resume id:<timer_id>
  • /timer save name:<name> message:<message> duration:<duration> [recurring]
  • /timer fromtemplate template_id:<template_id>
  • /timer templates

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 create name:hydrate message:"Drink water." duration:1h
/timer create_cron name:weekly_standup schedule:"0 9 * * 1" message:"Weekly standup starts now" channel:#team

Events (/event)

Available Commands

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

Example

/event 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.