Variables
Variables let you insert live data into command responses. Write them in curly braces inside your response text and Scrapbot replaces them when the command fires.
Basic variables
These are always available in any command response:
| Variable | What it inserts | Example |
|---|---|---|
{user} | Username of the person who triggered the command | Hello {user}! → Hello TabLord! |
{channel} | Channel slug | Follow at kick.com/{channel} |
{touser} | First argument as a username (strips @) | !so @Sardwyn → {touser} = Sardwyn |
{args} | All arguments joined as a single string | !quote {args} |
{1} – {9} | Individual positional arguments | !ban {1} {2} |
Live variables
These query live data when the command fires. They add a small delay (a DB lookup) but are accurate at the moment of use:
| Variable | What it inserts | Notes |
|---|---|---|
{viewers} | Current viewer count | From the last room intel snapshot |
{game} | Current game being played | From Scrapbot's game context tracker |
{uptime} | Stream uptime (e.g. 1:23:45) | Time since stream session started. Shows offline if not live. |
{count} | How many times this command has been used | Increments each time the command fires |
Random picker
Pick randomly from a comma-separated list:
{random:option1,option2,option3}
Example: Today's vibe: {random:chill,sweaty,chaotic,wholesome}
Positional arguments
When someone types !command word1 word2 word3:
{1} = word1{2} = word2{args} = word1 word2 word3{touser} = word1 with any leading @ stripped
Examples
!so @Sardwyn
Response: Go check out {touser} at kick.com/{touser}! 👏
!viewers
Response: We have {viewers} viewers right now — welcome everyone!
!game
Response: Currently playing {game} — {viewers} of you watching!
!uptime
Response: {user}, we've been live for {uptime}!
!hype
Response: {random:LET'S GO!,POGGERS,HYPE HYPE HYPE,LETS GOOOOO}
!commands
Response: Commands used {count} times total.
Legacy syntax
The following older syntax still works for backwards compatibility:
Legacy Equivalent ${user}{user}$1 – $9{1} – {9}$args{args}$random(a,b,c){random:a,b,c}$tolower(text)Lowercases the text $toupper(text)Uppercases the text
New commands should use the {var} syntax. The legacy $ syntax is supported but not recommended for new commands.