AH Bots
The AHBot (Auction House Bot) in CMaNGOS is a built-in feature designed to simulate player-driven activity in the in-game Auction House. On single-player servers or servers with low populations, the Auction House can appear empty or stagnant, which detracts from the normal gameplay experience.
AHBot helps address this by automatically posting auctions for a variety of items—ranging from common consumables and crafting materials to high-level gear—ensuring that players have a selection of goods to buy and sell. It can also purchase items listed by real players, injecting gold back into the economy and mimicking organic market demand.
The behaviour of the bot can be configured within the ahbot.conf file, which will align the bot to the server's needs.
Configuration Options
Below is a table of the most common (and essential) AHBot-related configuration options. Note that some options appear multiple times for different item categories or rarities; each category can be customized independently using the same parameter names but with category and rarity suffixes (e.g., AhBot.MaxAuctionCount.equip.blue).
| Option | Description | Example Values |
|---|---|---|
AuctionHouseBot.Seller.Enabled |
Enables or disables the old AuctionHouseBot (the legacy bot). Setting to 0 disables it. |
0 (disabled) 1 (enabled) |
AuctionHouseBot.Buyer.Enabled |
Enables or disables the old AuctionHouseBot buyer logic. Also part of the legacy bot system. |
0 (disabled) 1 (enabled) |
AhBot.Enabled |
Enables or disables the new AhBot system. |
0 (disabled) 1 (enabled) |
AhBot.MaxItemLevel |
The maximum item level of items that AhBot is allowed to post or buy. | 500 |
AhBot.MaxRequiredLevel |
The maximum required player level for items AhBot will list or purchase. | 80 |
AhBot.PriceMultiplier |
A global pricing multiplier applied to all items (unless overridden by category-specific multipliers). This affects how much items are listed or bought for, relative to their default value. |
0.35 (35% of default) Typical range: 0.1–2.0 |
AhBot.DefaultMinPrice |
The fallback minimum price in copper (if the price calculation falls below this value). Helps avoid near-zero listings. | 20 (which is actually 20 copper = 0.20 silver) |
AhBot.PriceQualityMultiplier |
Applies an additional multiplier based on item quality; if 1.0, there is no added factor. Some server admins increase this to make higher-quality items more expensive. |
1.0 (no change to prices) Could be 1.5, 2.0, etc. |
AhBot.AlwaysAvailableMoney |
How much gold (in copper) the bot can always access for buying items. If set high, the bot effectively never runs out of funds. | 2000000 (20,000 gold) Any large integer |
AhBot.SendMail |
Determines whether the bot sends out mail (for instance, returning unsold items). | 0 (off) 1 (on) |
AhBot.ItemBuyMinInterval |
The minimum time in seconds between the bot purchasing items of the same type/category. If commented out, defaults apply internally. | 600 (10 minutes) 7200 (2 hours) |
AhBot.ItemSellMinInterval |
The minimum time in seconds between the bot posting items of the same type/category. | 600 (10 minutes) 7200 (2 hours) |
AhBot.ItemSellMaxInterval |
The maximum time in seconds between the bot posting items of the same type/category. If random posting is used, this helps define the upper limit of time. | 7200 (2 hours) |
AhBot.MaxSellInterval |
The maximum time in seconds the bot will wait before selling additional items (global cap). | 28800 (8 hours) |
Tip
Values involving currency are in the lowest currency option, like copper. For example, 20 means 20 copper.
Category
Categories can be equip, reagent, consumables, container, recipe, quest, devices, trade.
| Option | Description | Example Values |
|---|---|---|
AhBot.MaxAuctionCount.<category> |
The maximum number of items the bot can have on auction at one time for a given category. Typically broken down further by rarity suffix (white, green, blue, epic). |
AhBot.MaxAuctionCount.equip.epic = 10 AhBot.MaxAuctionCount.recipe.green = 4 |
AhBot.MaxItemTypeCount.<category> |
The maximum number of individual item types (of a certain rarity) in a category the bot can list concurrently. For example, limiting the total number of a specific blue item. |
AhBot.MaxItemTypeCount.equip.blue = 5 AhBot.MaxItemTypeCount.equip.epic = 2 |
AhBot.PriceMultiplier.Sell.<category> |
A category-specific multiplier for selling items. Multiplies the base price or global multiplier to adjust how much the bot charges when listing auctions in that category. |
AhBot.PriceMultiplier.Sell.recipe = 5.0 AhBot.PriceMultiplier.Sell.equip = 2.5 |
AhBot.PriceMultiplier.Buy.<category> |
A category-specific multiplier for buying items. Similar concept to Sell but for when the bot is purchasing player-posted items. |
AhBot.PriceMultiplier.Buy.recipe = 5.0 AhBot.PriceMultiplier.Buy.equip = 2.5 |
AhBot.PricingStrategy.<category> |
Determines how the bot approaches pricing for certain categories. For example, buyOnlyRare might prevent the bot from buying items below a certain rarity threshold. |
AhBot.PricingStrategy.equip = buyOnlyRare Other strategies depend on your core’s code |