/
ReadMe.txt
318 lines (236 loc) · 11.7 KB
/
ReadMe.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
Please note, this is a text version of the documentation available at
http://bebot.shadow-realm.org/wiki/installation - Due to the nature of a
wiki, information may be updated at a rapid pace, so whenever possible
please refer to the wiki for up to date instructions and general
documentation.
INSTALLING BEBOT 0.6
====================
This bot works for both, Anarchy Online (AO) and Age of Conan (AoC). Some
settings and modules only make sense for AO and some make only sense for
AoC. Whenever something is only applicable for one of the games, it is
marked as „AO only“ or „AoC only“.
PREREQUISITES (WHAT DO YOU NEED?)
---------------------------------
To install and run BeBot you need the following:
* Anarchy Online (free or paid) or Age of Conan
* PHP version >= 5.2
* MySQL database server version >= 4.1.1
* The BeBot files
Optional (helps run it effectively):
* An „always-on“ internet connection
* A dedicated machine to run the bot
CREATE A PLAYER
---------------
A bot is basically a regular player character so you’ll need to start AO/AoC
and create a character on the appropriate dimension/server. The breed,
gender, and profession (AO only) or the class and race (AoC only) is
irrelevant for the function of the bot. The name of the character will be
the name of the bot. You can use an already existing player.
Notes for guild-style bot
-------------------------
A guild bot needs to be a member of the guild it is to be a bot for. For AO
this means that it needs to have the same faction as the guild.
Notes on towers (AO only)
-------------------------
For tower wars to work as intended the bot needs to be in the top three
ranks of an org. This is because the [ALL TOWERS] channel is restricted to
these ranks.
INSTALL THE BOT FILES
---------------------
To install the bot simply unzip the files to a directory maintaining the
directory structure.
CONFIGURING THE BOT
===================
STARTBOT.PHP
------------
Open the file StartBot.php which is located in the install directory in a
text editor. Here you need to set the $php_bin to the path and name of your
php executable.
If you start the bot from the same directory as the binary php file (for
windows „php.exe“) you can just enter the name. Otherwise you’ll have to
enter the name and path of the binary executable (ie C:/Program
files/PHP/php.exe or C:\\Programfiles\\PHP\\php.exe or /usr/local/bin/php5).
Note that you can use forward slashes (recommended) or double backslashes
(not recommended) on windows systems. Using single backslashes WILL NOT WORK
as php interpets \ as a special escape character.
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.
If StartBot.php is in another directory than the bot itself (not
recommended) you must specify the complete path to Main.php.
CONF/BOT.CONF
-------------
Open the file Bot.conf, which is in the conf directory where you installed
the bot, in a text editor. Here you will have to enter the AO/AoC username,
password, and the name of the bot along with the dimension number (AO only)
or server name (AoC only) you would like to run it on.
$owner is the super-duper admin of the bot. This user has got all rights.
This should be the name of the character, which you intend to configure the
bot with, as some settings require you to be owner in order to change.
Below that is the configuration lines for your super admins. You can add as
many superadmins as you like. Just copy and past that line and exchange the
name. These names cannot be downgraded in-game so it is recommended that you
hard-code as few super admins here as possible. Instead of putting the names
in here we recommend using the !adduser <username> SUPERADMIN in-game to add
superadmins.
The next section works just like the superadmins. You can tell the bot what
other bots it may encounter in the guild. 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.
For setting up the guild bot section please see bottom of this section.
To switch logging off set „$log“ to „off“. You can also set it to „chat“
which will only log incoming 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 determine what symbol commands start with.
The default here is „!“. Note that you need to use the regex string here.
This means that to use „.“ as your command prefix you need to enter „\.“
because „.“ has got a special meaning in regular expressions. This goes for
a lot of other characters as well.
The last 4 values are probably best left at default.
Guild bot
---------
To make a guild bot set „$guildbot“ to true. Change „$guild_name“ to the
exact name of your guild.
AO only: Set „$guild_id“ to the id of your guild. The easiest way to find
out the guild ID is going to http://www.anarchy-
online.com/content/community/people/ and finding your guild. The URL will
now read something like this: „http://www.anarchy-
online.com/org/stats/d/1/name/xxxxxx“ where the „xxxxxx“ would be your guild
ID.
To relay chat to another guild bot you want to set $guild_relay_target =
„Name_of_other_guildbot“; If you do not want this feature set
$guild_relay_target = False; (note: False, not „False“. If you use quotes
your bot will attempt to relay to the player named ‘False’)
Raid bot
--------
To make a raid bot set „$guildbot“ to false and leave „$guild_name“ blank.
Set „$guild_id“ to 0. For a raid bot you most likely want to set
$guild_relay_target = false; (note: false, not „false“)
CONF/MYSQL.CONF
---------------
Set the MySQL username, password, server IP adress or server host name and
database name for the bot (see below).
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 php5 from anywhere navigate to your bot
directory and write „php5 start.php“ (assuming your php binary is
named „php5“).
The console should now state that the bot is loading the modules,
authenticating and connecting. Once this is done (AoC only: wait 5 minutes
now) you can log onto an character in-game which you have configured as
„superadmin“. You should now be able to talk to the bot.
PLAYING WHILE RUNNING THE BOT (AO ONLY)
---------------------------------------
You can run the bot and play AoC from the same account (with different
characters).
PLAYING WHILE RUNNING THE BOT (AOC ONLY)
----------------------------------------
You can run the bot and play AoC from the same account (with different
characters). However the bot must connect first and you have to wait at
least 5 minutes after logging the bot in, before you can connect with your
client. If the bot (re)connects while you are logged in, you get
disconnected.
IN-GAME SETUP
=============
There is a settings module to handle configuration of most aspects and many
modules for BeBot. Most notable is the Security module. To start configuring
it send a tell to your bot with „!settings security“. For a list of modules
whose settings are configurable by the new interface send a tell to your bot
with „!settings“.
ADDING AND REMOVING 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: Most notable is _ExampleModule.php which is a template to make
your own modules.
INSTALLING 3RD PARTY MODULES
----------------------------
We recommend you put any 3rd party modules into the directory named custom
instead of putting it directly into the modules or core directories. This is
because if a 3rd party module has got the same name as a standard module or
a module with that name is added later it will be over-written if you
upgrade the bot. Modules in the ‘custom’ directory are never touched by
installing upgrades to BeBot.
INSTALLING MYSQL ON WINDOWS
===========================
First, you’ll need MySQL. Download the Windows Essentials package from
MySQL.com. This is a MSI based installer. If it doesn’t work for you, go to
Microsoft Update to install the latest Windows Installer.
The installer is simple.
PHASE 1: MYSQL INSTALLER
------------------------
1. Click Next.
2. Select Typical, Click Next.
3. Click Install.
4. Select Skip Sign-Up, Click Next.
5. Check Configure MySQL Server Now, Click Finish.
Now you should be in the MySQL Server Instance Configuration Wizzard.
PHASE 2: MYSQL SERVER INSTANCE CONFIGURATION WIZZARD
----------------------------------------------------
1. Click Next.
2. Select Detailed Configuration, Click Next.
3. Select Developer Machine, Click Next.
4. Select Multifunctional Database, Click Next.
5. Select C: and Installation Path, Click Next.
6. Select Decision Support, Click Next.
7. Check Enable TCP/IP Networking and Enable Strict Mode, Click Next.
8. Select Standard Character Set, Click Next.
9. Check Install As Windows Servers, Check Launch the MySQL Server
automatically, Check Include Bin Directory in Windows PATH, Click
Next.
10. Enter and confim your root password. Write down your root password
and do not loose it!!! Do not check Enable root access from remote
machines. Click Next.
11. Click Execute.
12. Click Finish. Reboot your computer.
At this point, you have MySQL installed and configured, but you haven’t yet
created a MySQL database.
PHASE 3: LOGGING INTO MYSQL
---------------------------
1. Open a command prompt. (Start > Run > CMD, Click OK)
2. In the command prompt, enter the command mysql -u root -p
3. Enter your root password (You did write it down so you wouldn’t
forget it right?)
You should now have a MySQL prompt that looks like: mysql>
PHASE 4: CREATE A DATABASE AND DATABASE USER FOR BEBOT
------------------------------------------------------
1. Type CREATE DATABASE databasename CHARACTER SET latin1; (replace
databasename with the name of the database you wish to create)
2. Press Enter/Return.
3. CREATE USER username@localhost; (Change username to the username you
want, keep @localhost)
4. Press Enter/Return.
5. SET PASSWORD FOR username@localhost = PASSWORD(’newpassword’);
(Change username and newpassword to your selected username and
password, again keep @localhost)
6. Press Enter/Return.
7. Type GRANT ALL on databasename.* TO username@localhost; (Again,
change username, keep @localhost)
8. Press Enter/Return.
9. Type quit then Enter/Return to exit the MySQL Monitor.
PHASE 5: CONFIGURE BEBOT
------------------------
1. Edit MySQL.conf, add the values you selected.
$dbase = "databasename";
$user = "username";
$pass = "newpassword";
$server = "localhost";
That’s it, you should now be able to start the bot provided PHP is set up
correctly.
Backing Up and Restoring your Database
--------------------------------------
It’s reccomended that you backup your database. If the worst happens, you
can easily recover. And the command to do so is simple:
mysqldump -u username -p --databases databasename --add-drop-table -a -f > filename.sql
Restoring a database fom a backup
---------------------------------
To restor the database from a previously made backup:
mysql -u username -p databasename < filename.sql
IMPORTANT: All changes made to the guild and bot after the backup WILL BE
OVERWRITTEN!