Dot Ledger

# DoT Ledger

Keep track of your timed effects across enemies with a compact list of countdown bars.

DoT Ledger is built for **WoW: Forever** and supports all nine Classic/Forever classes. It discovers timed harmful spells from your character's spellbook and tracks readable personal enemy debuffs without requiring a fixed spell whitelist.

## Features

- **One bar per effect, per enemy.** Corruption, Bane of Agony and Immolate on the same mob each get their own countdown. Refreshing one effect updates its own bar.
- **All-class tracking.** Supports readable DoTs, bleeds, poisons and proc effects, plus other timed harmful effects such as curses and crowd control.
- **Automatic spell discovery.** Coverage refreshes as you learn spells or change talents, using the abilities exposed by your Forever client.
- **Minimal display.** Thin bars, compact spacing and a separate spell icon on the left. No bulky panel or mouseover tooltip.
- **Clear expiry warning.** Blue bars turn red when less than five seconds remain.
- **Subtle mouseover glow.** A thin golden border highlights the bar beneath your cursor.
- **Easy positioning and resizing.** Unlock the list, drag it into place and resize the bars using the bottom-right handle.
- **Adjustable transparency.** Change fill opacity while keeping text readable.
- **No external addon dependencies.**

## Commands

| Command | What it does |
| --- | --- |
| `/dl unlock` | Shows the move and resize handles outside combat. |
| `/dl lock` | Hides the handles. |
| `/dl opacity 40` | Sets bar fill opacity to 40%; accepts values from 0 to 100. |
| `/dl debug` | Prints tracking diagnostics for troubleshooting. |

`/dotledger` can also be used. Position, size and opacity are saved.

## Getting started

Enable DoT Ledger in the AddOns menu and enable enemy nameplates. Apply a timed harmful effect to an enemy with a visible nameplate; its bar appears in the list. Use `/dl unlock` to adjust the display, then `/dl lock` when finished.

For manual installation, extract the addon ZIP into your Forever client's `Interface/AddOns` folder so that `DoTLedger/DoTLedger.toc` is directly inside it. Use `/reload` after installing an update.

## Beta notes

This release is for **WoW: Forever only**.

Forever can restrict aura data during combat. Readable aura data supplies confirmed timers; when supported cast information is used instead, the countdown shows `~` to mark an estimate. An unavailable duration shows `?`. Estimates cannot confirm a hit or every early removal. Tooltip estimates currently require supported English duration text.

Ground effects, traps, area channels and passive procs receive bars for individual enemies only when the client exposes suitable timed aura data. The visible list follows enemy nameplates; enemies outside nameplate range leave the display.

Bars are display-only: they do not select targets or cast spells. Live testing of every class and every Forever effect is still ongoing.

## Reporting an issue

Include your class, spell name, Forever client build, whether enemy nameplates were visible, the output of `/dl debug`, and any Lua error. A screenshot showing the effect and its bar is helpful.