Setting up Gold Capped
Three pieces: the in-game addon, the desktop app that feeds it, and your account linking the two. Fifteen minutes, once.
What you are installing
Two addon folders and one desktop app. Knowing which does what makes every problem below obvious.
GoldCapped
The addon itself — tooltips, sniper, posting, groups, farm tracking. One package loads on every client.
GoldCappedData
Auto-generated. The desktop app overwrites it with computed prices on every sync. Never edit it by hand.
Gold Capped Desktop
The bridge. Writes prices in, sends your scans out. Windows, macOS and Linux; updates itself.
Why a desktop app? WoW addons are sandboxed — they cannot reach the network or read files. Saved-variable files on disk are the only way anything crosses that boundary, so a normal program has to sit on the outside and do the talking. That is also why prices update at login or , and not the instant a sync finishes: nothing inside the game can see the file change.
1. Install the addon
Install it from CurseForge, or download the zip and copy its two folders in by hand.
Extract both GoldCapped/ and GoldCappedData/ into the Interface/AddOns folder of every client you play:
- Retail
_retail_- Mists of Pandaria Classic
_classic_- Titan Reforged
_classic_titan_- Burning Crusade Anniversary
_anniversary_- Classic Era / Hardcore / seasonal
_classic_era_
Each client keeps its own addon folder, so installing once does not cover the rest. If you play Retail and Classic Era, install into both.
2. Install the desktop app
Free with your account. It installs in seconds and keeps itself up to date.
Grab it from the Download page once you are signed in — the download comes with your free account, the same one you link it to. Windows, macOS and Linux; the macOS build is universal (Apple Silicon and Intel) and Linux ships as an AppImage. Leave it running while you play — it syncs on its own, and it is what keeps your tooltips current.
3. Sign in to the desktop app
Signing in links it. There is no token to copy.
- Open the desktop app and sign in with your Gold Capped account, the same one you use on this site.
- That links this computer: it now appears under Connected apps on your Addon page.
- Let the first sync finish. It uploads what the addon has collected and writes prices back into the game.
- Set your region. The desktop app defaults to US, so if you play on EU realms open its Settings and switch to EU — otherwise every price it writes into the game is from the wrong region.
Check it worked
Two commands and a tooltip.
- — loads the price file the desktop app just wrote. Do this after the first sync.
- — prints a report to chat. Read the freshness line: current is under two hours old, aging is delayed, stale is a day or more, and missing means the desktop app has never synced. The same state is the coloured badge at the bottom of the main window.
- Hover any auctionable item. You should see Realm Value, Region Value and Sold Value under the item name. For what those mean, read price sources.
on its own opens the main window; opens the in-game cheat sheet. Everything else — the sniper, posting, groups, the farm tracker — lives behind tabs in that window.
Troubleshooting
- Tooltips show no prices at all
- The price file has never arrived. Check that the desktop app is running and signed in, then in game. WoW only reads the generated file at login or on a reload — a sync that finishes while you are standing in the auction house does not appear until you reload.
- Prices are there but stale
- Run . Gold Capped stamps every generation and reports it current under two hours old, aging while delayed, and stale at a day or more. Anything past current means the desktop app stopped syncing — not that your realm has no data.
- It works on one character but not another
- You are on a different client. The addon has to be installed into each Battle.net directory separately — see the table above.
- Nothing appears in the addon list in game
- The folders are nested one level too deep. Inside
Interface/AddOnsyou should seeGoldCapped/containingGoldCapped.toc— not a second folder with the same name inside it.
