AnkhBot by AnkhHeart Documentation Overview Console: The place where the bot will throw in chat logs Dashboard: Allows you to change your stream title & game. If you re a partner you can also run commercials. In order to use this you have to connect your twitch account which can be done under Credentials -> Streamer Login Regular Commands: Where normal commands can be added Timed Commands: Where your timed/looping messages can be added Quotes: Where your quotes can be added Give Away: Raffle window that allows you to do giveaways Settings: Allows you to tweak some settings Credentials: Where you can input information to connect to Twitch and/or Google Sync To Google: Let s you sync all your data to a Google Spreadsheet Extra Features: This is where extra features that aren t part of the core will appear Help: This is where you can find Documentation about the bot and an About section
Setup (Twitch) Make a new Twitch.tv account specifically for the bot Go to Credentials -> Bot Login Username: Enter the bot s twitch username ex: ankhybot Oauth-Token: This is where the generated token will appear Channel: Type in the channel you want to the bot to connect to ex: edemonster Port: Set the port you wish to connect to Click Generate Oauth-Token in order to go through the token generating process, which will happen in the browser window that ll appear out of nowhere. In here you must log into twitch using the Bot s Twitch.tv Account. Click Connect to connect the bot to the Channel Streamer Login Go to Credentials -> Streamer Login Username: Enter your own twitch user name Oauth-Token: This iw here the generated token will appear Generate Oauth-Token: Shows a browser on the side so you can log in to twitch and have it generate one for you Connect: Connects and checks if the token is valid which allows you to use the Dashboard. Commercial settings are for partners only, the bot detects this.
Setup (Google Docs) Make a Gmail account if you do not have one yet: http://www.gmail.com Make sure you re logged into it then go to: https://docs.google.com/spreadsheets/d/1vyoz0gqcwbcdraehxwcjptfn4kh5su6ek57 66ZDFFuk Go to File -> Make a Copy Name the copy BotData(BotNameHereInLowerCase) ex: BotDatacasca_bot Within the bot go to Credentials -> Google Login Email: Enter your Gmail email-adress Password: Type in your email s password Click Connect If you don t get a popup saying that the login failed everything is ok If you are sure your password is correct go to https://www.google.com/settings/security and make sure two step authentication is disabled & Access for less secure apps is enabled
Dashboard Basic: Allows you to Refresh your Stream Title & Game and Update them from the bot itself. For this you have to connect your twitch account under Credentials -> Streamer Login. Manual Commercial: Allows you to start a commercial with just a click of a button Automatic Commercial: Allows you to setup an automated timer that runs a commercial for you after X amount of time. This resets itself so you can set it up to go off on an hourly basis and it ll do its job after every hour. If you wish you can warn the viewers in chat or just have a Sound play a few seconds before the commercial is about to roll. Automated Hosting: Allows the bot to host channels for you by queuing them up. In order for this feature to work the bot must be made an editor in your channel. This can be done by going to http://www.twitch.tv/(yourname)/dashboard/permissions
Regular Commands Command: Set the command that you wish to use here ex:!test Permission: Set the permission as to who can use the command Type: Can be either NoParameter or SingleParameter(requires extra info when called ex:!follow promouse) Enabled: True/False allows you to Enable/Disable the command to be used within chat Response: Type anything that you want the command to output here $(parameter)- replacements are allowed (Look at String Replacement for more info)
Timed Commands Command: Set the command that you wish to use here ex:!ctt Permission: Set the permission as to who can use the command Active: True/False, This makes the timer active and automatically executable by the bot whenever the interval(can be found under settings) hits Enabled: True/False allows you to Enable/Disable the command to be used within chat Response: Type anything that you want the command to output here $(parameter)- replacements are allowed (Look at String Replacement for more info)
Quotes ID: Numeric value representing a pre-existing quote, Leave this empty if you re adding one manually Quote: Type your quote here ex: I sprayed it into my nose! (YourName)
Give Away Raffle Keyword: Set the keyword that people have to type in order to join Moderator/Subscriber/Normal Viewers: Checking any of these sets who can enter your give away Must Be Follower: If checked it ll only pick a follower as the winner. If someone that s not following wins the bot will instantly look for someone else that is hopefully following. So the non-follower will never be notified of winning. Notify Winner in Chat: Will throw a message to the user in chat telling him that he won Entered Users: Shows a list of people that have entered Winner: Shows the winner & the messages the winner typed into chat after winning, so you can figure out if he wants the prize or not
SFX System Command: Set the command that you wish to use here ex:!scream Permission: Set the permission as to who can use the command Enabled: True/False allows you to Enable/Disable the command to be used within chat Cooldown: The amount of minutes a command can t be voted for after the SFX has started playing Min Votes: Min amount of votes before the SFX gets executed/played User Delay: Delay in minutes before a user s vote counts towards a SFX
Currency System Here you can see the Currency System in which you can customize various things like the Command, Response. You can even create your own Custom Ranks. Aside from that you can set the pay-out amount and possible bonuses depending on a user s rank. Obviously you can also set the Interval at which it hands out payments. Display Points:!points (Will change depending on the currency command you set in the currency system) Adding Points:!points add (name) (amount) Removing Points:!points remove (name) (amount) Adding Points to Everyone in Chat:!points add +viewers (amount) Removing Points from Everyone in Chat:!points remove +viewers (amount) Getting Top 5:!points top Response Parameters: $user : Replaced by the person that uses the command $points : Replaced by the amount of points the user has $rank : Replaced with the current rank the user has $hours: Replaced by the amount of hours they ve been in your channel $level: Replaced by the user s level $nxtlevelreq : Replaced by the amount of points needed to level up $nxtrankreq : Replaced by the amount of points required for rank up $nxtrank : Replaced by the next possible rank that can be achieved, do mind if the user has a custom rank he can only achieve another custom rank not a normal one $raids : Amount of times the user has raided you (If you use!raider (name) ) $pointspos: Position in the ranking based on your amount of points $hourspos: Position in the ranking based on your amount of hours
Preprogrammed Commands (In Chat) Permission Levels +m : Moderators +r : Regulars +s : Subscribers +e : Editors +c : Caster +a(on edit) or Blank(on add) : Everyone!Commands (reg param timer) Description: This will show you a list of commands that you can use An example:!commands reg Response: Regular Commands:!links,!cookies,!steam,!twitter!Command add (command) (permlvl: optional) (response) Description: This will allow you to add a command to the bot through chat (Must be an editor or the caster) An example of adding:!command Add!Cookies +r Give me all the cookies! Response: (user) ->!Cookies has been added! Permission: Regulars Response: Give me all the cookies!!command remove (command) Description: This will allow you to remove a command from the bot through chat (Must be an editor or the caster) An example of removing:!command Remove!Cookies Response: (user) ->!Cookies has been removed!!command Edit (command) (permlvl: optional) (response) Description: This will allow you to edit a command within the bot through chat (Must be an editor or the caster) An example of editing:!command Edit!Cookies +c All cookies belong to me Response: (user) ->!Cookies has been edited! Permission: Caster Response: All cookies belong to me!timer Add (command) (permlvl: optional) (response) Description: This will allow you to add a timer to the bot through chat (Must be an editor or the caster An example of adding:!timer Add!Cake +e Give me all the cake! Response: (user) ->!Cake has been added! Permission: Editors Response: Give me all the cake!
!Timer Remove (command) Description: This will allow you to remove a timer from the bot through chat (Must be an editor or the caster) An example of removing:!timer Remove!Cake Response: (user) ->!Cake has been removed!!timer Edit (command) (permlvl: optional) (response) Description: This will allow you to edit a timer within the bot through chat (Must be an editor or the caster) An example of editing:!timer Edit!Cake +s I don t want that cake! Response: (user) ->!Cake has been edited! Permission: Subscribers Response: I don t want that cake!!enable (timer/command) Description: This will allow you to enable/disable the use of a certain Command or Timer An example of enabling:!enable!cake false Response: (user) ->!cake has been disabled and can no longer be used.!activate (timer) Description: This will Activate/De-Activate a timer, preventing it from automatically executing itself after the interval An example of activating:!activate!cake false Response: (user) ->!cake has been de-activated and will no longer execute itself automatically.!quote Description: This will return a random quote An example:!quote Response: Quote #33: I felt so pretty when he touched me there! [03/07/2014][The Last of Us]!Quote (num) Description: This will return the quote you select An example:!quote 17 Response: Quote #17: "I just got tongued by Rachel,... That just happened." [Resident Evil: Revelations][7/7/2014]!Quotes Description: This will return how many quotes exist and what the range is An example:!quotes Response: (user) -> There are currently 40 quotes; Range 0-39
!Quote Add (text) Description: This will allow you to add a quote to the bot An example of adding:!quote Add I didn t mean to touch him there! Response: (user) -> Quote #1 has been added: I didn t mean to touch him there! [02/08/2014] [Bioshock 2]!Quote Remove (ID) Description: This will allow you to remove a quote from the bot An example of removing:!quote Remove 10 Response: (user) -> Quote #10 has been removed!!quote Edit (ID) (text) Description: This will allow you to edit a quote An example of editing:!quote Edit 7 I felt like a real woman! [02/08/2014][Bioshock 2] Response: (user) -> Quote #7 has been edited: I felt like a real woman! [02/08/2014] [Bioshock 2]!Update Description: This will start the syncing process to your google document. If you have connected your google account to the bot and have a copy of the template An example of syncing:!update Response: (user) -> Started syncing information to the Google Spreadsheet.!Permit (name) Description: This will let you permit a user to post a link within 30 seconds An example of syncing:!permit promouse Response: Promouse -> You have been permitted to post a link within 30 seconds.!reg Add (name) Description: This will allow you to add a person to the list of Regulars An example of adding:!reg Add KrystalRayne Response: (user) -> Successfully added KrystalRayne as a Regular.!Reg Remove (name) Description: This will allow you to remove a user as Regular An example of removing:!reg Remove Edemonser Response: (user) -> Successfully removed Edemonster, they are no longer a Regular.
String Replacement There are parameters that automatically get replaced by the bot with certain things, which can range from the current game to the twitch url of the user or even his name: $mygame: Gets the current game you re playing $user: Gets the user that calls the command $mystatus: Gets your status from twitch $myurl: Gets your twitch url $botname: Grabs the bot s name $target: Grabs the target of a command, Useful when working with Single Parameter commands $randuser: Picks a random active chatter in your chat, but if there are none it ll target the caster $url: Grabs the $caster s twitch url $game: Grabs the $caster s current/last played game $status: Grabs the $caster s status from twitch. $time: Grabs your current time and displays it as Mon 10:30:42 AM $randquote: Grabs a random quote from your quote data base in case you want to use it within a timer $randextraquote: Grabs a random response from the ExtraQuoteLike System which is located under Extra Features
Death Counter Above here you can see the default layout of the death counter. You can fully customize the message that the!death command outputs or even customize which command you want to use for the counter. Once you Create/Use the command it ll be linked to an executive command which will work for the purpose of counting your deaths in games like Dark Souls. In this one would increment deaths by typing!death + in chat. This would increase the amount of deaths. The same goes for decreasing deaths when typing!death - or you can just set the deaths manually by typing!death 10. This would set the amount of deaths to 10 and overwrite the current amount. If someone would just call the!death command it would output Deaths: 10 in this case. So you never have to retype the message again, all you do is edit the amount of deaths.
Extra Quote-Like System This system will pretty much work the same as quotes, except you can customize the command that you will be using. This is just a secondary system that you can use together with the quote one in case you want random Gifs, Puns, Links or anything that comes to mind. It works the same as quotes so in chat you can type!gif Add (text) and it ll save it for you.!gif Remove (id) will remove it,!gif Edit (id) (text) will edit it. That is only in this case since the command that it s using is!gif. But if you d change it to!link it would work just like!link add (text). Contact If you re having any problems with the bot or there happen are bugs please let me know. This can be done by either sending me a message on twitch.tv/ankhheart or tweeting me @AnkhHeart.