KeyGrid

Every character's Mythic+ progress in one grid — readable from whichever character you happen to be on.

World of Warcraft keeps Mythic+ data per character. So the simple question — which of my alts still has a key, and what is it? — normally means logging in five times to find out, and logging in five more times next week.

KeyGrid takes a snapshot each time you log a character in, and shows all of them together, account-wide. Open it on your main and see your whole roster: who's holding a key, who's capped their vault, who still needs one more run.

What you see

One row per character, sorted however you like — every column is sortable, just click its header.

• Key — the keystone that character is holding right now, e.g. CAVERN+9
• Score — current season Mythic+ rating, in the game's own rarity colour
• iLvl — equipped item level
• Vault — what each of the three Great Vault slots will offer next reset
• Crest — the highest crest tier that character has earned
• Coins / Marl / Flux / Dust — Corrosive Coin, Voidlight Marl, Venomblight Manaflux and Tidal Spark Dust
• One column per season dungeon — best key level and score for each

Best runs are colour-coded the way you'd expect: green when you timed it, orange with a * when you didn't. The score underneath each level tells you what that run is actually worth.

Above the grid sits this week's affixes and a live countdown to the weekly reset.

Hover anything

The grid is deliberately dense. Everything that doesn't fit is one mouseover away.

• A dungeon cell — best run detail: level, timed or over time, how long it took, when you ran it, and whether the data came from the game or the API
• The Crest column — every crest tier this season with its count and its season cap, so you can see at a glance which tier you're capped on
• A currency — collected, spent, weekly earned against cap, and season cap. For anything warband-transferable you also get every character's balance and the account total, so you know what you can actually afford before you visit the vendor
• The Key column — which dungeon, what level, and when it was last seen
• The Vault column — runs completed toward each slot, and the reward level each one will grant
• A character's name — class, level, item level, rating, vault progress and a currency summary in one place

What it can and cannot know

This is worth understanding before you install, because it explains the one real limitation.

The addon API only ever exposes the logged-in character's Mythic+ data. There is no way, from inside the game, to read an alt's keystone or vault. Any addon claiming otherwise is showing you a cached snapshot — and so is this one.

What that means in practice:

• A character appears in the grid once you have logged into it with KeyGrid installed
• Its keystone and vault are as of that moment, not live
• Ratings reset when a season rolls over, so a character you haven't logged into since then shows N/A rather than a number it no longer has

That last point is deliberate. A stale rating that looks current is worse than an honest blank.

The one exception is currencies you can move between characters: for those, the game exposes real account-wide balances, and KeyGrid shows the true warband total.

Commands

• /kg — toggle the window (/keys and /keygrid also work)
• /kg all — show or hide characters with no score
• /kg hide Name-Realm — hide a row you don't care about
• /kg show Name-Realm — bring it back
• /kg capture — re-snapshot the current character right now
• /kg reset — reset the window position and size
• /kg sync — setup instructions for the optional API import

The window is movable and resizable, and remembers where you left it.

Optional: keygrid-sync

Everything above works with no setup at all. If you want to go further, there's a small Python companion (standard library only) that pulls best runs and rating for your whole roster from the Blizzard API — including characters you have never logged into with the addon.

It writes into a separate companion addon that KeyGrid merges at login, and never touches your saved data. It needs a free Blizzard API client and about five minutes.

Entirely optional. Type /kg sync in game for the full walkthrough, or read the docs on GitHub.

Keystones and Great Vault progress are deliberately not synced — the Blizzard API doesn't expose them, so those stay honest in-game snapshots.

Good to know

• No external libraries. Pure Blizzard API — no Ace3, no LibStub, nothing embedded
• Your data stays yours. One account-wide saved variables file, KeyGridDB, on your own machine. Nothing is uploaded anywhere
• Light touch. Snapshots happen on login, reload, and the relevant game events. No polling, no timers running in the background
• Retail only — built and tested against the current retail patch
• A Void Cores tab is present but greyed out, waiting on how cores actually work this season. The data is being captured in the meantime, so it'll have history when it switches on
• MIT licensed, source on GitHub — issues and pull requests welcome

FAQ

Why is my alt missing from the grid? It hasn't been logged into with KeyGrid installed yet. Log in on it once and it'll appear from then on. If it has been logged in but has no rating, it's hidden by default — /kg all shows everyone.

Why does Score say N/A? Either that character hasn't run a Mythic+ this season, or you haven't logged into it since the season rolled over. Ratings reset with the season, so KeyGrid won't show you an old one as though it were current. Hover the cell and it'll tell you which of the two it is.

Why is a dungeon column showing --? No run recorded for that dungeon this season on that character.

Can I reorder or hide columns? Click any header to sort by it. Rows can be hidden with /kg hide Name-Realm.

The window is too small / clipped after an update. /kg reset restores the default size and position.

Does it work in Classic? No — retail only.

Found a bug or want a column that isn't there? Open an issue on GitHub — it's the fastest way to get it looked at.