NUTTABUDDY COMMAND REFERENCE
Chat Commands & Variables
Examples for every built-in NuttaBuddy command and what each placeholder variable means. Custom commands and dashboard toggles can change names and messages for your channel.
No matches. Try a command name like !ping or a variable like {user}.
Placeholder variables
Use these in dashboard message fields (First Chatter, Hug, Quotes, Stream Alerts, Custom Entrances, Welcome Greetings, and more). Matching is case-insensitive.
| Variable | Replaced with | Used in |
|---|---|---|
{user} {username} {sender} |
The viewer who triggered the action (no @ required in templates). |
Hug, First Chatter, Welcome Greetings, Custom Entrances, Stream Alerts |
{target} {@target} |
Another username — hug target, host target, or alert target. {@target} includes @ in alerts. |
Hug, Host shoutouts, Stream Alerts |
{count} |
A numeric count (gifted subs, kicks, etc.). | Stream Alerts overlay text |
{viewers} |
Viewer count from a raid/host when available. | Stream Alerts, manual !host |
{number} |
Quote number in your channel quote library. | Quote display template |
{quote} |
The quote text stored in your library. | Quote display template |
{quoted} |
Username the quote is attributed to. | Quote display template |
{random} {random:1-100} {random:yes|no|maybe} |
Random number (default 1–100) or random pick from a list (| or ;). |
Custom commands, Hug, First Chatter, quotes, alerts, entrances |
{rnd} |
Alias of {random}. |
Same as {random} |
{math:5*5} |
Evaluates simple math (+ − × ÷ and parentheses). | Custom commands and message templates |
{args} {query} |
All text after the command name. | Custom commands (e.g. !8ball your question) |
{arg1} … {arg5} {v1} … {v5} |
Individual words after the command (1st word = {arg1} / {v1}). |
Custom commands |
{channel} {streamer} |
Your Kick channel username. | Custom commands |
{date} {time} {datetime} |
Current UTC date/time. | Custom commands and templates |
Hug default: @{user} gives @{target} a big hug! 🤗 — if no target is given, {target} becomes everyone.
Examples: You rolled {random:1-6}! · {sender} picked {arg2}! · {args}? {random:Yes|No|Maybe}
Botrix-style (also supported): $(sender), $(random 1 6), Rand[1,6], RandomList[Yes;No;Maybe], $(math 5 * 5)
Built-in chat commands
Require Master Bot Switch on in your dashboard unless noted. Enable each feature with its toggle.
| Command | Who can use | Example |
|---|---|---|
!ping |
Everyone (if Ping enabled) | !pingBot replies to confirm chat is connected. |
!commands · !cmd · !cmds · !command |
Everyone (if Commands List enabled) | !commandsLists all active commands on your channel (built-in, Nutty Points, quotes, games/trivia, custom, timers, subathon, etc.). May use multiple chat messages. |
!first |
Everyone (if First Chatter enabled, live only) | !firstOne viewer per stream claims first chatter. Uses your First Chatter message with {username}. |
!hug |
Everyone (if Hug enabled) | !hug · !hug nuttabuttainaaCustom message from dashboard; {user} and {target}. |
!watchtime |
Everyone | !watchtime · !watchtime @viewerShows tracked watchtime for this channel. |
!followage |
Everyone | !followage · !followage @viewerFollow date from when NuttaBuddy first saw the follow. |
!so @channel |
Mods / streamer (if Shoutouts enabled) | !so nuttabuttainaaPromotes another Kick channel. |
!host @channel |
Mods / streamer | !host nuttabuttainaa 120Optional viewer count for Nutty Points / alerts. |
Nutty Points
| Command | Example |
|---|---|
!points · !balance | !points — your balance |
!store · !shop | !shop — list redeemable rewards |
!redeem | !redeem discord — redeem by reward name |
!pointstop | !pointstop — leaderboard |
Quote system
| Command | Who | Example |
|---|---|---|
!quote | Everyone | !quote or !quote 12 |
!addquote | Mods / streamer | !addquote That was wild #username |
!delquote | Mods / streamer | !delquote 12 |
Display format uses {number}, {quote}, {quoted} — set in dashboard Quote settings.
Games — Trivia
Enable in the NuttaBuddy dashboard under Games. Categories include Star Trek, Star Wars, gaming, movies, science, sports, music, internet memes, and mixed.
| Command | Who | Example |
|---|---|---|
!trivia | Everyone | !trivia — current game status (category, interval, time left) |
!trivia help | Everyone | Short help for viewers and moderators |
!triviascore | Everyone | !triviascore — trivia session leaderboard |
!triviacats | Everyone | !triviacats — list category slugs (star_trek, star_wars, gaming, mixed, …) |
| Answer in chat | Everyone | A–D, 1–4, or type the answer text (no !) — each correct answer earns Nutty Points until time runs out |
!triviastart | Mods / streamer | !triviastart — start trivia and post a question |
!triviastop | Mods / streamer | !triviastop — pause auto questions |
!trivianext | Mods / streamer | !trivianext — end current question and post the next |
!triviaskip | Mods / streamer | !triviaskip — reveal answer, then post next question |
!triviacat · !triviacategory | Mods / streamer | !triviacat star_wars — switch category (see !triviacats) |
Configure question interval, answer time, Nutty Points per correct answer, first-correct bonus, and live-only mode in dashboard Games. Check balance with !points or !balance.
Feedback & tickets
Report NuttaBuddy bugs or suggest bot features. Enable in dashboard Feedback & Tickets or use chat commands below.
| Command | Who | Example |
|---|---|---|
!bug | Everyone (if enabled) | !bug Timer posts twice when stream goes live |
!suggest · !feature · !idea | Everyone | !suggest Add wheel-of-fortune chat game |
!mytickets | Everyone | Lists your recent tickets for this channel |
!ticketstatus | Everyone | !ticketstatus NB-00042 — check status & team reply |
!ticket · !ticket help | Everyone | Help for the ticket system |
Each ticket gets an ID like NB-00001. Rate limits and max open tickets are configurable in dashboard settings.
Subathon
| Command | Who | Example |
|---|---|---|
!subathon |
Everyone (if Subathon enabled) | !subathonShows remaining subathon countdown time in chat. |
Timer control and Kick event rules are in dashboard Subathon (no other chat commands).
Moderation
| Command | Who | Example |
|---|---|---|
!timeout | Mods (if allowed) / streamer | !timeout @user 10 spam — minutes, or 30s / 2h |
!untimeout | Mods / streamer | !untimeout @user |
!ban | Mods / streamer | !ban @user reason |
!unban | Mods / streamer | !unban @user |
!modhelp | Mods / streamer | Lists moderation command syntax |
Shield Mode
Streamer and trusted mods only (configure trusted mods in dashboard).
| Command | Example |
|---|---|
!shieldmode on · !sm on | Enables Shield: auto-ban new follows, block first-time chatters, retro-ban recent follow bots, clear follow spam in chat |
!shieldmode off · !sm off | Disables Shield and linked protections |
!shieldmode status · !sm status | Shows whether Shield is on |
Custom commands
Create commands in the dashboard or from chat (if enabled). Names are lowercase, 1–25 characters, letters/numbers/underscore.
| Default | Who | Example |
|---|---|---|
!comadd | Streamer; mods if allowed | !comadd discord Join our Discord: https://... |
!comedit | Streamer; mods if allowed | !comedit discord Updated message here |
!comdel | Streamer; mods if allowed | !comdel discord |
Rename !comadd / !comedit / !comdel in dashboard → Custom Commands → chat management settings.
Viewers run custom commands as !commandname or !commandname extra words — use {args}, {arg1}, and random variables in the reply. Optional audio plays via your Channel Points OBS browser source.
Chat timers
Configured in dashboard Chat Timers. The bot auto-posts each timer message on its interval (checked every minute).
| Command | Who | Example |
|---|---|---|
!yourtimername |
Everyone (if manual triggers enabled) | !discordPosts that timer’s message early, subject to its manual cooldown. Name is whatever you set in the dashboard (2–25 characters). |
Dashboard-only (no chat command)
These use overlay URLs and placeholders in the dashboard:
- Stream Alerts —
{user},{count},{target},{viewers},{random:...} - Custom Entrances —
{user}on first chat of stream - Welcome Greetings —
{username}for new chatters - Stream Widgets, Subathon, Uptime — OBS browser sources
Questions or missing commands? Open the NuttaBuddy dashboard or connect at bot.nuttabuttainaa.com.