The wow-stats manual
For: everyone: players, AI users, people who run a server, and contributors. At the end: you’ve found the page for what you want to do.
New here? How it works in five minutes, or the questions and answers.
A friend runs wow-stats and sent you a link.
- Join a friend’s server: the addons, one command, about 15 minutes.
- Your page at a glance, then each part in detail: Overview and next moves, Gear and upgrades, Dungeons, Plan your next hours, Climb, timeline, journal.
- Something’s wrong: fixes by symptom.
- What’s shared: what your friends and the public see.
Connect your AI
Section titled “Connect your AI”- Connect your AI: Claude, ChatGPT, Claude Code and a dozen more clients.
- Ask about your character: what to ask, and how the server checks the numbers.
- Tools and prompts: every tool your assistant can call.
Self-host
Section titled “Self-host”Start here:
- Try it at home: five made-up characters on your computer, 10 minutes.
- Install it for real: the server, the addons and the shipper, for yourself.
Set it up:
- Run it on a server: the order to set things up.
- Reverse proxy and HTTPS: Caddy, Traefik or nginx.
- The login for your AI: any OIDC provider, Keycloak as the example.
- Share your page: the public site, the sealed friends’ site, the pictures of past levels.
- Add friends: several players on one server.
- Admin overview: who uses the install, when, and whether its parts answer.
- Battle.net data: your own API client and the 30-day rule.
- Without Docker Compose: Kubernetes or plain containers.
Keep it running:
Look it up:
- Environment variables: every setting, which program reads it, its default.
- HTTP endpoints: every path, its port and its login.
- Sizing: measured time, memory and disk.
- The shipper: its files, flags and schedule.
- The shipper’s events: every event and field it sends.
Game data
Section titled “Game data”- Addons it reads: every addon and what it adds to the page.
- Gear upgrades, Route times, Forever reference, Model reference: the game data the kit ships.
- The knowledge base: where the game rules your assistant quotes come from.
Under the hood
Section titled “Under the hood”- Architecture: the parts and how an event travels.
- MCP and the play analysis: the tools, plans, analysis and login, inside.
- Privacy tiers: what’s collected, and who sees what.
- Security notes: what an install has to get right, and the findings left open on purpose.
Project and contributing
Section titled “Project and contributing”- Changelog and the security policy.
- How to contribute and Development and releases.