Professional Documents
Culture Documents
AnkhBot Twitch Bot How To Guide
AnkhBot Twitch Bot How To Guide
Console: The place where the bot will throw in chat logs
Dashboard: Allows you to change your stream title & game. If youre 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
Credentials: Where you can input information to connect to Twitch and/or Google
Sync To Google: Lets you sync all your data to a Google Spreadsheet
Extra Features: This is where extra features that arent part of the core will appear
Help: This is where you can find Documentation about the bot and an About section
Setup (Twitch)
Channel: Type in the channel you want to the bot to connect to ex: edemonster
Streamer Login
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.
Click Connect
If you dont get a popup saying that the login failed everything is ok
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 itll 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 youre 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 itll only pick a follower as the winner. If someone thats
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
Enabled: True/False allows you to Enable/Disable the command to be used within chat
Cooldown: The amount of minutes a command cant 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 users 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 users 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 theyve been in your channel
$level: Replaced by the users 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) )
+m : Moderators
+r : Regulars
+s : Subscribers
+e : Editors
+c : Caster
+a(on edit) or Blank(on add) : Everyone
Description: This will show you a list of commands that you can use
An example: !Commands reg
Response: Regular Commands: !links, !cookies, !steam, !twitter
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!
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
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
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!
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
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 dont want that cake!
Response: (user) -> !Cake has been edited! Permission: Subscribers | Response: I dont
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)
!Quote
Response: Quote #33: I felt so pretty when he touched me there! [03/07/2014][The Last
of Us]
!Quote (num)
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) -> Quote #1 has been added: I didnt mean to touch him there!
[02/08/2014] [Bioshock 2]
Description: This will allow you to remove a quote from the bot
An example of removing: !Quote Remove 10
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
!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.
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.
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:
$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 itll target the
caster
$randquote: Grabs a random quote from your quote data base in case you want to use
it within a timer
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 itll 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.
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 itll 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 its using is !Gif. But if youd change it to !link it would work just like !link
add (text).
Contact
If youre 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.