diff --git a/README.md b/README.md index d193d9c..05221f8 100644 --- a/README.md +++ b/README.md @@ -51,6 +51,12 @@ The AuctionHouseBot module adds the following in-game commands (for GMs only): The above behavior is replicated on each enabled auction house. If left to default settings, 1 item in each auction house will attempt to be bought from, if the price calculation seems favorable. Note that any item buy attempt, even items above buying price, consumes a buy candidate. That means that too many overpriced items can drown out potential sales. + +## Additional Resources + +[Advanced Pricing Calculator](tools/AdvancedPricingCalculator/Advanced_Pricing_Calculator.xlsx) - If `AuctionHouseBot.AdvancedPricing...Enabled` is enabled, this spreadsheet can help quickly visualize how config settings affect in-game prices. + + ## Credits - NathanHandley: Created this rewrite of the one that was ported to AzerothCore diff --git a/conf/mod_ahbot.conf.dist b/conf/mod_ahbot.conf.dist index 5703755..ab61cb3 100644 --- a/conf/mod_ahbot.conf.dist +++ b/conf/mod_ahbot.conf.dist @@ -504,8 +504,11 @@ AuctionHouseBot.PriceMinimumCenterBase.OverrideItems = # model their prices alongside more predictable items - their prices # may be considered "low". # -# Note that the AdvancedPricing logic also relies on values -# set by AuctionHouseBot.PriceMultiplier.Category*.Quality* +# Consider using the Advanced_Pricing_Calculator spreadsheet included +# in the "tools" folder of this module for help with changing config settings. +# +# Note that the AdvancedPricing logic also relies on values +# set by AuctionHouseBot.PriceMultiplier.Category*.Quality* # Defaults: true (Enabled) # # Note that all price multpliers (along with the advanced pricing) are applied diff --git a/tools/AdvancedPricingCalculator/Advanced_Pricing_Calculator.xlsx b/tools/AdvancedPricingCalculator/Advanced_Pricing_Calculator.xlsx new file mode 100644 index 0000000..a88f84a Binary files /dev/null and b/tools/AdvancedPricingCalculator/Advanced_Pricing_Calculator.xlsx differ diff --git a/tools/AdvancedPricingCalculator/Advanced_Pricing_Calculator_README.md b/tools/AdvancedPricingCalculator/Advanced_Pricing_Calculator_README.md new file mode 100644 index 0000000..cf58829 --- /dev/null +++ b/tools/AdvancedPricingCalculator/Advanced_Pricing_Calculator_README.md @@ -0,0 +1,22 @@ +## mod-ah-bot Advanced Pricing Calculator +This spreadsheet helps show the buy and sell prices that the Bot(s) will use based on your configuration when `AuctionHouseBot.AdvancedPricing...Enabled` is `true` . + +### How to Use +**Edit only the “Config” tab** + - This tab contains many adjustable settings from the module’s config file + - Change these values to match your server’s setup + - Items in other tabs reference the `Config` tab, so values will update immediately + +
+ +**You shouldn’t need to modify anything outside the Config sheet unless you know what you're doing.** +*There are hidden columns in each tab that can show items' Quality, Vendor Price, and Item Level (according to the database). +If you make custom changes to your database info, consider updating these as well for accurate pricing.* + +### Notes +- The spreadsheet does not consider the following settings: + - AuctionHouseBot.Buyer.AcceptablePriceModifier + - AuctionHouseBot.BidVariationHighReducePercent + - AuctionHouseBot.BidVariationLowReducePercent + - AuctionHouseBot.BuyoutBelowVendorVariationAddPercentEnabled + - AuctionHouseBot.BuyoutBelowVendorVariationAddPercent