Installation instructions for AHBot
===================================

1) Apply the patch to your checked out SVN; if you don't know how to do that,
then read up on your SVN client, but in TortoiseSVN it is right-click
the checkout folder and "Apply patch" and follow a few simple steps -
"Patch All" is usually what you want.

2) Recompile into your own binary file.

3) There is an AHBotItems.SQL file included as part of the patch;
it should be in the same location as this AHBotReadMe.Txt file,
but if you can't find it then use the search function in your OS to find it.

4) Execute AHBotItems.SQL in your favorite SQL tool - I prefer SQLyog.
This will create the table and default items needed to pre-populate the AH
with items you always want to be available.
This means you wouldn't have to create custom vendors, just preload the AH
with those items and they will always be refreshed on the next update cycle
if/when they are sold out.

As an alternative, I have created an AHBotItems.BAT file that will use MySQL
itself to execute the AHBotItems.sql file. Edit the SET commands at the top
of the file if you are going to use this method.

5) There is an extract of the AHBot configuration information that is needed in
your world configuration file (ie. ascent-world.conf or arcemu-world.conf)
in a file called AHBot.conf.

6) Copy and paste the contents of the AHBot.conf file into your world config file;
most people just paste it at the end. There is a commented section to describe
the available options and set them as needed.

7) The default option in the AHBot config information is to post auctions
as a user just called AHBot - create this character. The AHBot character
can be anything (Alliance or Horde) and it doesn't have to be a GM.

Please note that you can log in and play as this character if you want,
but you can NEVER, NEVER talk to an auctioneer with this character;
the WoW client only expected about 100 auctions for a character and
the thousands of auctions typically on the AH by the AHBot character
will crash the client.

8) There are in-game commands.

AHBot In-game Commands
======================

.ahbot auto - Executes the automatic startup sequence
.ahbot clear - Clears all the auctions from all auction houses
.ahbot config - Displays AHBot configuration information
.ahbot count - Counts the number of auctions
.ahbot list - Lists the Auction Houses with their ids
.ahbot loglevel - Change the AHBot log level
.ahbot load - Loads the Auction House with x items
.ahbot reload - Re-loads all auction houses from SQL
.ahbot preload - Loads the Auction House from the AHBotItems table
.ahbot refresh - Loads the Auction House from the AHBotItems table
.ahbot time - Display the current UNIXTIME used to calc expire
.ahbot settings - Reload AHBot settings from world config file
.ahbot unload - Unloads auto-loaded items from the Auction House

9) There are console commands.

AHBot Console Commands
======================

ahbot auto - triggers the automatic startup event
ahbot clear - clears ALL auctions from ALL auction houses
ahbot config - shows AHBot configuration information
ahbot count - counts the auctions on all the auction houses
ahbot help - displays this information
ahbot list - lists the available auction houses
ahbot loglevel - Change the AHBot log level
ahbot load - loads an auction house <required itemsToAdd> <optional AHId>
ahbot reload - Re-loads all auction houses from SQL
ahbot preload - triggers the pre-loading of the auction houses
ahbot unload - unloads an auction house <required AHId>
ahbot refresh - Change the refresh interval
ahbot time - shows the current UNIXTIME
ahbot settings - Reload AHBot settings from world config file
ahbot unload - Unloads auto-loaded items from the Auction House