[Noer]

Introduction
BeBot Hyborian is a chat bot connecting to the Age of Conan ingame chat server. BeBot Hyborian is based on BeBot 0.5.2 for Anarchy Online. BeBot has a flexible plugin-structure making it very easy to integrate and develop 3rd party plugins for the bot. A wide range of plugins are already made for the Anarchy Online version which can be reused directly for BeBot Hyborian. You can find help and ready to install plugins at the BeBot support forums here.

Latest Changes
Revision 18:
- Updated the IP for the Ferox server.

Revision 17:
- Included changes to Gemcutting module done by Varka.
- Included module to handle resources for city building by madrulf.
- Included changes to Craftclasses module done by GBH.
- Fixed a cosmetic detail on the Whois.
- Fixed so items with hyphen in the name are detected too.

Revision 9:
- buddy package handling has been fixed in order to fix /afk and lfg status changes. Modules will be able to catch these status changes aswell.
- The raid module has been fixed.
- Fixed a number of typos in the gemcutting module.
- Fixed Points.php
- OnlineCount.php module was ported to AoC.

Standard Modules
BeBot Hyborian is shipped with a couple of modules:
* items (a simple itemdatabase that centrally stores all the items the BeBots with this module installed sees and makes them searchable ingame)
* whois (lookup players's levels and class)
* gemcutting (get information on how to cut the gems you find)
* is (is a player online)
* IRC relay (relay guildchat to and from IRC)
* raffle, roll, nroll (varies ways of rolling randomly)
* chuck (get your favourite Chuck Norris facts)
* quotes (save famous player quotes forever and have fun reading them later)
* calc (do calculations ingame with a simple calculator interface)
* craftclasses (add crafting classes on the whois information of people)
* and a lot more

Documentation
You can find a lot of documentation on the official BeBot site and the official Bebot forums. You will not be finding any documentation here.

Requirements
PHP 5.2.0 or later.
MySQL 5 or higher.

Download
You can download the entire BeBot Hyborian code from the repository here.

Credits
Age of Conan adjustments for BeBot was done by Noer and Vrykolas. Refer to the credits file in the source for the full credits on the original code. The bot uses the aochat.php library originally made by Auno and modified for Age of Conan by Noer.

License
BeBot Hyborian is distributed under its original GPL v2 license. This means in short that you are allowed to modify and release updates to the bot as long as you credit the original contributors. If you release anything using a modified version of this bot you have to release the complete source code of your modified bot under a GPL v2 license aswell.

[Noer]

Bebot Hyborian for Age of Conan FAQ

Q: What is required to run Bebot Hyborian?
A: Bebot requires PHP 5.2.x or later and MySQL 5.x or later to run. Operative System does not matter. I have made a PHP bundle package for Windows available here which contains the needed PHP files. Furthermore you need an active and paid game account for Age of Conan and a play character the bot can login as.

Q: How can I be sure that the bot does not contain malware etc?
A: You are free to read through the entire source code. And be sure to only download the bot from the official download site: http://code.google.com/p/bebot-aoc/

Q: Is a dedicated game accounted required to run the bot?
A: No you can play the game on another character while the bot is logged in.

Q: I have a version of Bebot for Anarchy Online. Can I run Bebot Hyborian on top of that?
A: No you need to start from scratch with Bebot Hyborian. Meaning you need to have an empty database when you start the bot the first time. Due to some of the central database design had to be changed to handle AoC this is unfortunately necessary.

Q: Is it possible to read information from the "Guild Announcement"-channel and use?
A: Unfortunately the "Guild Announcement"-channel is only available for the game client at the moment. So we can not use it at all for the bot.

Q: Is it possible to make a module that does XXX?
A: It is possible to make a lot of things with the modules. You can relay latest forum-posts from your guild forum to the bot, make DKP available ingame, get latest weather from weather.com etc. It is mostly the imagination that sets the limit here and the coding skills. For module requests please use the Module request forum and for posting your modules please use the AoC modules forum. When uploading modules as attachments please rename the extension to .phps.

Q: I experienced a bug with the bot - how should I report it?
A: Please either submit an issue here or write a post in the Bebot AoC support forum.

Q: How does the item database module work? Can I get a local copy of it?
A: The item database module submits all the items it sees in guildchannel and on public channels it can access to a centrally stored item database. The only thing the central database stores is the item ID, hash, level requirement, name of item and the IP of the submitter. The IP is stored in order to track missuse of the service. The idea behind this module is the more Bebot's running the better an item database everyone gets. When you search for an item in the module it queries the central database and returns it to the bot. You are not able to download the item database locally as it would discourage people from collaborating for the central database.

Q: My server doesn't seem to be supported by Bebot. How can I connect to it?
A: Currently I don't have IPs on all the servers so I could use some help with the servers missing. Currently the following servers are missing in Bebot: Strix (french server), Bardisattva, Damballah, Hanuman, Scorge, Stormrage and Hyperborea (US servers). If you are trying to get Bebot online on any of these servers please contact me either by PM on these forums, by submitting an issue here or by posting in the Bebot AoC support forum so we can get it added to the source.

[Futgar]

Sounds good, will try it in the evening.

Thanks in advance.

[Aryil]

Can you Post it as .zip? Otherwise i have to Download every single file from Google O.o

[Azgura]

Originally Posted by Aryil Can you Post it as .zip? Otherwise i have to Download every single file from Google O.o

Use an SVN client such as TortoiseSVN

[Noer]

Originally Posted by Aryil Can you Post it as .zip? Otherwise i have to Download every single file from Google O.o

I will post a snapshot of the repository when its in a later version. Right now its running a very early beta and you will want a SVN tool like TortoiseSVN to keep the bot updated with latest version. :-)

[Tardan]

Originally Posted by Noer Standard Modules Bebot Hyborian is shipped with a couple of modules: * items (a simple itemdatabase that centrally stores all the items the bebots with this module installed sees and makes them searchable ingame) * whois (lookup players's levels and class) * is (is a player online) * IRC relay (relay guildchat to and from IRC) * raffle, roll, nroll (varies ways of rolling randomly) * chuck (get your favourite Chuck Norris facts) * quotes (save famous player quotes forever and have fun reading them later) * calc (do calculations ingame with a simple calculator interface) * craftclasses (add crafting classes on the whois information of people) * and a lot more

thx a lot for release this bot. i have 2 questions to this release:
1. you plan to release you bot in a way, that we can update from bebot x.x to bebot hyborian x.x ?
2. is there a list with commands for your bebot to use ingame? because you only wrote "and a lot more" what is more? i never used bebot in AO, so i am a little bit confused how to handle the bot ingame.

[Noer]

Originally Posted by Tardan thx a lot for release this bot. i have 2 questions to this release: 1. you plan to release you bot in a way, that we can update from bebot x.x to bebot hyborian x.x ? 2. is there a list with commands for your bebot to use ingame? because you only wrote "and a lot more" what is more? i never used bebot in AO, so i am a little bit confused how to handle the bot ingame.

1. Easy and quick answer: no. :-) Its two different games with two different ways of handle characters and guilds. So that wont happen.

2. "!help" would normally give you a list of all the commands, but currently it crashes the chat connection for the reciever. Same thing happens with a few things in the game client - so I need to track that down. But a good tip is to look in the modules folder, and also have a look at the official Bebot forums at http://bebot.shadow-realm.org/forum/

[r0ze]

This bot is awesome. I used to use (as an end-user, to clarify some of my stupid questions) Bebot in Anarchy Online as well and I'm very pleased to see it transferred to AoC.

Encountered a couple things though:

1) Trying to use !quotes crashes the bot with this error:

Fatal error: Cannot use string offset as an array in C:\beBot\modules\Quotes.php on line 168

2) !help breaks something, not sure what. Posted already.

3) I cannot quite get the logonspam to work even though I have enabled it under !settings. I quite prefer the bot to announce logons and logoffs since I noticed with the previous bot I tried in AoC that it caught logoffs much quicker than the game itself did. We also get logon messages which is a plus.

4) Why is the Points.php plugin disabled (in modfolder, _Points.php)? I enabled it and only got one error message as it was initializing. Functionality seems to be working.

5) The class "Herald of Xotli" is misspelled as "Herald of Xolti".

6) !online-list is messed up, image references don't work.

Will try it out some more and provide feedback. Looking very sweet so far.

[r0ze]

OK, I realized why I wasn't getting the logon messages (amongst other things ). Every guildmember has to be added to the bot, while I thought this would happen automatically.

I added a couple people, and amongst them, my alt. When I logged on to my alt I got the logon notify, but the bot would still not listen to the character, even though I had just added it to the member list. What am I doing wrong? Am I misunderstanding how the memberlist/roster/whatever works? !member still says the bot has 0 members, but !buddylist shows 72 buddies.

Do I have to manually add every guildmember to the bot or is there a feature to have the bot automatically add guildmembers as they log on or talk in the chat?

Thanks again though, this is looking more and more awesome.