Reference Sub actions Subathon Timer

Subathon timer sub-actions

Also on the Cuebot Docs site.

Add time to a subathon timer

Adds time to a subathon timer, or takes it away with a negative number. Good for your own events, like a donation goal or a game event. The timer's longest length still applies.

Setting	What to put in
Timer	The timer's name. Leave it empty for the first timer.
Seconds	How many seconds, like 300 for 5 minutes. A negative number takes time away. Starts as: 60.
Use the timer's multiplier	Ticked: the timer's multiplier is used (double time in happy hour). Starts as: false.

Variables it adds

Variable	What it holds
%secondsAdded%	The seconds really added (less when the longest length was reached)

Type id: subathon.addTime

Get a subathon timer

Gets a subathon timer's time left and state, for a !timer command.

Setting	What to put in
Timer	The timer's name. Leave it empty for the first timer.

Variables it adds

Variable	What it holds
%subathonTimer%	The timer's name
%subathonState%	Stopped, Running, Paused or Ended
%subathonRemaining%	Seconds left
%subathonFormatted%	Time left, like 4:12:30
%subathonElapsed%	Seconds it has run so far
%subathonFormattedElapsed%	Time it has run so far
%subathonAdded%	Seconds that have been added in all
%subathonMultiplier%	The multiplier for event time

Type id: subathon.get

Set a subathon timer's multiplier

Changes how much event time counts, like 2 for a double-time happy hour, or 0.5 when the timer is filling up too fast. Time already added does not change.

Setting	What to put in
Timer	The timer's name. Leave it empty for the first timer.
Multiplier	2 = double, 1 = normal, 0.5 = half, 0 = events add nothing. Starts as: 2.

Type id: subathon.multiplier

Set a subathon timer's time left

Sets how much time a subathon timer has left.

Setting	What to put in
Timer	The timer's name. Leave it empty for the first timer.
Seconds left	The time left, in seconds, like 3600 for one hour. Starts as: 3600.

Type id: subathon.setTime

Start, pause or reset a subathon timer

Starts, pauses, carries on or resets a subathon timer. Good for a Stream Deck button or a mod-only !pause command.

Setting	What to put in
Timer	The timer's name. Leave it empty for the first timer.
Do	Start = start it (or carry on after a pause). Pause = stop the clock. Resume = carry on. Pause or resume = switch between them. Reset = stop it and put back its starting length. Options: Start, Pause, Resume, Pause or resume, Reset. Starts as: Start.

Type id: subathon.control