Hi Sharyl & George, 

I wrote a simple bot that will alow you to make an unlimted amount of simple text commands.



I have put 3 example commands in the "vuurdraak.ini" file, it looks like this:



#This is the ini file for Vuurdraak's Vuurdraak Bot. One option per line. Do not delete this line, 2nd line defines the bot responce limit, which is set to 2 seconds as a default. The other lines are simple text commands, you can add as many as you like, one per line.

anti_spam_speed=2

!vuur=Vuurdraak is my creator <3 I love Vuurdraak and all the people around the world <3

!sharyl=Sharyl Sykora is the most amazing Cosplay streamer on Twitch <3 <3 <3

!test=This is a test sentence just put something else here :D

[End of INI]




If you would accidently delete the top 2 lines, then the first two lines will basicly be ignored by the bot, and not be any command and the bot will default to 2 second anti spam speed responce.
I added the copy of the "vuurdraak.ini" file in this "readme.txt", incase you deleted stuff, and wonder what it was again :D
Make sure that "[End of INI]" is the last line, because the bot will stop reading the Ini file after that.




How to set up your own bot ?



Download Hexchat, it's 100% free for Windows, Linux & OSX (my bot script should work also in all those OS'es and can read the "vuurdraak.ini" file in windows, Linux or OSX txt format):
   https://hexchat.github.io/downloads.html 


Install Hexchat as admin, when asked to: "Select Components", scroll down the window and select "Python Interface" & "Python (requires Python 3.4)"
Just keep clicking next and let HexChat install it self.
When Python 3 is beying installed make sure to scroll down the options windows during installation, and set Python to add it self to the Windows $PATH (Last option that is disabled with a red cross, enable it).
When Python is not addded to the $PATH, HexChat will start up with an error that it can not find the python34.dll, if this happens uninstall HexChat and try again making sure that during the Python install the option to add Python to the path is enabled (disabled by default)!!

If all went well you now have HexChat running with Python 3, you can now load my bot script.
Go to the "Window" tab and click on "Plugins and Scripts...", and load my "vuurdraak.py" (the actual python bot script).

To make sure that bot automaticly loads each time you start HexChat, you need to place it in the ...\HexChat\addons directory
If you do not know where it is, simply load the vuurdraak.py script from any place, and look at the error message it generates, when it can not find the "vuurdraak.ini" file.
The addon directory will be in the directory where the script/bot wants to read the "vuurdraak.ini" file.
The "vuurdraak.ini" file likes to be in a special directory, on my Windows 7 install that is:
  C:\Users\<YOUR_NAME_IN_WINDOWS>\AppData\Roaming\HexChat

The "vuurdraak.py" script wants to be in the:
  C:\Users\<YOUR_NAME_IN_WINDOWS>\AppData\Roaming\HexChat\addons

This might be different if you do not run Windows 7.

But not to worry when you load the bot for the first time, it will tell you if it can not find the "vuurdraak.ini" file, and tell you where it is expecting it, just put it in the directory where the bot tells it wants to read it from.

When all went well you now have a Twitch/IRC bot ;)
The bot will have messaged in HexChat that it's running propperly:


  Vuurdraak Bot 1.0.0 has been loaded succesfully
  Vuurdraak Bot's vuurdraak.ini loaded successfully
  Anti spam speed is set to one command per 2 seconds


Now it's time to get the bot in to your Twitch channel :)

This is the official Twitch bot help page: 
   http://help.twitch.tv/customer/portal/articles/1302780-twitch-irc

You now need to make a new Twitch acount that will be the bot, give it a nice name "VuurdraakBot" or "SharylBot" or "CuttyPie" I'm sure you come up with a nice bot name :D
When you have set up the new acount, and are logged in with that bot Twitch acount (close the other Twitch acounts your logged in to to be sure it all goes well) go to:
   http://www.twitchapps.com/tmi/

This will give you a Twitch IRC server OAuth Key, you need to copy it and enter it later as the server password in to HexChat, this will identify your bot acount to Twitch on IRC.

Now go to HexChat and open "HexChat" -> "Network list...", Add a new server and select it and press "Edit" replace "newserver/6667" with "irc.twitch.tv/6667" (without quotes).
Make sure that as a nickname you set your bots Twitch acount name that you chose, and enter the OAuth Key in to the password field.
You can also say in the "Autojoin channels" to join #sharyl_sykora on HexChat start, if not, join your own chat channel on Twitch by typing "/j #sharyl_sykora" in HexChat.

When you have set up everything correctly, the bot will load & join your Twitch channel automaticly when ever you start HexChat, just keep HexChat exclusive for the bot, that makes things more manageable.

You now can start adding new name !commands in the "vuurdraak.ini" file.
Make sure you keep the same format as in the examples, with one command per line.
As long as your PC is not running out of memmory you can add as many name/text commands you like :)

As an extra added bonus the bot contains a !calc command, that will let people do math in the chat, like "!calc 1 + 1"

Happy Twitch botting, 
  greetings Vuurdraak_ (Rene Christians)




