Never lose track of your holiday tokens again.

VendorCurrencyHelper is a lightweight World of Warcraft (Retail) addon that automatically detects whatever alternative currency or bag-item currency a merchant requires — think Hallow's End Tricky Treats, Love is in the Air Love Tokens, or any other seasonal/reputation token — and displays your current owned quantity cleanly in the bottom-left corner of the MerchantFrame, sitting on the same horizontal axis as the standard gold display.

No configuration needed. Open a vendor, see your balance.

• Automatic currency detection — scans every item on the vendor at open time and identifies all non-gold cost currencies, whether they live in the Currency Tab (e.g. Valor Points, Flightstones) or your bags / Warband storage (e.g. Tricky Treats, holiday event tokens).

• Up to 3 distinct currencies shown side-by-side — each displayed as a count + 16 px icon, neatly tiled from left to right inside the frame, matching the clean aesthetic of the native gold display on the right.

• Interactive tooltips — hovering over any currency slot shows the full item or currency tooltip so you always know exactly what you're spending.

• Real-time quantity updates — listens to BAG_UPDATE_DELAYED and CURRENCY_DISPLAY_UPDATE so the count refreshes instantly after every purchase without reopening the vendor.

• ElvUI & custom skin compatible — the display frame is parented to MerchantFrame at a high frame level (FrameLevel 100, FrameStrata HIGH), ensuring it renders on top of UI overhaul skins without manual z-order fiddling.

• Automatically hides on gold-only vendors — if no alternative currency is detected the entire display disappears, so it never clutters standard shops.

Tip: Run /vch immediately after opening a vendor if the display looks empty or stale. The 0.2 s timer that fires on MERCHANT_SHOW covers most cases, but some servers with high item counts may need a manual nudge.

1. Search for VendorCurrencyHelper in the CurseForge or Wago Addons client.
2. Click Install. The client handles placement and future updates automatically.

1. Download the latest release ZIP from the project page.
2. Extract the folder so the structure looks like:

   World of Warcraft/
   └── _retail_/
       └── Interface/
           └── AddOns/
               └── VendorCurrencyHelper/
                   ├── VendorCurrencyHelper.toc
                   └── Core.lua
   

    
3. Launch (or reload) the game. The addon will appear in your AddOns list at the character select screen.

Requires World of Warcraft Retail (interface version 11.x / 12.x). Not compatible with Classic or Classic Era.

The display doesn't appear at a seasonal vendor. Run /vch while the vendor is open. The debug output will show exactly what cost fields the API returned. Some vendors serve their items in batches — the 0.2 s delayed scan handles this, but a manual /vch forces an immediate re-check.

Counts don't update after buying items. Ensure no other addon is blocking BAG_UPDATE_DELAYED or CURRENCY_DISPLAY_UPDATE. A /reload will reset everything cleanly.

The frame overlaps another element in my custom UI. The frame is anchored BOTTOMLEFT of MerchantFrame and stretches right. If you use a UI skin that significantly resizes or repositions MerchantFrame, the relative anchor will follow it correctly. If you need a pixel-level nudge, reach out via the issue tracker with a screenshot.