Game: WoW Forever. Version: 1.5.2.
Dungeon Ledger tracks dungeon time, boss progress, deaths, personal-best splits, and completed-run history in WoW Forever. Its movable panel replaces the objective tracker while visible. It can resume a saved run after a reload and recognize several signs that you have entered a fresh run.
Install
Use the CurseForge app first. Select your Forever game installation, search for Dungeon Ledger, and install the matching release. The catalog lists https://www.curseforge.com/wow/addons/dungeon-ledger.
For a manual install, place the release folder at World of Warcraft/_forever_/Interface/AddOns/DungeonLedger/. Keep DungeonLedger.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
- Type
/dl setupto position and preview the tracker. - Open
/dl, leave Tracked Dungeon Mode on Auto, and choose your stopwatch and announcement preferences. - Enter a dungeon, then inspect Run History after completing it. Use
/dl resetrunonly when you deliberately want to restart tracking.
Slash commands
| Command | What it does |
|---|---|
/dl, /dledger, /dungeonledger | Toggle options/history. All names accept the subcommands below. |
/dl menu, config, options, open | Toggle the same options window. |
/dl unlock, move | Unlock the tracker for dragging. |
/dl lock | Lock the tracker. |
/dl show | Allow display while unlocked and clear the temporary hide flag. Does not itself unlock. |
/dl hide | Lock and hide the tracker until the next dungeon; disable showing while unlocked. |
/dl always | Enable always-visible mode. |
/dl dungeons | Disable always-visible mode. |
/dl reset | Reset tracker placement to the default position preset. |
/dl history | Open Run History. |
/dl setup, tutorial, guide | Open the setup guide. |
/dl resetrun, newrun | Start a fresh tracked run while in a dungeon. |
/dl debug | Toggle local mode-detection debug messages. |
/dl debug now | Print one mode-detection report. |
/dl help | Print tracker help. |
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 |
|---|---|---|---|
| Unlock tracker | Off; locked | General > Position | Allow dragging, then turn off to lock again. |
| Show only in dungeons | On | General > Position | Turning off enables always-visible mode. |
| Show tracker while unlocked | On | General > Position | Permit an unlocked preview outside a dungeon. |
| Show stopwatch | On | General > Core Tracking | Display elapsed time; recording still works when hidden. |
| Announce dungeon completion in party chat | Off | General > Core Tracking | Send the completion summary to the group. |
| Tracked Dungeon Mode | Auto | General > Advanced | Auto, Follower, Normal, Heroic, or Timewalking. A forced mode filters tracking; it does not change the game's dungeon difficulty. |
| Preview Scenario | Floodgate Completed | General > Advanced | Live Data, Simulated In-Progress, or Floodgate Completed preview when applicable. |
| Font Scale | 1.16 | General > Text and Background | Scale text, 0.70–1.60 in 0.05 steps. |
| Background Opacity | 0% | General > Text and Background | Background strength, 0–100% in 10% steps. |
| Frame Width | 288 | Layout > Layout & Size | Width, adjustable from 280–760 in 10-unit steps. |
| Frame Height | 258 | Layout > Layout & Size | Height, adjustable from 200–520 in 10-unit steps. |
| Frame Scale | 0.99 | Layout > Layout & Size | Overall scale, 0.65–1.80 in 0.05 steps. |
| Title Font | Friz Quadrata | Fonts > Typography | Choose Friz Quadrata, Arial Narrow, Morpheus, or Skurri. |
| Timer Font | Arial Narrow | Fonts > Typography | Independent timer font from the same choices. |
| Body Font | Friz Quadrata | Fonts > Typography | Independent body font from the same choices. |
| Tracker position | Default right-side preset | Drag when unlocked; Reset Position | Save placement or return to the preset. |
| Minimap position | 220 degrees | Drag launcher | Save minimap placement; no hide setting is exposed. |
| Profile export / import | No imported profile | Profiles | Copy supported preferences with Generate Export and Import Profile. |
| History view / dungeon filter | All runs; no filter | Run History > By dungeon | View grouped dungeon summaries, then click a dungeon to show its runs. |
| Search and collapsible sections | Empty search; initial expanded layout | Options sidebar/section controls | Find controls and reduce clutter without changing run data. |
Features and windows
Dungeon tracking
Tracking starts when a matching dungeon is active. Auto uses the detected dungeon type. Boss information comes from the Encounter Journal when available, supplemented by learned encounters. A boss can be marked engaged, then done with its elapsed kill time. If the roster is known complete, finishing all its bosses can complete the run; a known final boss and supported dungeon-completion events can also finish it. A partial learned roster is not enough to assume every boss is dead.
The stopwatch is visible by default. Turning it off hides the clock, not timing or record collection. Deaths are detected from group unit state. Hover the death line to see recorded deaths and times. If a death was never observable by the addon, the record cannot reconstruct it later.
Best times and history
Personal bests are separated by dungeon and difficulty. Boss splits compare the current run with saved best-run split times. Finishing a run records the time, deaths, boss information, and captured party details. Run History keeps the latest 100 completed runs; it is not a list of every abandoned attempt.
By dungeon groups retained runs by dungeon and mode, most-run first. It shows run count, best time, average time, average deaths, and the latest date. Click a dungeon for its individual runs; use All runs to return. Hover for recorded group details and group-best information when available. These summary averages use the retained history, not every run you have ever completed.
A local <Dungeon Completed> chat line includes the dungeon, elapsed time, deaths, boss count when available, and comparison with the previous best. The optional party announcement sends the same summary to the group. Peer version messages can tell you when another player running the addon has a newer version; they do not download updates.
Reloads, wipes, and fresh runs
Saved run snapshots allow a reload or a short exit and return without discarding progress. Snapshots expire after four hours without a recent touch. Elapsed time can include the time you spent away. A wipe and run back with the same group does not automatically reset the run.
The code checks for a fresh instance copy, a mostly different returning group, an instance-reset message, or a pull of a boss already killed in the saved run. These can start a fresh run. Use Start a new run or /dl resetrun when you explicitly need fresh tracking; this discards the current run's tracked progress rather than resetting dungeon enemies.
Windows and minimap
Right-click the tracker or use its gear for the quick menu: move/lock, settings, dungeon-only or always display, reset position, history, new run, hide until next dungeon, setup, and help. The minimap button opens options on left-click and the quick menu on right-click. Drag the icon to move it. The History control opens the history view.
The objective tracker is hidden while the dungeon panel is visible and restored when it is hidden. If another addon also manages the objective tracker, its behavior can affect what you see.
The options window has General, Run History, Layout, Fonts, Profiles, and More from Korivash. Colors use a fixed cyan-and-charcoal style. There is no current theme picker or editable color palette. Background opacity remains adjustable. Slider changes settle when released. Profile export/import transfers supported settings, not run history or records; placement and every runtime visibility choice are not included in the export fields.
FAQ
Why did my wipe not start a new timer?
Wiping and returning to the same run preserves it. Use Start a new run only when you mean to reset tracking.
Will hiding the stopwatch stop records?
No. Timing still runs in the background.
Why is the boss list incomplete?
Journal data may be unavailable. The addon learns encounters as it sees them.
Why is the background invisible?
Version 1.5.2 defaults Background Opacity to 0%. Raise it in General > Text and Background.
Does a forced tracked mode change dungeon difficulty?
No. It selects which detected mode to track.
Why did /dl show not reveal a locked tracker outside a dungeon?
It allows display while unlocked. Unlock it, use always-visible mode, or enter a tracked dungeon.
Are previews real completed runs?
No. Preview scenarios are sample displays for arranging the panel.
Can I move records through profile export?
No. Profiles contain supported preferences, not the saved run database.
Troubleshooting and saved data
DungeonLedgerDB stores account-wide preferences, records, the latest 100 completed runs, learned boss information, and run snapshots. For a missing tracker, clear temporary hiding, check the mode filter, then use /dl unlock or /dl always. /dl reset moves the panel; /dl resetrun changes run progress.
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 _forever_/WTF/Account/<Account>/SavedVariables/DungeonLedger.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
- 1.5.2 — Transparent background default restored; steadier sliders apply on release.
- 1.5.1 — Added Background Opacity in General.
- 1.5.0 — Fixed cyan-and-charcoal style across tracker, history, settings, and guide; retained dimensions, fonts, and profile transfer.
- 1.4.7 — Detailed local and optional party completion summaries.