COMMANDS
// TWITCH CHAT COMMAND REFERENCE
All commands are typed in Twitch chat during a live stream. Commands marked MOD require moderator status. Commands marked STREAMER are LUDAFOX-only.
ECONOMY & RANKS
| Command | Alias | Who | What it does |
|---|---|---|---|
| !shardrank | !srank | VIEWER | Check your rank, total Shardbytes, and point multiplier |
| !nextrank | !nxr | VIEWER | See how many Shardbytes you need for the next rank tier |
| !aboutshards | !shardinfo | VIEWER | Description of Shardbytes and how to earn them |
| !first !second !third | VIEWER | Claim attendance bonuses at stream start — first-come-first-served | |
| !mystreaks | VIEWER | View your current stream attendance streak count | |
| !podium | VIEWER | Display attendance leaders and active streaks | |
| !shardtitle <on/off> | VIEWER | Toggle whether your rank title is spoken by TTS when you trigger alerts |
MINIGAMES
| Command | Alias | Who | What it does |
|---|---|---|---|
| !fish | VIEWER | Cast your rod and catch random marine life. Fish can be sold for Shardbytes | |
| !fishdex | !fdex | VIEWER | Check your fishing collection progress and unique species caught |
| !inventory | !inv | VIEWER | View your caught fish and current items |
| !bait <name> | VIEWER | Equip a bait from the shop to attract specific fish classes | |
| !sellfish <name> | !sellall | VIEWER | Sell fish for Shardbytes — use !sellall to sell everything at once |
| !shop !buy <item> | VIEWER | Browse or purchase baits, rod upgrades, and custom perks | |
| !gamble <amount> | VIEWER | Risk Shardbytes on a random dice roll | |
| !roulette | VIEWER | Play chat roulette — win Shardbytes or get timed out | |
| !duel <@user> <amount> | VIEWER | Challenge a viewer to a Shardbytes wager. Winner takes the pot! | |
| !optin !optout | VIEWER | Enable or disable incoming duel challenges | |
| !y !n | VIEWER | Confirm or decline pending duels, purchases, or actions | |
| !quest | VIEWER | Start a random stream adventure to earn major Shardbytes | |
| !activequest | VIEWER | Check the progress and timer of your current quest |
SOCIAL & CHAT
| Command | Who | What it does |
|---|---|---|
| !bonk <@user> | VIEWER | Bonk someone in chat — plays a sound effect and triggers an OBS animation |
| !bonkbot | VIEWER | Bonk LUDABOT. Be careful — the bot has mood swings |
| !petbot | VIEWER | Show LUDABOT some affection. Improves the bot's mood score |
| !mood | VIEWER | Query the bot's current mood (Happy, Annoyed, Sarcastic...) |
| !lurk | VIEWER | Let the streamer know you're lurking in the background |
| !say <message> | VIEWER | Speak a custom TTS message on stream (costs Shardbytes) |
| !speak <message> | VIEWER | Free TTS — prefixed with "[Sender] says..." |
| !cheer <amount> | VIEWER | Drop gem particles on the OBS physics overlay |
| !commands | VIEWER | List all active commands |
| !hours !uptime | VIEWER | Stream uptime or your total watch-time hours |
| !followage | VIEWER | How long you've been following the channel |
| !quote | VIEWER | Pull a random funny quote from the stream archives |
MUSIC PLAYER
| Command | Alias | Who | What it does |
|---|---|---|---|
| !addsong <URL/search> | !sr !songrequest | VIEWER | Request a song — costs Shardbytes if a price is set |
| !currentsong | !song | VIEWER | See what's currently playing and who requested it |
| !nextsong | VIEWER | See what's up next in the queue | |
| !songlist | !playlist | VIEWER | Link to the public playlist page |
| !skipsong | !skip | VIEWER | Vote to skip the current song |
| !skip (forced) | MOD | Instantly skip without a vote | |
| !volume <1-100> | MOD | Change playback volume | |
| !play !pause !stop | MOD | Control music playback | |
| !clearqueue | MOD | Empty all pending song requests |
MOD & STREAMER COMMANDS
| Command | Who | What it does |
|---|---|---|
| !award <@user> <amount> | MOD | Grant Shardbytes to a user |
| !shardremove <@user> <amount> | MOD | Deduct Shardbytes from a user |
| !shardcheck <@user> | MOD | Query a user's exact balance, tier, and multiplier |
| !treasury | MOD | Check LUDABOT's system treasury balance status |
| !shoutout <user> | MOD | Promote another streamer in chat |
| !permit <user> | MOD | Allow a viewer to post one link without timeout |
| !giveaway <start/close/draw> | MOD | Manage chat giveaways |
| !addquote !delquote | MOD | Add or remove stream quotes |
| !startstream !endstream | STREAMER | Trigger startup/shutdown routines and log broadcast stats |
| !shardmigrate <old> <new> | STREAMER | Transfer all data when a viewer changes their username |
| !backupshards | STREAMER | Back up all user balances to a timestamped JSON archive |