Command Reference
Built-in NuttaBuddy chat commands, placeholders, and examples. Use search to find what you need.
No matches. Try !ping or {user}.
Placeholder variables
Use in dashboard messages (First Chatter, Hug, Quotes, Stream Alerts, entrances, welcome greetings). Case-insensitive.
| Variable | Meaning |
|---|---|
{user} {username} {sender} | Viewer who triggered the action |
{target} {@target} | Target username (hug, host, alerts). {@target} includes @ in alerts |
{count} | Numeric count (gifts, kicks, etc.) |
{viewers} | Raid/host viewer count when available |
{number} {quote} {quoted} | Quote library display |
{random} {random:1-100} {random:yes|no|maybe} | Random number (default 1–100) or random pick from a list (| or ;) |
{rnd} | Alias of {random} |
{math:5*5} | Simple math (+ − × ÷ parentheses) |
{args} {query} | All text after the command (custom commands) |
{arg1} … {arg5} {v1} … {v5} | Word 1–5 after the command (custom commands) |
{channel} {streamer} | Your Kick channel name |
{date} {time} {datetime} | Current UTC date/time |
Hug default: @{user} gives @{target} a big hug! — no target uses everyone for {target}.
Custom command examples: !roll → You rolled {random:1-6}! · !choose pizza burger taco → {sender} picked {arg2}! · !8ball Is it rigged? → {args}? {random:Yes|No|Maybe}
Botrix-style syntax also works in replies: $(sender), $(random 1 6), Rand[1,6], RandomList[Yes;No;Maybe], $(math 5 * 5)
Built-in chat commands
Require the master bot switch on unless noted. Enable each feature in dashboard toggles.
| Command | Who | Example |
|---|---|---|
!ping | Everyone (if enabled) | !pingConfirms the bot is connected. |
!commands · !cmd · !cmds · !command | Everyone (if enabled) | !commandsLists active commands (built-in, Nutty Points, quotes, games, custom, timers). May use multiple chat lines. |
!first | Everyone (live only) | !firstOne first chatter per stream. Uses {username} in your message. |
!hug | Everyone (if enabled) | !hug · !hug name{user} and {target}. |
!watchtime | Everyone | !watchtime · !watchtime @viewerMods can check other viewers. |
!followage | Everyone | !followage · !followage @viewer |
!so | Mods / streamer | !so channelShoutout another Kick channel. |
!host | Mods / streamer | !host channel 50Optional viewer count. |
Nutty Points
| Command | Example |
|---|---|
!points · !balance | !points — your balance |
!store · !shop | !shop — redeemable rewards |
!redeem | !redeem discord |
!pointstop | !pointstop — leaderboard |
Quote system
| Command | Who | Example |
|---|---|---|
!quote | Everyone | !quote or !quote 12 |
!addquote | Mods / streamer | !addquote That was wild |
!delquote | Mods / streamer | !delquote 12 |
Games — Trivia
Enable under dashboard Games. Correct answers credit Nutty Points until the question timer ends.
| Command | Who | Example |
|---|---|---|
!trivia | Everyone | !trivia — status for current game |
!trivia help | Everyone | Short help for viewers and mods |
!triviascore | Everyone | !triviascore — session leaderboard |
!triviacats | Everyone | !triviacats — category slugs (star_trek, star_wars, gaming, …) |
| Answer in chat | Everyone | A–D, 1–4, or type the answer (not a ! command) |
!triviastart | Mods / streamer | !triviastart — start auto questions |
!triviastop | Mods / streamer | !triviastop — pause trivia |
!trivianext | Mods / streamer | !trivianext — skip to next question |
!triviaskip | Mods / streamer | !triviaskip — reveal answer and post next |
!triviacat · !triviacategory | Mods / streamer | !triviacat star_wars — change category |
Moderation
| Command | Who | Example |
|---|---|---|
!timeout | Mods (if allowed) / streamer | !timeout @user 10 spam |
!untimeout | Mods / streamer | !untimeout @user |
!ban | Mods / streamer | !ban @user reason |
!unban | Mods / streamer | !unban @user |
!modhelp | Mods / streamer | Moderation syntax help |
Shield Mode
| Command | Example |
|---|---|
!shieldmode on · !sm on | Enable Shield Mode |
!shieldmode off · !sm off | Disable Shield Mode |
!shieldmode status · !sm status | Shield status |
Custom commands
| Default | Who | Example |
|---|---|---|
!comadd | Streamer; mods if allowed | !comadd discord Join our Discord! |
!comedit | Streamer; mods if allowed | !comedit discord Updated text |
!comdel | Streamer; mods if allowed | !comdel discord |
Rename management commands in Custom Commands settings. Viewers use !yourcommand with variables like {args} and {random:1-6}.
Chat timers
Created in dashboard Chat Timers. Each timer has its own name — when manual triggers are on, chat can run !timername to post early (with cooldown).
Feedback & tickets
Report NuttaBuddy bugs or suggest features from dashboard Feedback & Tickets. Ticket rules (cooldowns, chat commands, limits) are configured in Owner Admin → Feedback Tickets.
| Command | Who | Example |
|---|---|---|
!bug | Everyone | !bug The bot did not reply to !quote |
!suggest · !feature · !idea | Everyone | !suggest Add a poll minigame |
!mytickets | Everyone | Lists your recent tickets on this channel |
!ticketstatus | Everyone | !ticketstatus NB-00012 |
!ticket | Everyone | !ticket help — command help |
Subathon
| Command | Who | Example |
|---|---|---|
!subathon | Everyone (if enabled) | !subathonShows remaining subathon time. |
Full reference: https://nuttabuttainaa.com/nuttabuddy/commands/
Connect with Kick