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.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.