OathyBot Commands

This page outlines the commands for OathyBot (oatsngoats channel).
This bot is written and managed by Rakkir_.
Most commands are subject to anti-spam (even for whitelisted people!).

For those curious, the bot is written in C# and hosted on a Linux VM on a Google Server.

The bot will automatically wake itself up and start responding to messages and posting oats advertisements when it detects chat activity.
After five minutes of no chat activity the bot will put itself to sleep and stop posting.

The bot understands Twitch User permission levels, and views them in this heirarchy:
1. Broadcaster/Editors/GOD(me)
2. Admin
3. Moderator
4. VIP
5. Subscriber
6. User

By default, any message that the bot detects has a 1/500 chance to be CORNed. IF the message has more than one word in it.
This means that it will replace one letter in the sentence with the word CORN and append an oatsFarmer to the end, then repost it.

The bot also has some special privileges because it is a twitch "known_bot". These include:
-Increases number of unique recipients of whispers
-Increases burst capacity of sending whispers (ie per second and per minute max)
-Increases chat rate limit from 20 to 50 in a 30 second window.
-Small tweaks to various filters where they apply to automated chat messages (ie spam filtering)

Commands are case sensitive.

 !commands
	Links to this page.

Hard-coded:
User Level Commands:

 !help
    Expected command structure: !help <command name>
    Used to get help with commands, tells you what the command does/the expected format (if you have permission).

 !sacrifice
    Expected message structure: !sacrifice
	Sacrifice the user to Phantoon for five minutes to satiate his bloodthirst

 !sacrifices
    Expected message structure: !sacrifices
	Tells how many users have sacrificed themselves to the blood god Phantoon today.


Moderator Commands:
(all user commands)
(all subscriber commands)
(all VIP commands))

  !pepegaspeak <your text here>
    Any text included after the !pepegaspeak command will be read in, altered to be pepega, and output by the bot again.

  !shoutout <user>
    If oats gets hosted or raided, use this to shout out the raider, it will tell chat to go follow their stream.
    e.g.: !so bawkbasoup


  !backseating
	Tell the chat not to backseat oats, and that all back seating is purgable.

  !backseatingtoggle
	Put the bot in a mode where it will post the !nobs message on a 10 minute timer. Use the command again to turn this feature off. Putting the bot to sleep (if you are also an admin) also toggles this mode.


Admin Commands(whitelist only):
(all user commands)
(all subscriber commands)
(all VIP commands)
(all moderator commands)

 !addcommand
    Expected message structure: !addcommand <command name> <command text OR permission level like \"-u\"> <if there is a
permission level, command text>
	Allows admins to add and remove commands to the bot.

	User Levels: -b (broadcaster), -a (admin), -m (mod), -v (VIP), -s (subscriber), -u (user)
		Example: !addcommand !test Hello
	This adds the command !test to the bot, and when any user types !test the bot will respond with "Hello"

		Example: !addcommand !test -v This is VIP only
	This adds the command !test to the bot but it will only respond for VIP or above.

	The bot will tell you if the command add was successful or fails for any reason.

 !editcommand
	Expected message structure: !editcommand <command name> <command text OR permission level like \"-u\"> <if there is a permission level, optional command text to change at the same time>

	User Levels: -b (broadcaster), -a (admin), -m (mod), -v (VIP), -s (subscriber), -u (user)
		Example: !editcommand !test Sup
	This edits the command !test in the bot to respond with "Sup" instead

		Example: !editcommand !test -m This is now Mod only
	This edits the command !test to the bot but it will only respond for Mod or above.

	The bot will tell you if the command add was successful or fails for any reason.

 !removecommand <commandname>
	Expected message structure: !removecommand <command name>

	Remove any command that has been added to the bot with the !addcommand feature.
	ANY COMMAND YOU REMOVE IS NO LONGER AVAILABLE TO ANYONE, IT IS LOST FOREVER.

		Example: !removecommand !test
	This removes the command test added before.

	The bot will tell you if the command remove was successful or fails for any reason.

 !sleep
	Put the bot to sleep until you use the !wakeup command (also put the subscribe/follow thread to sleep) This is a HARD pause, it turns off the chat auto-detect feature.

 !wakeup
	Wake up the sleeping bot. (Also wake up the subscribe/follow thread). Re-enables chat auto-detection.

 !cornstorm
	Set the bot chance to corn a message to 1/5

 !clearskies
	Set the bot chance to corn a message to 1/500


Broadcaster/Bot Editor Only Commands(because with great power comes great responsibility)

 Every other command

  !whitelist
    Expected message structure: !whitelist <username>
	  Adds a user to the "admin" list in the bot. Gives them access to all admin commands and under. Does not work if the user is in the blacklist.

  !unwhitelist
    Expected message structure: !unwhitelist <username>
	  Removes a user from the "admin" list in the bot.

  !blacklist
    Expected message structure: !blacklist <username>
	  Adds a user to the blacklist in the bot. Ignores them entirely. Does not work if the user is in the whitelist.

  !unblacklist
    Expected message structure: !unblacklist <username>
	  Removes a user from the blacklist in the bot.

  !addeditor
    Expected message structure: !addeditor <username>
	  Gives user the access to every command. Use with EXTREME caution. If I find out you didn't I will omega-ban you.

  !removeeditor
    Expected message structure: !removeeditor <username>
	  Removes the user access to every command.

  !addauto
    Expected message structure: !addauto <Auto posted text here>
	  Adds an auto posting message on the cadence in the botconfig file. Adding more than one of these will result in the bot cycling through them in order.

  !getautos
 	  Whispers you all of the current auto posting messages you have saved, by index. This currently doesn't work very well and I'm the only one who uses it anyways... but if some one wants to actually use it let me know and I'll figure it out.

  !removeauto
    Expected message structure: !removeauto <index from !getautos>
	  Removes the specified auto posted message.

  !disablecommand
    Expected message structure: !disablecommand <hard coded command name>
      Disables a hard-coded command. Can be reversed with !enablecommand.

  !enablecommand
    Expected message structure: !enablecommand <hard coded command name>
	  Enables a hard-coded command. Can be disabled again with !disablecommand.

  !addchannelpointredemption
    Expected message structure: !addchannelpointredemption "Channel point redemption title" -<one of the supported message types> <optional text to additionally send to chat>
	  Use to issue an action against the chat or a user upon a specific channel points redemption. Supported command types: -message, -timeout, -ban, -unban, -slow, -slowoff, -unique, -uniqueoff, -emote, -emoteoff, -sub, -suboff. Commands that require a username require the username to be typed into the redemption text.

  !removechannelpointredemption
    Expected message structure: !removechannelpointredemption "Channel point redemption title"
	  Use to remove an existing action upon a specific channel points redemption.

  !getchannelpointredemptions
      Use to have the bot whisper you the current saved channel point redemptions.

  !executeorder66
      Purge anyone who talks in chat. At all.

  !thedarksidewins
      The battle is won, the Jedi are gone. (Turns off auto purge)