Game: WoW Retail. Version: 0.12.11.
Keystone Monitor is a Retail dungeon tracker for Mythic+ and other five-player modes. It shows keystone timing, chest thresholds, forces, boss splits, deaths, and personal records, with history and optional group announcements. Non-keystone runs can be tracked with an optional visible stopwatch.
Install
Use the CurseForge app first. Select your Retail game installation, search for Keystone Monitor, and install the matching release. The catalog lists https://www.curseforge.com/wow/addons/keystone.
For a manual install, place the release folder at World of Warcraft/_retail_/Interface/AddOns/KeystoneMonitor/. Keep KeystoneMonitor.toc directly inside that folder, with its Lua files and media beside it. Avoid an extra nested release folder. Fully close and restart the game, then enable the addon for the character in the AddOns list.
Quick start
- Open
/km setupand arrange the preview panel; lock it when ready. - Open
/kmand review General. Auto-insert and local new-key messages are on; party broadcasts and the untimed stopwatch are off. - Run a dungeon, hover its death information, and open Run History to inspect completed runs and season key records.
Slash commands
| Command | What it does |
|---|---|
/km, /keystonemonitor, /mplus | Toggle the options window. All aliases accept the same subcommands. |
/km menu, config, options, open | Toggle options. |
/km unlock, lock | Unlock or lock tracker movement. |
/km show | Allow display while unlocked; does not itself unlock. |
/km hide | Disable display outside active runs through the unlocked-display preference. |
/km reset | Restore tracker position to saved offsets 0, 120. |
/km history | Open Run History. |
/km setup, tutorial, guide | Open setup. |
/km resetrun | Clear the current saved run snapshot and rebuild tracking from current game state. |
/km debug | Toggle mode-detection logging. |
/km debug now | Print one mode-detection report. |
!keys in group chat | A chat trigger, not a slash command. Each responding installation announces its current key or that it has none. |
Settings and controls
Defaults below describe a new installation. Existing saved choices can carry forward after an update.
| Setting or control | Default | Where | What it does |
|---|---|---|---|
| Lock tracker position | On | General > Core Tracking | Prevent dragging. |
| Show tracker while unlocked | On | General > Core Tracking | Allow the unlocked panel outside a tracked run. |
| Show best timed comparison | On | General > Core Tracking | Show the available best timed reference. |
| Show pace hints | On | General > Core Tracking | Show the chest threshold currently within reach based on elapsed time and penalties. |
| Auto-insert keystone at the font | On | General > Core Tracking | Slot an available bag keystone when the font opens. |
| Show stopwatch in untimed dungeons | Off | General > Core Tracking | Show the clock in non-Mythic+ runs; internal timing remains active. |
| Announce dungeon completion in party chat | Off | General > Core Tracking | Send completion time and deaths to the group. |
| Announce when I get a new Mythic+ key | On | General > Core Tracking | Print a local message after a detected new or changed key. |
| Also broadcast to party chat | Off | General > Core Tracking | Send enabled new-key messages to the group too. |
| Tracked Dungeon Mode | Auto | General > Advanced | Auto, Follower, Normal, Heroic, Timewalking, Mythic 0, or Mythic+. |
| Preview Scenario | Floodgate Completed | General > Advanced | Choose Live Data, Simulated In-Progress, or Floodgate Completed. |
| Frame Width | 288 | Layout | 280–760, in steps of 2. |
| Frame Height | 258 | Layout | 200–520, in steps of 2. |
| Frame Scale | 0.99 | Layout | 0.70–1.80, in 0.01 steps. |
| Panel Opacity | 0.00 | Layout | 0–1 multiplier for background and border opacity; it does not hide the text. |
| Use class color for accent | Off | Visual | Use your class color instead of the custom accent. |
| Accent | 53B9FFFF | Visual | Accent color in RGBA hexadecimal. |
| Background | 0D0D0DC7 | Visual | Panel background color, also affected by Panel Opacity. |
| Border | 333333F2 | Visual | Border color, also affected by Panel Opacity. |
| Text | 53B9FFFF | Visual | Body/status text color. |
| Timer | 53B9FFFF | Visual | Timer text color. |
| Forces Bar | 53B9FFFF | Visual | Enemy-forces bar color. |
| Forces Bar BG | 212121E6 | Visual | Forces-bar background color. |
| Font Scale | 1.16 | Visual > Visual Density | 0.70–1.60, in 0.01 steps. |
| Title Font | Friz Quadrata | Fonts | Friz Quadrata, Arial Narrow, Morpheus, or Skurri. |
| Timer Font | Arial Narrow | Fonts | Independent timer font. |
| Body Font | Friz Quadrata | Fonts | Independent body font. |
| Preset | Keystone Monitor Default appearance | Profiles | Choose Keystone Monitor Default, Raider Steel, Neon Pulse, or Minimal Clean, then Apply Preset. |
| Profile export / import | No import | Profiles | Transfer supported appearance and behavior settings through a text string. |
| Run-history view / filter | Runs / All | Run History | Switch Runs, Best Timed, Highest Key, and applicable run filters. |
| Tracker position | Offsets 0, 120 | Drag unlocked tracker; Reset Position | Remember placement. |
| Search and section collapse | Empty search; initial layout | Options | Find or collapse controls without changing run data. |
Features and windows
Mythic+ timing and forces
The panel shows the key timer, chest thresholds, enemy forces, bosses, and deaths. Death count and penalty come from the game's challenge information. Timing accounts for the relevant penalty behavior, including Challenger's Peril. Pace hints show which threshold remains possible at the current elapsed time plus penalties. They do not estimate the speed of every future pull.
Enemy forces show count and percentage. Once complete, the row records a completion timestamp. Boss rows show engagement and kill times with saved split comparisons when a reference is available. Green deltas are ahead; red deltas are behind. Affix icons have hover details and can show current weekly affixes outside a run.
Best timed comparisons use available game Mythic+ history; local records also supply boss and forces split references. A missing reference is not a zero-second best. Season data may take time to arrive. Use Refresh M+ Data in history when you need a new request.
Other dungeon modes
Follower, Normal, Heroic, Timewalking, and Mythic 0 can use boss-roster detection and local timing. Bosses become engaged on a pull and done on a successful encounter. Finishing the known boss roster completes the run. Best times and boss splits are saved per dungeon and difficulty. Deaths are watched through group unit state in modes without an official challenge counter.
These modes hide the clock by default. Enable Show stopwatch in untimed dungeons to see it. Internal timing still powers records with the display off. A forced mode is a tracking choice, not a command to change the instance difficulty.
History, persistence, and announcements
Runs keeps the latest 100 recorded runs, summary statistics, filters, and hover details. Best Timed shows the highest key level timed for a map and the best time at that level. Highest Key includes completed keys whether timed or not. Those season views use the game's Mythic+ history and may cover maps absent from the local list.
The addon maintains an in-progress snapshot to resume supported progress after a reload or return to an instance. The non-keystone resume check requires a matching run key and a start time less than four hours old. This is not a guarantee against losing the last unsaved changes in a client crash. /km resetrun clears the saved snapshot and refreshes current state; it does not reset or restart the actual keystone.
New-key notices establish a baseline at login, avoid repeating unchanged keys, and suppress same-map downgrades. A genuinely new key after an established no-key state can announce. The message prefers a real bag keystone link and falls back to readable key text. Party broadcasting is a separate, off-by-default choice.
!keys is handled separately from the new-key notification switches. A received matching group message prompts an installed copy to reply with its key or “none.” Group announcements choose the available party, raid, or instance channel. Optional completion announcements report timed/not timed status for Mythic+ or completed status for other modes. Peer version checks notify locally about a newer detected release; they do not update files.
Windows and appearance
There is no minimap button in the current Keystone Monitor source. Use /km, right-click the tracker and choose Settings, or click its watch/history control. Unlock to drag; a brief drag hint appears. Options contains General, Run History, Layout, Visual, Fonts, Profiles, and More from Korivash. Setup can show sample data for arranging the tracker.
The default is cyan text with a transparent panel background, not class-color accent. Panel Opacity multiplies the background and border alpha; text remains visible at zero. Visual color boxes accept hexadecimal RGBA values and have color pickers. Press Enter or Apply Colors for typed changes. Profiles can apply a preset or export/import supported settings. They do not export your completed-run history. The objective tracker is hidden while the dungeon panel is shown and restored afterward.
FAQ
Why is there no minimap icon?
This build has no minimap launcher. Use /km or the tracker controls.
Why is there no clock in a normal dungeon?
The untimed stopwatch defaults to off. Recording continues; enable it in General to see the time.
Why is the panel transparent?
Panel Opacity defaults to 0.00. Raise it under Layout for a background and border.
Does auto-insert start my key?
It slots the keystone. It does not automatically start the challenge.
Why did a depleted key not announce?
A lower level on the same map is deliberately suppressed.
Does turning off new-key messages disable !keys?
No. The group-chat trigger is separate in the current code.
Will /km hide cover an active run?
It changes outside-run unlocked visibility. Active tracked runs can still show.
Can a profile string transfer records?
No. It transfers supported preferences, not the records database.
Troubleshooting and saved data
The current TOC declares Retail interfaces 120100, 120105. KeystoneMonitorDB stores account-wide preferences, records, history, and runtime state. If detection seems wrong, return the mode to Auto and use /km debug now to capture a report. Hiding a preview or changing a profile should not be confused with clearing a real run.
The addon does not appear. Check the game installation selected in CurseForge, the folder name above, and the AddOns checkbox for this character. A full game restart is needed when adding an addon or new files; a UI reload is not a substitute for that first restart.
A manual update seems to disappear. Check whether CurseForge is managing the same folder. An app update or reinstall can replace a hand-installed build. Keep a backup outside AddOns and use one update method for that installation.
Settings are missing or reverted. WoW writes saved settings during a normal logout or UI reload. Back up saved files while the game is closed. Account data is normally under _retail_/WTF/Account/<Account>/SavedVariables/KeystoneMonitor.lua, with a .lua.bak backup when present. Do not confuse that file with the addon's source files in Interface/AddOns. A different account or game installation has a different saved-data folder.
Something still looks wrong. Use the recovery controls described above, then reload. For help, include the addon version, game flavor, what you clicked, and the exact error text: https://discord.gg/YxFRuEPSxZ.
Recent changes
- 0.12.11 — Added More from Korivash.
- 0.12.10 — Setup preset highlighting and lock state fixes; brief drag hint instead of a permanent unlocked strip.
- 0.12.9 — Added the five-page setup guide and preview controls.
- 0.12.8 — Instance-chat announcements and improved detection of newly obtained keys.