WoW: 12.1 (Midnight) · [Forever Beta Support] Flavors: Retail, MoP Classic, TBC Classic, Classic Era · Maintainer: Nelnamara · Original V2 author: cliffclive · Original author: Vreenak (US-Remulos)

CooldownTimeline tracks your ability cooldowns as moving icons along a horizontal timeline bar. As a cooldown expires it slides toward a "ready" zone on the right; when it fires, a configurable alert plays. Supports all spec cooldowns, ICDs, auto-attack swings, and optional Masque skinning.

• Visual cooldown timeline — icons slide along a bar toward a "ready" marker as their cooldowns count down
• Auto-detection — discovers spec abilities automatically on login and spec change; no manual setup required
• Multiple lanes — separate bars for different cooldown categories (offensive, defensive, etc.)
• Bar frames — castbar-style cooldown bars with per-frame textures and colors, class color, spell school color, and the new Dynamic Color mode (bar blends toward a ready color over its final seconds)
• Configurable ready zone — sound alerts and flash animation when a cooldown comes off cooldown
• Internal cooldown (ICD) tracking — tracks proc ICDs alongside regular cooldowns
• Custom cooldown list — manually add any spell not auto-detected
• Shared cooldown support — optionally hide redundant entries when abilities share a CD
• Auto-hide — bar hides when out of combat (configurable)
• Masque support — skins all cooldown icons through Masque if installed
• LibSharedMedia-3.0 — custom fonts, textures, sounds, and borders via LSM
• One movable settings window — /cdtl3 opens the complete configuration (every panel as a tab) in a movable window; no digging through Blizzard's fixed Settings frame
• Minimap button — left-click opens settings, right-click toggles frame lock
• AceDB profiles — per-character or shared configs, with import/export

1. Install via the CurseForge app, or download the release zip
2. If manual: extract to World of Warcraft\_retail_\Interface\AddOns\
   • The folder should be named CooldownTimeline3
   • It should contain CDTL3.lua, the .toc files, and subdirectories
3. Log in and type /cdtl3 to open options

First run: The bar appears in the center of your screen, unlocked. Drag it to your preferred position, then lock it via /cdtl3 lock.

Upgrading from CDTL2: your settings migrate automatically (CDTL2DB → CDTL3DB) on first load.

Primary command is /cdtl3 (or /cooldowntimeline3). The old /cdtl2 still works as a legacy alias.

Open with /cdtl3 or the minimap button — everything lives in one movable window:

• Lanes — each lane's size, position, icon scale, direction, and appearance (textures + colors, class color)
• Bar Frames — castbar-style bars: textures, colors (custom / class / spell school), Dynamic Color, and bar text
• Ready — sound, flash color, and display duration for ready alerts
• Filters — per-spell tracking: enable/ignore, lane and bar assignment, custom CD time override
• Global — detection modes, tooltips, colors, import/export
• Profiles — AceDB profiles for per-character or shared configs

On login and spec change, CDTL3 scans your spellbook and builds a cooldown list automatically. You can supplement this with the custom detection list in options, or force-track a spell with its ID. Detected spells appear in Filters once they've been cast at least once on that character.

v3.0.12

WoW: Forever launch

• Forever gets its own spell data — Forever reads the Classic Era spell list, but its spells differ. The list is now corrected from Forever's own game data: spells and ranks Forever doesn't have are dropped, renamed spells use their Forever names, and cooldowns match Forever (Lay on Hands is 20 minutes). Forever's new Swift Judgement now starts its cooldown when used, and Elemental Mastery, which no longer does on Forever, is treated as a normal cooldown
• Pet abilities and ranked spells count down in combat (Forever and Retail) — while the game hides cooldown timings, pet abilities, and spells cast at a higher rank than the one CDTL3 first saw, kept resetting to just under their full cooldown. Their casts are now timed properly
• "Cooldown starts when used" spells count from when the effect ends (Forever and Retail, while timings are hidden) — a Stealth opener or a held Nature's Swiftness no longer shows ready early

Fixes

• MoP Classic and Retail: "cooldown starts when used" spells work — Nature's Swiftness, Presence of Mind, Stealth, Prowl, Feign Death, Misdirection, Tricks of the Trade and the rest went straight to "ready" because these clients had no spell list. They now have one, checked against each client's game data
• Retail: no longer listed as out of date — the retail TOC now declares 12.1.5
• Items are no longer hidden by mistake — an item could be saved as Ignored when its cooldown stayed hidden from addons until it ran out (Forever, Retail), or after a ready item was moved to another lane or the Ignore Threshold slider was dragged. If an item vanished that way, untick Ignored on it under Filters
• Moving cooldowns keeps their timers — the Ignore Threshold slider and the Filters lane picker no longer restart running timers or set off a burst of ready sounds
• Filters bulk controls change only this character's entries — the Ignore Threshold slider, Set All, Clear Settings and Clear Quest Items also changed other characters' entries, which the list doesn't show. Clearing an entry another character also uses now only removes it for you
• Retail: options that need the combat log are hidden — Blizzard closed the combat log to addons in 12.0, so enemy debuffs, melee swing timers and spell-school colors are hidden as on Forever
• Spell School Color no longer greys out bars where the combat log is closed — a profile imported with it on painted every bar grey with no visible way to turn it off
• Minimap button: right-click toggles lock and unlock — it could only lock
• Spell list upkeep — Classic Era Season of Discovery rune cooldowns corrected and a spell ID that doesn't exist removed; the Wrath Death Knight list no longer loads on MoP Classic and Retail, where its IDs and names are wrong

v3.0.11

Fixes

• Nature's Swiftness and the other "cooldown starts when used" spells now work on Classic Era, TBC Anniversary and WoW: Forever — the 3.0.10 fix finds these spells in the addon's built-in spell lists, but those lists were only ever loaded on Cataclysm-and-newer clients, which have no lists of their own. On Classic Era, TBC Anniversary and Forever the fix had nothing to read, so Nature's Swiftness still went straight to "ready". The lists now load on every client
• Shaman Nature's Swiftness was missing from the Classic Era spell list, and Classic Era Cold Blood wasn't marked as starting its cooldown when used; both corrected, checked against the Classic Era game data
• New /cdtl3 oaf — prints the built-in spell list, every saved "cooldown starts when used" spell and the live state of any such cooldown, for troubleshooting

v3.0.10

New

• Hide out of combat — Global tab toggle: every lane, bar frame and ready frame fades while you're out of combat and appears the moment a pull starts. Cooldown detection keeps running the whole time, so a cooldown started on the last pull is still tracked and shown on the next one. Unlock frames, Edit Mode and test mode always show the frames

Fixes

• Nature's Swiftness (and other "cooldown starts when used" spells) now show their cooldown — spells whose cooldown only begins once their effect is used up (Nature's Swiftness, Presence of Mind, Divine Favor, Combustion, Prowl, Feign Death and others) went straight to "ready" when cast and never showed the real cooldown once it started. The addon's special handling for these spells was only ever applied to Stealth and Shadowmeld; it now applies to every spell in its list, including ones you've already saved

v3.0.9

New

• Minimap Radius - The radius of the icon was fixed to match the larger Forever minimap.
• Minimap Toggle - The minimap can now be toggled.

Hide toggle — two ways, both account-wide:

• /cdtl3 minimap — toggles it with a chat confirmation.
• /cdtl3 → Global tab → “Minimap button” checkbox, right above “Enable tooltips”

v3.0.8

New

• Edit Mode support (LibEditMode) — lanes, bar frames and ready frames appear in Edit Mode with quick size sliders and a shortcut to their full settings; positions are saved per Edit Mode layout and follow layout switches. Classic Era keeps /cdtl3 unlock
• Quick Style — one-click looks for every lane, bar frame and ready frame: CDTL3 Classic, Minimal, Blizzard Modern, Class Colours. Minimal and Modern also make icon highlighting visible (the shipped highlight border is "None")
• Copy settings — each lane, bar frame and ready frame can copy every setting from another (name, position and enabled state are kept)
• Per-spell bar colors — Filters → any entry → Own Bar Color; wins over school, class and frame colors
• Spell School Color actually works — schools were never recorded and had no pickers, so every bar was grey. They're now learned from your casts (combat log) with a picker per school under Colors; hidden where the combat log is closed
• Modern Blizzard bar textures — unit-frame health/power bars (including grey, tintable versions) and cast bars, offered only where the client has them
• Per-spec profiles (LibDualSpec) — Profiles → Enable spec profiles

Audit and restructure — the code was audited end to end (it has passed through three maintainers) and the duplicated parts consolidated:

• Import now really applies (it replaced the profile table AceDB doesn't save) and validates the string before touching anything
• Filters fixes: Set All, Clear Individual Settings and Save Custom; items matched by item name; time inputs validated; Ignore Threshold applied once
• Power text tags work for every class; "highlighted" tags read the right setting; class color pickers update live; lanes 2/3 got the time-format default lane 1 had
• Every newly discovered spell, item, buff, rune and custom is built by one set of helpers (13 copies had drifted apart — e.g. the Ignore Threshold was inclusive in some and not others)
• Lanes, bar frames and ready frames are each declared once in the defaults (about 1,150 duplicated lines removed); border options are generated from one function
• Unit events are registered for you and your pet only, so raids no longer wake the addon for every member
• Options that depend on the combat log (enemy debuffs, melee swing, school colors) say so or hide where it's closed
• Dead code removed throughout

• All settings now live in one movable window — /cdtl3 opens the full configuration with every panel (Lanes, Ready, Bar Frames, Filters, Profiles) as a tab. Previously most settings — including the lane and bar color options — were only reachable through Blizzard's unmovable Settings frame. Blizzard's AddOns entry is now just a launcher button
• New slash shortcuts: /cdtl3 lanes | ready | bars | filters | profiles
• New: Dynamic Color for cooldown bars — blends from a warning color into a ready color over the final seconds (Bar Frames → Bars)
• New: Spell School Color toggle for bars
• Midnight 12.1 (Curse of Ula'tek) compatibility — aura tracking hardened against 12.1's secret-aura rules; no more errors in combat, Mythic+, or PvP
• Fixed aura-triggered entries recording spell ID 0 (long-standing CDTL2 bug)

• Fixed the Custom CD Time override being overwritten by the live (base) cooldown every frame (3.0.6)
• Fixed checkerboard minimap button / AddOns-list icon on Midnight — TGA textures (3.0.5)
• Fixed secret-cooldown crashes on Midnight (Lane view error spam); completed the CDTL2 → CDTL3 rename with automatic settings migration (3.0.4)

• CDTL3 continuation: Midnight compatibility (SetFont secrets, nil-checks), minimap button, profile-wipe fix on Classic flavors, automated CurseForge/Wago release pipeline

• Near-complete V2 rewrite: multi-lane support, AceConfig options, auto-detection overhaul, Masque + LibSharedMedia integration, ICD tracking, shared cooldowns, AceDB profiles

• Original Cooldown Timeline addon — the cooldown-icon timeline concept

• <input id="" class="task-list-item-checkbox" disabled="disabled" type="checkbox" aria-label="Incomplete task"> Improved spell detection — catch more proc ICDs automatically
• <input id="" class="task-list-item-checkbox" disabled="disabled" type="checkbox" aria-label="Incomplete task"> Compact mode — smaller single-row layout option
• <input id="" class="task-list-item-checkbox" disabled="disabled" type="checkbox" aria-label="Incomplete task"> Retire the legacy CDTL2DB declaration — once users have migrated off CDTL2

Personal use. Credits to original authors above.