CursorSpellTracker

CursorSpellTracker is a lightweight World of Warcraft addon that shows selected spells, cooldowns, auras and procs near your mouse cursor.

The idea is simple:
keep important combat information close to your attention without adding unnecessary clutter or unnecessary performance overhead.

CursorSpellTracker is built around selected tracking, not broad automatic scanning.

## Features

- Track selected spells directly at your cursor
- Track selected auras and procs
- Show cooldowns, charges and duration bars
- Arrange active entries in 1–5 cursor rows per character and specialization
- Inverted Spells: show selected spells while unavailable or on cooldown
- Clean Square Icons option for a cleaner icon appearance
- Optional sound notifications for selected spells, auras and procs
- LibSharedMedia-3.0 support for additional sounds
- Aura/Proc tracking mirrored from Blizzard's Cooldown Manager
- Optional sound when a tracked aura or proc becomes active, and shortly before it expires
- Proc Highlight system
- Adjustable icon size, spacing, layout, fonts, colors and highlights
- Reworked profile system with automatic profile visibility
- Global general settings support
- Export/Import for spell profiles, general settings, complete profiles and full backups
- Option to hide the minimap button
- German and English localization

## Spell and Aura Tracking

CursorSpellTracker separates spell tracking and aura/proc tracking by source.

If an entry is added through the Spells tab, it is treated as a spell/cooldown entry.
This means it can be shown while available or unavailable and can be inverted.

If an entry is added through the Auras/Procs tab, it is treated as an aura/proc entry.
This means it is shown based on the active aura/proc state.

This is especially important for abilities that are both a castable spell and an active buff.

## Cooldown Manager Integration

Aura and proc tracking mirrors Blizzard's Cooldown Manager instead of relying on a fixed internal list of supported spells.

CursorSpellTracker reads the state Blizzard itself has already resolved, so a tracked buff appears at your cursor with its icon, active state, stacks and duration wherever that information exists.

Some buffs report no readable duration at all. Those are still shown with icon, active state and stacks — only the timer and the expiry warning are unavailable for them, because the data does not exist rather than being hidden.

## Profiles

CursorSpellTracker supports separate spell profiles and general settings.

General settings can be shared globally, while active spell lists, cursor rows and sorting can stay character- and specialization-specific.

Profile dropdowns are automatically filtered to reduce clutter:
the current automatic profile, custom profiles and the Global Profile remain visible, while unnecessary automatic profiles are hidden by default.

**Important for existing users:**
The profile system and data structure were changed significantly in v1.2.0. In some cases, active spell lists may need to be selected again, recreated or restored from a backup. Sorry for the inconvenience.

## Icon Appearance

CursorSpellTracker includes a Clean Square Icons option in the display settings.

This option provides a cleaner square icon appearance without requiring external skinning addons.

Masque support is not included yet.

## Sounds

Sounds are optional and disabled by default per character.

A tracked spell can play a sound when it becomes ready. A tracked aura or proc can play a sound when it becomes active, and a second sound shortly before it expires.

The expiry warning needs a remaining time that is actually readable. For a small number of buffs Blizzard exposes no duration at all — those can still be tracked and shown, but they cannot produce an expiry warning.

Sounds can be played through Master, Sound Effects, Dialog, Ambience or Music.

CursorSpellTracker supports sounds registered through LibSharedMedia-3.0.

Custom sound packs are not bundled with the main addon.

## Support

For feedback, bug reports, support or development updates, please use:

**Email:** cst-support@andystechcave.com
**Instagram:** @andystechcave
**YouTube:** @andystechcave

When reporting a bug, please include:

- CST version
- WoW version
- Client language
- Class and specialization
- Spell name or SpellID
- Expected behavior
- Actual behavior
- Steps to reproduce

Useful debug commands:
```
/cst profiledump
/cst profiledebug
/cst statedebug SPELLID
/cst actiondebug SPELLID
/cst drawdebug SPELLID
/cst auracheck SPELLID
/cstcdmdebug SPELLID
/cst auradiscovery
```

## Notes

CursorSpellTracker is designed with performance and combat stability in mind.
It focuses on selected spells and effects instead of broad automatic scanning.
No custom sound packs are bundled with the main addon.
Resource alerts are not included.

The CursorSpellTracker Team
Andyman382 | Andy's Tech Cave