AH Price Checker

Addon for World of Warcraft Vanilla 1.12 that automatically identifies profitable items in the Auction House by comparing buyout prices against vendor sell prices.

Features

• Automatic Profit Detection: Highlights items where the auction buyout price is lower than the vendor sell price.
• Visual Indicators: Shows profit amount and profit percentage directly on auction listings.
• Dual Data Sources: Use VendorPriceScan scanned data, custom databases, or both combined.
• Smart Data Merging: Configurable priority system for combining multiple data sources.
• Toggle Control: Checkbox to quickly enable/disable profit highlighting.
• Large Database Support: Efficiently handles 10,000+ item price entries.

Installation

Method 1: Direct Download (Recommended)

1. Click the green <> Code button at the top of this page.
2. Select Download ZIP.
3. Extract the ZIP file.
4. Rename the folder from AHPriceChecker-main to AHPriceChecker (remove -main).
5. Move the AHPriceChecker folder to World of Warcraft/Interface/AddOns/.
6. Restart WoW or type /reload in-game.

Method 2: Git Clone

Navigate to your WoW installation folder's Interface/AddOns/ directory and run:

git clone https://github.com/Devilquest/AHPriceChecker.git

Verification

After installation, your folder structure should look like this:

World of Warcraft/
└── Interface/
    └── AddOns/
        └── AHPriceChecker/
            ├── AHPriceChecker.toc
            ├── AHPriceChecker_Constants.lua
            ├── AHPriceChecker.lua
            └── AHPriceChecker_VendorPrices.lua

Common Issues:

• ❌ AddOns/AHPriceChecker-main/AHPriceChecker/ (too nested)
• ✅ AddOns/AHPriceChecker/ (correct!)

Requirements

• Game Version: World of Warcraft 1.12.x (Vanilla).
• Dependencies: None (standalone addon).

At least ONE of the following is required:

Option 1: VendorPriceScan Addon (Recommended for Active Players)

• Install and enable VendorPriceScan.
• Visit vendors to automatically scan and save prices.
• Important: VendorPriceScan must be enabled for AHPriceChecker to access its data.

Option 2: Custom Price Database (Manual Setup)

• Edit AHPriceChecker_VendorPrices.lua with your own price data.
• See the Advanced Usage section for format examples.
• Supports any number of items.

Option 3: Both (Best Results)

• Use your own custom database as a foundation.
• Add VendorPriceScan for fresh, verified prices.
• Your personal scans override database prices (configurable).

Usage

Basic Usage

1. Open the Auction House.
2. Browse or search for items normally.
3. Profitable items show green text with profit amount and percentage.
4. Use the "Profit Items" checkbox (top of AH window) to toggle the feature on/off.

Display Example:

[Item Name]                    [Buyout: 10s]
                               15s 30c
                               45%

Buying at 10s and vendoring for 25s 30c = 15s 30c profit (45%)

Slash Commands

• /ahpc or /ahpricechecker: Display detailed addon information including data sources loaded, item counts, and merge statistics.

Checkbox Control

The "Profit Items" checkbox appears at the top of the Auction House window:

• Checked (default): Shows profit indicators on qualifying items.
• Unchecked: Hides all profit indicators.

Note: This setting resets to enabled each time you open the AH.

Advanced Usage

Data Sources Integration

Using VendorPriceScan (Dynamic)

1. Install VendorPriceScan and enable it.
2. Visit vendors - prices are scanned automatically.
3. Type /reload after scanning to make new data available to AHPriceChecker.

Important: New scans during a session are not immediately visible. Type /reload or logout to update.

Using Custom Database (Static)

Edit AHPriceChecker_VendorPrices.lua with your price data:

AHPriceChecker_Data = {
    [2592] = {
        ["itemName"] = "Wool Cloth",  -- Optional
        ["vendorPrice"] = 50,          -- Required (copper)
    },
    [1206] = {
        ["itemName"] = "Moss Agate",
        ["vendorPrice"] = 500,
    },
}

• vendorPrice must be in copper (1g = 10,000c).
• itemName is optional (readability only).
• Find item IDs on Wowhead Classic.

Data Priority Configuration

When using both sources, you can control which takes priority by editing AHPriceChecker_Constants.lua:

AHPriceChecker.SETTINGS = {
    prioritizeScannedData = true  -- Change to false if needed
}

• true (Default): Personal scans override database. Best for most users.
• false: Database overrides personal scans. Best for curated databases.

Data Synchronization Flow

1. Open WoW → Data loads and merges.
2. Scan vendors with VendorPriceScan → Data updates in VendorPriceScan only.
3. Visit AH → AHPriceChecker still uses old data.
4. Type /reload → New scans are now visible ✅

Troubleshooting

• "No price data available": Enable VendorPriceScan and scan vendors, OR add data to AHPriceChecker_VendorPrices.lua. Type /reload.
• Items don't show profit: Check "Profit Items" checkbox. Ensure buyout < vendor price. Ensure item is in database. Try /reload.
• New scanned items don't appear: Type /reload after scanning.
• VendorPriceScan data not loading: Ensure it is enabled and you have scanned vendors.

Known Limitations

• Reload Required: Requires /reload to see newly scanned VendorPriceScan data.
• Dependency Scope: Cannot access VendorPriceScan data if that addon is disabled.
• Buyout Only: Only checks buyout prices (not bid prices).
• WoW Version: World of Warcraft 1.12.x (Vanilla) only.

Changelog

v1.0.0

• Initial release
• Automatic profit detection in Auction House
• VendorPriceScan integration
• Custom price database support
• Smart data merging with configurable priority
• Real-time auction listing updates
• Toggle control via checkbox

---

❤️ Donations

Donations are always greatly appreciated. Thank you for your support!