Preparations:
To run the bot you will need a player the bot logs into. So start of by makeing a new character on the appropriate dimension of AO. Run through all the character customization and give him the name you would like your bot to have. Once you have landed on RK you can log out and continue the installation of the bot. Of cause you can also level your bot char a bit or take an already existing character for your bot. If you wish for the bot to pickup the tower messages you must put it into a guild.

Now that you have a character download the newest BeBot version and unzip the file to the location you would like to run it from keeping all directory structures.
Please make sure that your system matches the minimum system requirements.

Configureing the bot:
There are three files you will have to edit before you can actually start the bot.

- start.php

Only two changes need to be made here. Set $php_bin to the binary php file. If you start the bot from the same directory as the php binary ("php.exe" under windows) you can just enter the name. Otherwise you will have to enter the name and path of where the binary is located.
Set $main_php to the location of the "main.php" file. Once again you can just enter "main.php" if you're starting the bot from the directory its in.

- Bot.conf:

This file is located in the "conf" directory.
Here you will have to enter the Anarchy-Online username and password and the name of the bot along with the dimension number you would like to run it on.

Under that you can configure your super admins. You can add as many superadmins as you like. Just copy and past that line and exchange the name.

The next section works just like the superadmins. You can tell the bot what other bots it may encounter in the raidbot. This is so that the bot just ignores tells and messages from the other bot and doesn't end up in a spam war with it.

After that set "$guildbot" to false since we're setting up a raidbot,  leave "$guild_name" blank and set "$guild_id" to 0.

The next to lines configure the standard colors of the tells and privategroup messages the bot sends.

To switch logging off set "$log" to "off". You can also set it to "chat" which will only log incomeing and outgoing messages.  If set to "all" everything displayed on the console will be put into the log. The default is "chat".
Set "$log_path" to the place where you want logs to be saved.

With "$command_prefix" you can determin what symbol commands start with. The default here is "!".

The last 4 values are probably best left at default.

- MySQL.conf
This file is also located in the "conf" directory.
Set the MySQL username, password, server IP adress and database name for the bot.


Items Database:
For the items database to work you must first upload it into the MySQL database from the "items.sql" file included in the zip archiv.
To do this either upload it through a phpmyadmin interface (or similar) or directly connect to the MySQL server and type "source /path/items.sql".


Starting the bot:
Open a console (In windows press "Start" => "Run" => enter "cmd" and press enter).
Now run the start.php
Windows: Navigate to the directory of your bot assuming you have the php.exe in the same directory and write "php start.php".
Linux: Assuming your can run php4 from anywhere navigate to your bot directory and write "php4 start.php" (assuming your php binary is named "php4").

The console should now state that the bot is loading the modules, authenticating and connecting. Once this is done (it should only take a few seconds) You can log onto an character ingame which you have configured as "superadmin". Now add yourself as member of the bot by writing a tell to your bot with the content: "!member your_nick_here" (assuming that you have set command_prefix to "!").
You can now use all functions of the bot. For information on how to use the bot just send it a tell with the content: "!help" and it will show you a list of all usable commands and links to more information on them.


Adding and Removeing Modules:
If you do not wish for certain modules to be used by a bot just put an underscore ("_") at the front of the name in the "modules" directory.
There are several files already in the distribution that have been commented out in this way:

_ClassName.php is a template to make your own modules.
_RaidSingle_Raid.php is a module to replace RaidTime_RAID.php if you wish to not have raidpoints destributed over time but rather have the raidleader hand out points manually to everyone on the raid.
The three files with "1k" at the end are replacement modules for the three others incase your raidbot has more than 1000 members. In that case remove the underscore from those three files and add it to the other three appropriate modules.