Skip to content

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.

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/AddOns you should see GoldCapped/ containing GoldCapped.toc — not a second folder with the same name inside it.