The Guide To Correct Bot Ownership ^[revised]

Introduction

Hello there!
And welcome to the guide to correct bot ownership.

in this guide we will be showing you how to get, and correctly manage a dAmn bot.

A side note: In case you have questions about bots, their meanings, or other related subjects; You can always visit #Botdom on dAmn, or feel free to send me a note and i will try to get back to you as fast as i possibly can.

The Languages

Though it is one of the popular languages seen in dAmn bots, PHP Isn't the only language they come in.

There are varieties of Bots ranging from PHP and Python, to Visual Basic and C++.

Here is a small list containing only a few of those bots:

• PHP




• Dante by !SubjectX52873M ^{(Botdom Wiki Page)}


• Futurism by `electricnet ^{(Botdom Wiki Page)}


• NoodleBOT by ~NoodleMan ^{(Botdom Wiki Page)}




• Ruby




• Rubot (formerly zBot) by `Zeros-Elipticus ^{(Botdom Wiki Page)}


• RudeBOT by ~groowe ^{(Botdom Wiki Page)}


• Sapphire by =ManjyomeThunder ^{(Botdom Wiki Page)}




• Python




• Pybot by `radiositysg ^{(Botdom Wiki Page)}


• Medusa by !SubjectX52873M ^{(Botdom Wiki Page)}

As said, those are only a few taken from the selection of bots available.

For a full list check the Botdom Wiki Bot Listing.

Getting the languages

Now, there are multiple sections here, for PHP, Ruby, and more.

Don't read them all unless you want to get a bot in each language (Which i do not recommend if you are just starting).

Only read the section for the language you wish to get a bot in, and learn.

If you are however just starting i would recommend you would go with the first one under this, PHP.

Installation: PHP

Okay, so you want a PHP bot (If not continue down to another category)

And you want to know step by step, 'How do i do this, and get it running?'

Well then, lets get started!


First off we need to download PHP.

Now, to save some time i have made a pre-configured installer for PHP (windows).

Meaning you only have to download that, install, and get on with getting your bot running.

The installer can be downloaded here: (Botdom Wiki Page For: Botdom PHP)

Now that installer is a bit under 6 MB, and depending on your connection can take from a few seconds to a few minutes to download.

But believe me it will save you a lot of time.

Now, once you are finished downloading you should have a file named " Botdom_PHP.exe ".

Just run, click through the on-screen dialogs and wait a minute for it to install and you should now have a folder named PHP on your hard drive.

No worries, the PHP.ini is already configured, with all the extensions you need to run a bot set up.

This should save you a lot of time meaning you get your bot running faster.

Now, you can continue to the section for " Configuring your bot > PHP ".

Installation: Ruby

Okay, maybe a Ruby bot seems more fitting for you? (Again, if not continue to the next category)

Installing Ruby is simple, and depending on your operating system you need different packages.

For instructions on installation and downloads in one page go here.

No further configuration is needed for Ruby itself, so continue to the section on " Configuring your bot > Ruby ".

Installation: Python

Okay, Python is the next Runner Up.

For Python, like Ruby and PHP it is a one click installer.

Making it easier because all we need is one file.

That file can be downloaded by clicking: here.

Installation for python should be fairly easy, just follow the prompts in the installer and continue on to the section on " Configuring your bot > Python ".

Installation: .NET

Want a VB.NET or C# Bot?

You will first need to download the latest .NET framework, what is it?

.NET is the framework used a couple coding languages, some of which are VB[.NET], C#, and C++.

To install the .NET framework simply download this file: click here

And run the installation.

That package installs what you need to run bots like Blaze and VBBot.

After you're done with that, continue on to the section on " Configuring your bot > .NET ".

Configuring your bot

Again, there are multiple sections so go ahead and skip to the corresponding section and continue where you left off.

PHP

For PHP, we are going to start off with a well know PHP Bot, Dante.

Information on Dante can be found: here.

Alright, lets get started.

First we have to download the bot, we can do that by downloading one of the following packages (Which one doesn't matter, it's merely a choice of file type they were compressed in)

If you are just starting out i would recommend .ZIP since windows should have a built in utility for unpacking the files.

1. .ZIP: download

or

2. .TAR.GZ: download

After you have downloaded the corresponding file extract the archive to get the full folder of files for the bot.

In most cases on Windows XP you should be able to use te built in utility for unpacking the archive.

to do so follow these steps:

1. Right click the file " Dante_0.9_20080129.zip (or .tar.gz) "


2. Select the option Extract All...


3. You will get a few Windows, Click Next on each of them


4. On the Final windows Select Finish


5. It should open the folder for you, if there is only one folder in that window open it. Otherwise you should have a list of files.

In that list of files you should have one named Config or Config.ini, open it with notepad.

Out of all you get in that file we only need to pay attention to right now is this:


[bot]
;Username for the bots account
username = ""
;Password for the bots account
password = ""
;Owner"s username
owner = ""
;Trigger for bot commands
trigger = ""
homeroom = ""


Now, that's pretty well laid out and explained, but i will take you through it anyway.

username = ""

This is the username of your bots account, not YOUR account but your bots.
If your bot doesn't have one create one, just a normal dA account is perfectly fine.
For example, if your bots username is MyBot you would make that line:
username = "MyBot"

password = ""

Again, this is the password of the BOTS account, and not YOURS.
So example, if your bots password is MyBotsPassword you would change the line to:
password = "MyBotsPassword"

owner = ""

YOU, that's right, your username.
Example, i would put:
owner = "Kyogo"

trigger = ""

A VERY Important part of the config file.
This is what your bot responds to when you want to make it say something or execute a command.
it works like this, {TRIG}command
where {TRIG} is the trigger you specify, and command is the command name.
so for example if you wanted your trigger to be % you would put:
trigger = "%"
then if you wanted to e.g. make your bot say something, you would say %say Hello!

homeroom = ""

This is also important, this is the room your bot joins when you start it.
So example, if you wanted it to join #Botdom on dAmn you would put:
homeroom = "#Botdom"
Of course you should make this the name of your room if you want the bot to be in your personal room.

OKAY!

Now, we are done with the config.
Save the file and close out notepad.

Now all we have to do it RUN the file " Run Dante.bat / Run Dante " and everything should be up and running.

Now that we are done and running skip to the " Final Actions " section.

Ruby

If it's a Ruby bot you're after we're going to start with a good one, Sapphire by =ManjyomeThunder

First off we're going to download the zip archive of Sapphire: Click Here

Now once we have it downloaded we need to extract the files.

Again, with windows XP we have a built in utility to do this, just follow these directions:

1. Right click the file " Sapphire 1.0 RC1.zip "


2. Select the option Extract All...


3. You will get a few Windows, Click Next on each of them


4. On the Final windows Select Finish


5. It should open the folder for you, if there is only one folder in that window open it (repeat if necessary). Otherwise you should have a list of files.

Now in the list of files there should be one named " config.rb / config ", open it in notepad.

We only need to modify some things from the following section of that file:


'username' => 'Your Bots Username',
'password' => 'Your Bots Password',
'pk' => '', #Leave this blank
'owner' => 'Your Username',
'homeroom' => 'Botdom', #A Channel for it to join
'colors' => false, #Only put true if you are on UNIX or have the win32console ruby gem on Windows
'trigger' => '!',


Only change the values of the following for now:

'username' => 'Your Bots Username',

This is where you specify the username of your BOTS account, not yours.
IF you do not have one set up for yours bot simply create a normal dA account with whatever name you like.
Example: If your bots username is MyBot we change the line to reflect:
'username' => 'MyBot',

'password' => 'Your Bots Password',

As above this applies to the account of your BOT not you.
So for example if the BOTS accounts password is MyBotsPassword we would change the line to:
'password' => 'MyBotsPassword',

'owner' => 'Your Username',

Your username, that's right YOURS.
So the bot knows who to accept higher level commands from.
For Example i would put:
'owner' => 'Kyogo',

'homeroom' => 'Botdom',

the room the bot joins upon execution.
if you want the bot to join #Botdom on dAmn you can leave it, otherwise change Botdom to the name of your chat.
For example i would put:
'homeroom' => 'phail',
if i wanted it to join #phail on dAmn.

'trigger' => '!',

As with PHP This is what your bot responds to when you want to make it say something or execute a command.
it works like this, {TRIG}command
where {TRIG} is the trigger you specify, and command is the command name.
so for example if you wanted your trigger to be % you would put:
'trigger' => '%',
then if you wanted to e.g. make your bot say something, you would say %say Hello!

DONE!

Okay, save the file and close out notepad.

Now run the file: " RUN-BOT.cmd / RUN-BOT " and the bot should run perfectly

Now that we are done and running skip to the " Final Actions " section.

Python

Unfortunately there aren't any publically available Python bots that i know of at this moment so i cannot help with setup of one.

.NET

For the .NET language we are going to start you out with a well known VB.NET bot, Blaze (formerly inferno)

Of course first we must download Blaze, which can be found: here

After which as with both Ruby and PHP bots we must extract the files

Again with Windows XP there is the automated zip extractor to unpack the archive, just follow these instructions:

1. Right click the file " Blaze 2.02 Final.zip "


2. Select the option Extract All...


3. You will get a few Windows, Click Next on each of them


4. On the Final windows Select Finish


5. It should open the folder for you, if there is only one folder in that window open it (repeat if necessary). Otherwise you should have a list of files.

With Blaze configuration is simple, just run Inferno.exe

Upon running we get a window that looks like this: click here

I will explain the windows contents for you:

Username

This field is for the username of your BOTS account and not yours.
If you do not have an account for the bot simply create a normal dA account for it to use.

Password

This field is for the password of your BOTS account, not yours.

Owner

This field is for YOURS username, yep, yours.
This is so the bot knows that you are its botmaster and will respond to higher commands you ask it to perform.

Trigger

Same with PHP and Ruby Bots, This is what your bot responds to when you want to make it say something or execute a command.
it works like this, {TRIG}command
where {TRIG} is the trigger you specify, and command is the command name.
so for example if you wanted your trigger to be % you would put:
%
then if you wanted to e.g. make your bot say something, you would say %say Hello!

Room

As usual, this is the room the bot joins when you start it up.
so if you wanted it to join #Botdom on dAmn you would enter #Botdom

Alright!

After you are done, click the OK button.

After you click that the bot should be up and running and you should see the output within the console window.

Now that we are done and running skip to the " Final Actions " section.

Final Actions

Now that we have our bot running, we must do one last thing.

This is REQUIRED by DeviantART staff to anyone running a bot.

simply read this FAQ and follow the instructions: FAQ #795: How do I register my bot on the chat network?

Alright!

That's all for now, and you should have a bot configured and ready!

Wasn't so hard now was it?

Okay, Good luck to everyone and i hope this has brought some light to the issue of getting your first bot on dAmn.

Best wishes, ~Kyogo.