# Addons

**For:** players and self-hosters. **At the end:** you know every addon wow-stats reads, which ones you need, and what each one adds to your page.

<!-- Generated by tools/manual/generate.py from docs/videos/steps.json, the list the start page and the installer check use. Edit the source, then run `uv run python tools/manual/generate.py`. tests/test_manual.py fails while this is stale. -->

wow-stats never ships an addon of its own. It reads the files well-known addons already save in your `_forever_` folder, when you `/reload` or log out. A missing optional addon leaves its part of the page empty; nothing breaks.

| Addon | Needed | What it gives your page | Folder in `Interface/AddOns` | Fills |
|---|---|---|---|---|
| [Polestar](https://www.curseforge.com/wow/addons/polestar) | required | level splits, quests, deaths, dungeons, the gear advice | `Polestar` | level times, dungeon runs and gear advice |
| [Polestar Recorder](https://github.com/fitzforge/polestar/releases/latest) | required | your play sessions, zone by zone | `Polestar_Recorder` | play sessions, zones, deaths and loot |
| [Syndicator](https://www.curseforge.com/wow/addons/syndicator) | optional | gear and gold on every character | `Syndicator` | your gear and bags |
| [Auctionator](https://www.curseforge.com/wow/addons/auctionator) | optional | prices from your own auction house scans | `Auctionator` | auction prices |
| [Altoholic](https://www.curseforge.com/wow/addons/altoholic) | optional | your full /played from level 1, the quests you finished before Polestar, and the recipes you know | `Altoholic` | quests you did before installing |
| [Questie](https://www.curseforge.com/wow/addons/questie) | optional | the quests you finished before Polestar (Altoholic does it too: one of the two is enough) | `Questie` | quests you did before installing |
| [CharacterExport-Forever](https://www.curseforge.com/wow/addons/characterexport) | optional | profession caps | `CharacterExport-Forever` | no section of its own |
| [Narcissus](https://www.curseforge.com/wow/addons/narcissus) | optional | your character's look in 3D before Battle.net knows it | `Narcissus` | no section of its own |
| [Vulcan SimBench](https://www.curseforge.com/wow/addons/vulcan-simbench) | optional | a history of your talents | `VulcanSimBench` | no section of its own |

## With the CurseForge app (recommended)

Get it at <https://www.curseforge.com/download/app>.

1. Download the CurseForge app (Windows, macOS, Linux) and install it.
2. Pick World of Warcraft, then the Forever instance. Not listed: restart the app so it updates.
3. Search each addon by its exact name and click Install.
4. Polestar Recorder isn't on CurseForge: the install command adds it. By hand: take the Polestar_Recorder zip from its GitHub release and unzip it like the steps below, or install the Polestar Client from Polestar's site, which installs it and turns it on. Without the Client, type `/psrec on` in WoW once.
5. At character select, click AddOns (bottom left), pick the character in the drop-down at the top, tick the addons, Okay. Once per character.
6. Restart WoW completely: `/reload` doesn't load a new addon.

## By hand, from the zips

1. On each addon's page, download its Forever file.
2. Unzip into the `_forever_` folder's `Interface/AddOns/` (Windows: `C:\Program Files (x86)\World of Warcraft\_forever_\Interface\AddOns`, Mac: `/Applications/World of Warcraft/_forever_/Interface/AddOns`) so the addon's folder sits directly inside it (`Interface/AddOns/Polestar/Polestar.toc`). Make the folder if it isn't there yet.
3. Restart WoW completely.

## Turn them on for each character

At character select, click **AddOns** (bottom left), pick the character in the drop-down at the top (or "All characters"), tick the addons, then **Okay**. A character whose addons are off writes nothing wow-stats can read.

Polestar Recorder starts switched off unless the Polestar Client installed it: type `/psrec on` once in game.
