Cooldown Tracker (Forever)

# CooldownTracker (Forever)

A row of icons above your target frame, and another above your focus frame. When an enemy player uses a tracked ability, its icon appears with a cooldown spiral and the time left, and goes away once the ability is ready again.

## Where it looks

The combat log is closed to addons on Forever, so the addon only sees the abilities used by enemies the game shows you: your target, focus, mouseover, and every enemy nameplate.

- Turn enemy nameplates on (V by default). An enemy who uses Blink on a nameplate before you target them will already have the icon when you do.
- Cooldowns are kept per player, so switching targets back and forth keeps them.
- Only enemy players and their pets count. Mobs that use the same spells are ignored.

## Features

- Target row and focus row, each up to 12 icons. The focus row can be turned off.
- Unlock the rows (`/cdt lock`) to drag them anywhere; they start above the target and focus frames. When locked, they let clicks through.
- Test mode (`/cdt test`): sample cooldowns on the target row, to see the look and place the rows.
- Options window: on/off, focus row, lock, minimap button, icon size (20 to 36), Test, Reset positions and Clear buttons, colour legend and commands.
- Minimap button: left click for options, right click to turn tracking on or off (the icon turns grey when off), drag to move it.
- `/cdt debug` shows what the game lets the addon see; `/cdt debug casts` prints every enemy cast in chat with its spell ID, to spot an ability that is missing from the list.
- No library dependencies. English, French, German, Spanish.

## Commands

- `/cdt toggle`: turn the addon on or off
- `/cdt lock`: lock or unlock the rows
- `/cdt test`: test mode on or off
- `/cdt reset`: put the rows back above the unit frames
- `/cdt clear`: forget every tracked cooldown
- `/cdt options`: options window
- `/cdt minimap`: show or hide the minimap button
- `/cdt status`: current settings, and whether enemy casts are readable or hidden right now
- `/cdt debug`, `/cdt debug casts`: see above

`/cooldowntracker` works as well as `/cdt`. `/cdt` alone lists the commands.

## Limits

- Out of nameplate range, an enemy is invisible to addons on Forever. A cooldown used out of sight is not tracked.
- The game can hide enemy casts from addons in some situations (combat, instanced PvP). Hidden casts are skipped; `/cdt status` says when it happens.
- When the game hides who a player is, a cooldown seen on your target or focus is still shown, but it is forgotten when you change target.
- Cooldown reductions from talents and gear are not known: the base cooldown is shown.
- The PvP trinket and the racials of Forever's two new races are not tracked yet. `/cdt debug casts` gives their spell IDs if you want to report them.

## Known issues

- Written against the Forever client's API and checked offline. Not yet tested against enemy players in game.
- On the Forever beta, the game does not reload addon settings at login, so they reset each session. This is a client bug that affects every addon. The defaults work as is.

## Compared to the TBC Anniversary version

- Rewritten for Forever: enemy casts from what the game shows you instead of the combat log, Vanilla spell IDs and Forever cooldowns, TBC-only abilities removed.
- Added: Preparation and Cold Snap resets, shared trap cooldowns, cooldowns read from the game, options window, icon size, focus row toggle, minimap button, `/cdt options`, `/cdt minimap`, `/cdt status`, French, German, Spanish.

## Credits

By Zerka. Written from scratch for the Forever client, same idea and commands as CooldownTracker for TBC Anniversary.