Auction House Bot system

From OregonCore Wiki
Jump to: navigation, search

The AHBot or AuctionHouse Bot

One of the many features of OregonCore is the AuctionHouse Bot. It requires you to create a character, setup the oregoncore.conf file appropriately and set up the `characters`.`auctionhousebot` table.

If you are still a first timer on OregonCore, it is best you use this feature after you feel comfortable you have a good understanding of the basic operation of the system. WRONG SETTINGS MAY CAUSE CRASHES.

What is it?

It is a server-controlled bot useful to keep auctionhouses on low populated realms constantly full of items for characters to buy. It can also act as buyer, so that characters will always have someone buying the items they put on auction.

Client-side Preparation

The first step is to create an account and character for the AuctionHouse Bot. We will assume you created an account called ahbot. Login with that account and create a character, which we will assume you called Ahbot. NOTE: No character from the AuctionHouse Bot account can buy items in-game from the Auction House. This is why you need a separate account.

The race, class...it does not matter what it is, as long as you create the character and log it into the world. Once you are at the starting area, you can logout and never use the character again.

Configuration Settings

The first thing you need is to know the account's ID and character's GUID of the Auctionhouse Bot.

You can find out via SQL query:

SELECT * FROM `realmd`.`account` WHERE `username`='ahbot';
SELECT * FROM `characters`.`characters` WHERE `name`='Ahbot';

Or by logging the ahbot character and using the ingame command:

.pinfo ahbot

The output of this command will give you the account's ID and character's GUID.

We will pretend that the account's ID is 1234 and that the character's GUID is 5678 in this example.

Now open your oregoncore.conf file and edit the lines as stated below:

AuctionHouseBot.DEBUG = 0
AuctionHouseBot.DEBUG_FILTERS = 0
AuctionHouseBot.EnableSeller = 0 ''<-- SET this to 1''
AuctionHouseBot.EnableBuyer = 0 ''<-- SET this to 1''
AuctionHouseBot.UseBuyPriceForSeller = 0
AuctionHouseBot.UseBuyPriceForBuyer = 0
AuctionHouseBot.Account = 0 ''<-- SET this to 1234''
AuctionHouseBot.GUID = 0 ''<-- SET this to 5678''
AuctionHouseBot.ItemsPerCycle = 200

WARNING: If you enable the Auctionhouse Bot but forget to set the account's ID and character's GUID, or type them wrong, your Server may crash at startup

SQL Settings

You can customize how the Auctionhouse Bot will behave on each separate auction by changing the settings in the auctionhousebot table in the characters DB. At minimum, you will need to set the minitems and maxitems for each of the three auction houses.

Conclusion

As you will notice by looking the the oregoncore.conf file and the DB table, the Auctionhouse Bot allows an incredible amount of configuration options to make it as flexible as possible.

This guide instructs you how to activate the Auctionhouse Bot and have it working with default options. For further details on how to optimize the Auctionhouse Bot to better meet your needs, look at the README.AHBOT file you will find in your Source main directory.

If you are ready to let players connect, continue to Configuring Your Network for Client Connections -->