Scottybot is Twitch.tv's premier chat bot, offering an extensive list of features, many of which are not seen elsewhere. It hosts the typical features, such as anti-spam filtering, commands, repeating messages, ability to change the bot name, and more. It also hosts many unique features, such as a points system, games, raffles for each tier of user (Aka Everyone/Followers/Subscribers) and more, including a downloadable GUI, which is optional, that is your one stop shop to control both your bot and your channel.
Getting Scottybot in your channel is easy to do, just click the "Let's Go!" button below, and you will have a pop-up that takes you to Twitch's site asking for Approval. Click Approve and it will do the rest!
The GUI, dubbed ScottyGUI, hosts many features giving you unique control over both your bot and your channel. It allows you to enable or disable most features of the bot in your channel, allows you to change the game and the stream title on the fly with an easy to use game search and sorter, has alerts for both followers and subscribers, channel statistics, a built in and pop-out chat client and much more. It also includes a moderator mode, in which your moderators can access the same panel once the streamer has provided them with the uniquely generated authkey found in the settings page. This gives the moderator full control of the bot (not the stream due to Twitch.tv restrictions) as if they were the streamer, so a certain level of trust is required. The GUI is completely optional, but does make life so much easier.
Commands
Choose a category:
!lastfm link LFMAccountName
Mods and Streamer
DONATORS ONLY - Link Scottybot to your Last.FM account using the account/login name for Last.FM
!lastfm disable
Mods and Streamer
DONATORS ONLY - Disable/Purges your Last.FM information.
!song
Everyone
DONATORS ONLY - Assuming Last.FM is linked to both your music app (such as Spotify) and Scottybot, displays the currently playing song.
!discordlink
Streamer
Begins the process of linking your Discord server to your Mixer channel, Scotty responds with two whispers:
1: Follow the link in the first whisper to add Scottybot to your Discord server
2: Run the command from the second whisper in a channel of your Discord server where Scottybot can read and post to confrim the connection; !scottylink ##########
!discordulink
Everyone
Discord commands will not run unless your accounts are linked!
Begins the process of linking your Discord user account to your Mixer user account. Run this from any channel that has Scottybot, Recommend mixer.com/scottybot. Follow the instructions Scottybot whispers you to complete the user link.
!mod Add/Remove DiscordUser
Streamer
Adds or Removes a Discord's user account from moderator status for Scottybot in that Discord channel.
!getauthkey
Streamer
Generate a link for you to click on. With authenticate you via Twitch's OAuth and then provide your authkey to provide to whoever you wish.
Keep in mind this code will give full access to the bots functions to the wielder.
!regenauthkey
Streamer
Generate the Authkey and force close all open sessions using the now invalid key.
!scottyleave
Streamer
Run this from your channel to remove scottybot. There will be tears.
!uptime
Everyone
Displays how long the streamer has been live.
!followage
Everyone
Displays how long you have been following the channel.
!math FORMULA
Mods and Above
Will process the formula provided. While I am no numbermatician it handled everything I threw at it.
!set subalert on/off
Mods and Streamer
Enables or disables alerts for new subscribers.
!set subbonus [points]
Mods and Streamer
Set the amount of points awarded to new subscribers.
!set submsg [text]
Mods and Streamer
Sets the text of your sub message. Use '(_user_)' in place of subscriber name.
!filter status
Mods and Streamer
Checks the current filter settings of the bot.
!filter on/off
Mods and Streamer
Filter Master Switch: Will turn on or off all chat filtering.
!filter reason on/off
Mods and Streamer
If enabled, bot will announce the who and why of a filter action, otherwise the bot will just remain silent when filtering.
!filter exclude allowed
Mods and Streamer
Shows a list of available permissions to exclude from chat filtering.
!filter exclude current
Mods and Streamer
Shows the current excluded permissions from chat filtering
!filter exclude add PERM
Mods and Streamer
Adds the permission to the filter exclusion list.
!filter exclude remove PERM
Mods and Streamer
Removes the permission from the filter exclusion list.
!filter url on/off
Mods and Streamer
Enables or disables filtering of links. On = filter links, Off = allow links
!permit [user]
Mods and Streamer
Allows the user to post a link if filtering is enabled.
!set maxemotes on/off
Mods and Streamer
Enables or disables maximum Emotes filtering.
!set maxemotes [number]
Mods and Streamer
Sets the maximum Emoji count.
!set maxcapitals on/off
Mods and Streamer
Enables or disables filtering of too many capital letters..
!set maxcapitals [number]
Mods and Streamer
Sets the maximum percentage of caps a message can have before being filtered.
!set maxsymbols on/off
Mods and Streamer
Enables or disables the max symbols in a message filter.
!set maxsymbols [number]
Mods and Streamer
Set the max percentage of symbols a message can have before being filtered.
!filter badwords on/off
Mods and Streamer
Enables or disables filtering of bad words
!badwords add [words]
Mods and Streamer
Messages with these words are auto purged. Can add more than 1 word at a time. Reccommend /whisper @Scottybot !badwords add [words]
!badwords remove [words]
Mods and Streamer
Removes listed words from your badwords list. Can remove more than 1 word at a time.
!ignoreuser add [user]
Mods and Streamer
(CURRENTLY IN BETA) Add a user to the ignore list. The bot will no longer repond to the user or give them points/hours.
!ignoreuser remove [user]
Mods and Streamer
Removes a user from the ignored users list.
!cmd add !yourCommand Response for command including text, links, and (_variables_)
Mods and Streamer
Adds/overwrites a command and output text. Variables can be used in this command. Your Mixer Chat Settings must be set to Allow Links for Scottybot to post links
!cmd remove ![command]
Mods and Streamer
Removes the command.
!cmd restrict ![command] Everyone/Moderator/Owner
Mods and Streamer
Restricts a command to a certain group. Values are: EVERYONE, PRIME_TURBO, PARTNER, SUBSCRIBER, FOUNDER, SUBGIFTER, VIP, TWITCHSTAFF, MODERATOR, BROADCASTER, OWNER
!cmd setcount ![command] [count]
Mods and Streamer
Manually allows you to set the command counter pulled by the (_cmdcount_) variable.
!cmd getcount ![command]
Mods and Streamer
Pulls the current count of the command without actually ticking it up.
!commands
Everyone
Provides links to Scottybot default and custom channel commands.
!cmd cost ![command] [points]
Mods and Streamer
Makes a command cost points to run.
!triggers
Mods and Streamer
Provides list of Triggers and their INDEX numbers
!triggers add TRIGGER RESPONSE
Mods and Streamer
Looks for regular expressions (REGEX) and will respond when a message matches the criteria.
Pipe character "|" acts like OR eg: this|that
Parenthesis act like (containers)
When looking for combinations of words, place a '_' between words that need to be next to each other, or a "*" when words can be anywhere
Most variables work such as (_user_).
eg: !trigger add (follow|join|watch)*(me|my|please|pls|plz) Please no advertising
!triggers regexadd RegexTrigger RESPONSE
Mods and Streamer
The same ass !triggers add but allows you to provide raw regex instead of using the built in system.
Regex cannot have whitespace in it else it will break.
Response follows all the same rules as !triggers add.
!triggers edit TRIGGER_INDEX RESPONSE
Mods and Streamer
Edits a chat trigger response. Get the TRIGGER_INDEX from running !trigger list
!triggers remove TRIGGER_INDEX
Mods and Streamer
Removes the trigger. Get the TRIGGER_INDEX from running !trigger list
!set whitelistme on/off
Mods and Streamer
Allow whitescribers to white list themselves. Viewers added this way expire on a monthly basis.
!set whitelistcost #
Mods and Streamer
How many points it should take to allow someone to white list themselves
!whitelistme MCName
Whites Only
Added that user to the whitelist if whitelistme is enabled.
!whitelist add MixerName MCName
Mods and Streamer
Adds that viewer to the whitelist and will never expire.
!whitelist remove MixerName
Mods and Streamer
Manually remove a view from the whitelist.
Whitelist API URL - JSON - Includes Mixer User ID and Expiration date in Milliseconds.
Sublist API URL - RAW - Only shows Minecraft name.
Updates instantly.
https://api.scottybot.net/api/sublist?channame=CHANNELNAMEorID&output=RAW
Recommend using Whitelister (Click Here) with this API URL
!repeat delay [number]
Mods and Streamer
How long, in minutes, between each repeated command. Minimum of 10 minutes.
!repeat add ![command]
Mods and Streamer
Adds a custom command to the repeat list. Ignores command restrictions.
!repeat remove ![command]
Mods and Streamer
Removes a command from the repeat list.
!repeat list
Mods and Streamer
Provides a link to show all repeating commands.
(_lastgame_)
Variable
If this variable is used in a custom command it will be replaced by the last game they streamed, useful for when your being raided.
(_delete_)
Variable
If this variable is used in either a custom command or a chat trigger, the invoking command will be removed if the bot is able to do so.
(_user_)
Variable
Is replaced by the name of the person who ran the command.
(random_StartNum_EndNum_)
Variable
Will generate a random number before the StartNum and EndNum
(_target_)
Variable
Is replaced by the first word after the command. You may also add ':Default' to the end, replacing Default with a value (accepts variables as well), so if no target is provided it falls back to that.
(_parameter_)
Variable
Accepts all messages after the command.
(_cmdcount_)
Variable
This is replaced by how many time the command has been run.
!set quotes on/off
Mods and Streamer
Enable or Disable the quote system.
!set quotes cost #
Mods and Streamer
Enable or Disable the quote system.
!quote
Everyone
Pulls a random quote from the quote list.
!quotes
Everyone
Provides a link to all available quotes for the channel.
!quote add [person] [message]
Mods and Streamer
Adds the quote, the person who said it, and then time stamps it.
!quote [ID]
Everyone
Gets a quote based on ID from !quotes.
!quote remove [ID]
Mods and Streamer
Remove a quote from the !quote list.
!set points on/off
Mods and Streamer
Enables or disables the point system.
!set points name [name]
Mods and Streamer
Sets the name of your points. Ex: !pacs or !wobblers
!set points amount [number]
Mods and Streamer
This is how many points viewers get while you're live per 15 minutes.
![points]
Everyone
Shows how many points you have. Point name may vary per streamer.
!top [number]
Mods and Streamer
Get the top 1-20 viewers with the most points.
!bestow viewer [number]
Mods and Streamer
Give the viewer that many points.
!remove viewer [number]
Mods and Streamer
Removes that many points from the viewer.
!giveall [points]
Mods and Streamer
Gives everyone in chat that many points.
!purgeallpoints
Mods and Streamer
Purges all points from the database. Resets everyone.
!set queue on/off
Mods and Streamer
Enables the X(Box)Queue system.
!set queue subonly on/off
Mods and Streamer
Puts the XQueue is Subscriber only mode.
!set queue cost AMOUNT
Mods and Streamer
Sets the cost for someone to enter the queue.
!queue next COUNT
Mods and Streamer
Gets the next COUNT in line, or only next 1 person if no COUNT provided
!queue list
Everyone
Provides the link to the queue list.
!queue purge
Mods and Streamer
Empties the queue.
!queue enter
Everyone
Enters the command runner into the queue.
!queue remove
Everyone/Mods and Above
If your not a mod, removes you from the queue. If you are a mod, you can remove yourself, or define someone else to remove.
!set raffle on/off
Mods and Streamer
Enables or Disables the raffle which includes sraffle.
!raffle start [points]
Mods and Streamer
Starts a raffle with a cost of [points].
!raffle
Everyone
Enters you into a raffle.
!sraffle start [points]
Mods and Streamer
Starts a sub only raffle with a cost of [points].
!sraffle
Everyone
Enters you into a sub raffle.
!set spingame on/off
Mods and Streamer
Enables or disables the Spin game.
!set spingame cooldown DurInMinutes
Mods and Streamer
Set the cooldown for the Spin game in minutes.
!spin [points]
Everyone
Enters a game of Spin with the amount you wish to wager.
!set bankheist on/off
Mods and Streamer
Enables or disables the bankheist game.
!set bankheist cooldown DurInMinutes
Mods and Streamer
Set the cooldown for the Bankheist game in minutes.
!set bankheist cmd NewStartCommand
Mods and Streamer
Sets the command to start a bankheist. Default is !heist
!heist [points]
Everyone
Enters a game of bankheist with the amount you wish to wager. This can be customized using the following command.
!set roulette on/off
Mods and Streamer
Enables or disables the Roulette game.
!set roulette cooldown DurInMinutes
Mods and Streamer
Set the cooldown for the Roulette game in minutes.
!roulette [points]
Everyone
Enters a game of Roulette with the amount you wish to wager.
The bot will reply to most commands instead of just speaking in chat like normal.
!set followalert on/off
Mods and Streamer
Turn on or off follower alerts in chat.
!set followalert msg [message]
Mods and Streamer
Sets the follower message. (_user_) variable will be replaced by the follower name.
!set subalert on/off
Mods and Streamer
Turn on or off subscriber alerts in chat.
!set subalert msg [message]
Mods and Streamer
Sets the subscriber message. (_user_) variable will be replaced by the subscriber's name.
!rank
Everyone
Tells you how many hours you have watched the current channel plus an arbitrary rank.
!sethours person minutes
Mods and Streamer
Able to manually set hours for a users. Entry must be in minutes, aka to set one hour you would run !sethours person 60
!tophours count (up to 20)
Mods and Streamer
Get the top X users hours
!twittercfg auth
Streamer
Begins the process of Authorizing Scottybot access to your Twitter account. Information will be whispered, so please enable whispers while doing this.
1: Follow the link in the first whisper, make sure you're logged into the correct twitter account, then Authorize
2: Copy the pin provided
3: Provide the pin to Scottybot as shown in the second whisper to complete authorization; !twittercfg pin #######
!twittercfg deauth
Streamer
Removes all twitter auth information from the database for your channel.
!twittercfg modtweet on/off
Streamer
Allows Mods to tweet on your behalf. Default is off.
!twittercfg send [message]
Mods and Streamer
Send out a tweet of your choosing straight from chat.
!set livetweet on/off
Mods and Streamer
Enables the bot to automatically send a tweet when you go live.
!set livetweetmsg [message]
Mods and Streamer
Sets the auto-tweet message for when you go live. This uses the following variables: (_status_), (_game_), and (_channel_)
!8ball [message]
Everyone
The magic 8 ball knows everything and will tell you the truth. Scottybot donators only.
I will do my absolute best to make sure Scottybot remains free meaning unlimited commands, no points cap, unlimited quotes, etc... However, servers do cost so any support is greatly appreciated.
If you do decide to donate, follow the instructions to the right and you'll be auto-flagged as a donator. Donating gives you access to fun Scottybot features, for more information:
To gain donator status a donation of $10 USD or more is required, and you must follow the steps below to be auto flagged. If something goes wrong email me at Twitchscottybot@gmail.com with your paypal email address.
Make sure Scottybot is in your channel.
Go to the donation page with the button below..
You will be direct to Twitch so I can verify who you are.
Leave a message, I love comments!
Click donate.
Scottybot should announce your donator status in your channel!
