Merge pull request #41 from zeb139/development

Add Advanced_Pricing_Calculator spreadsheet tool

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.<Category>.<Subclass>.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

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 
+#        Consider using the Advanced_Pricing_Calculator spreadsheet included
-#       set by AuctionHouseBot.PriceMultiplier.Category*.Quality* 
+#        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

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.<Category>.<Subclass>.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
+
+<br>
+
+**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