Timers

This feature allows you to have CharlesBot keep track of a timer inside your chatroom. CharlesBot will automatically announce “Times up!” once the duration has completed. Unlike the GIF timers that people previously used, CharlesBot will display the same remaining time to everybody in the room.

Start a Timer

!starttimer [duration]

This command will initiate a timer inside your chatroom. Bare numbers are treated as seconds.

Supported duration formats:

• Seconds: 60, 300
• Timer-style durations: 5:00, 1:30
• Unit suffixes: 30m, 1h, 7d

Example

!starttimer 5:00

This will start a five-minute timer inside of your chat room.

!starttimer 30m

This will start a thirty-minute timer.

Check Timer Duration

!timer

Use this command to check the remaining time of an active timer.

Add Time to a Timer

!timer add [duration]

This subcommand allows you to add additional time to an active timer. It supports the same duration formats as !starttimer.

Example

!timer add 2:00

This will add two minutes to the currently active timer.

!timer add 30m

This will add thirty minutes to the currently active timer.

Set Timer Duration

!timer set [duration]

This subcommand allows you to reset the timer to a specific duration starting from the moment the command is used. It supports the same duration formats as !starttimer.

Example

!timer set 10:00

This will reset the timer to ten minutes starting from now.

!timer set 1h

This will reset the timer to one hour starting from now.

Subtract Time from a Timer

!timer subtract [duration]

This subcommand allows you to subtract time from an active timer. It supports the same duration formats as !starttimer.

Example

!timer subtract 1:30

This will subtract one minute and thirty seconds from the currently active timer.

!timer subtract 30m

This will subtract thirty minutes from the currently active timer.

Stop a Timer

!endtimer

This command will instantly stop any actively running timer.