Commands

Custom commands are how viewers talk to the bot. This page centrally manages every command's enablement, cooldown, aliases and permissions, regardless of which module the command belongs to.

What it solves

"Where's the Discord", "what game is this", "what's your setup". The same questions come up several times every stream. Commands let you write the answer once. More importantly, commands from every module (points, check-in, songs, queue…) are configured on this one page, so changing a cooldown doesn't mean hopping between five different modules.

Getting started

1. Find the command on the Commands page and enable it.
2. Set its cooldown and viewer permissions.
3. Optionally add an alias so the same feature answers to a second name.

Common misconceptions

• Commands are disabled by default. Enabling a module does not automatically switch on its commands, deliberately so, since otherwise turning on a module would suddenly add a batch of commands you didn't ask for.
• Aliases need the ! prefix typed in, and can't contain spaces. Nothing is prepended for you; "hi" and "!hi" are two different triggers.
• The cooldown slider stopping at 300 seconds isn't the maximum. Type a larger value in the field beside it, up to 24 hours.
• Commands triggered through a bound custom reward bypass permissions and cooldowns. The binding is the authorisation, so that path still works even when the command is disabled. To limit frequency, set a cooldown or per-user limit on the Twitch reward itself.
• Global and per-user cooldowns are two independent gates. Global shares one timer across the whole channel; per-user is counted separately for each viewer. Both must pass.

Settings

The text below is taken from the in-app help, so it stays in sync with the actual interface.

Chat commands

These are the default command names; they can be renamed or given aliases in the dashboard.

• !commands — Shows a URL pages for enabled commands and ChiwaBots's custom commands.
• !followtime — Shows how long the viewer has been following the channel.
• !title — Show the stream's title, and allows moderators to modify it.
• !game — Show the stream's current game, and allows moderators to modify it.
• !watchinfo — Query the cumulative viewing hours and number of live broadcasts watched in the current month.
• !pickuser — Select one viewer who has sent a message in the past 10 minutes. Add a number after the command to set the number of minutes. The default setting is 10 minutes.
• !cmd — Add, edit, or delete simple text commands from chat (moderators only). Usage: !cmd add <command> <response>, !cmd edit <command> <response>, !cmd del <command>.
• !points — Check how many points a viewer has and their current ranking.
• !addpoints — Give points to viewers. Use 'all' for all chatters
• !setpoints — Set the points of a viewer. Overwrites the current balance instead of adding to it.
• !givepoints — Transfer points to another viewer.
• !toppoints — Shows points Top 3 and leaderboard URL.
• !gamble — Gamble your points.
• !slots — Viewers gamble their points on the slot machine.
• !checkin — Check in. Depending on the settings this counts both the daily check-in (day rolls over at 00:00 UTC) and the per-stream check-in (live only, once per stream).
• !infocheckin — Show your own check-in stats; per-stream streak and total are included when that track is on.
• !topcheckin — Check-in ranking: the top three longest daily streaks; when per-stream check-in is on and the stream is live, also shows the top three streaks for the current stream.
• !recheckin — Spend bits to recover missed daily check-ins within the allowed window and restore the streak.
• !recheckinlive — Spend bits to recover missed streams and restore the attendance streak.
• !qjoin — Join the queue, use !join <nickname> to add a nickname to the queue list
• !qleave — Use this command to leave the queue
• !qlist — Show Queue List URL
• !qinfo — Query queue-related information
• !qstart — Start allow join the queue
• !qstop — Stop new join request
• !qnext — Call a new round queue
• !qclear — Clear queue records
• !song — Displays the title of the current song.
• !songrequest — Request a song for the play queue (default alias !sr).
• !songlist — Give a link to view all song requests.
• !songskip — Skip the current song
• !songpause — Pause the music player (if it's open and playing)
• !songplay — Play the music player (if it's open and paused)
• !songvolume — Change the current volume to the specified number.
• !songlike — Add to playlist via link, search keywords, or by leaving blank to reference the current track.
• !songdislike — Remove the currently playing track from the playlist.
• !songignore — Add the specified user to the song request ignore list.
• !coverrequest — Request a song from the streamer's cover setlist (default alias !cr).
• !cover — Show which song is being covered right now (info only, never requests).
• !coverlist — List the cover songs viewers can request right now.
• !time — Query the remaining time of the timer
• !addtime — Time required to add manually (Negative numbers reduce time)
• !settime — Set time and start
• !pausetime — Pause the timer
• !starttime — Resume/start the timer
• !trans — Use commands to translate messages.
• !trans-auto — Turn automatic translation on or off.
• !trans-ignore — Ignore the specified user's automatic translation and use translation commands.
• !shop — List the rewards available to redeem.
• !redeem — Redeem a reward with channel points (!redeem name).
• !bet — Bet channel points on an active prediction (!bet number points|all|N%).
• !lockbet — Lock betting on the active prediction (MOD).
• !endbet — Resolve the prediction and pay out winners (!endbet number, MOD).

Other notes

• The slider goes up to 300s; use the number field for longer values (max 86400s / 24 hours).
• An alternative name to trigger the command. No spaces. Include a leading ! yourself if you want the prefix.
• Set who can use this command and when.
• Limit how often the command can be triggered.
• Add extra names that trigger this command.

Other settings

These settings have no additional help text in the dashboard; only their names are listed here.

• Enable all
• Disable all
• Disable entire category
• Bot Language
• User Cooldown (s)
• Permission
• Live only
• Aliases (comma-separated)
• Moderators and the broadcaster are always allowed.
• Everyone
• VIP
• Sub T1
• Sub T2
• Sub T3
• Moderator
• Broadcaster
• Covers
• General
• Points
• Games
• Bonus
• Check-in
• Queue
• Song Requests
• Marathon
• Translation
• Rewards
• Predictions
• Counters
• Coin pusher
• Misc
• All
• Moderators+
• Command List
• Search commands
• No commands match your search.
• Edit Command
• Global Cooldown
• User Cooldown
• No cooldown.
• Viewer Permissions
• Only usable while live
• Global
• Per-user
• MOD only
• Add
• This alias already exists.
• Aliases cannot contain spaces.
• Requires feature
• Custom
• Access
• Cooldown
• Aliases