# HNZ Healing Tools

A lightweight World of Warcraft (Retail) addon for healers and cooldown-heavy specs. Surfaces your spells, auras, and raid-note reminders through complementary displays — cursor icons, character rings, a central cooldown pulse, and an MRT/NSRT timeline reminder — so you can keep your eyes on the action instead of glancing at action bars or the chat frame.

![Interface](https://img.shields.io/badge/Interface-12.0.1-blue) ![License](https://img.shields.io/badge/License-MIT-green) ![Version](https://img.shields.io/badge/Version-1.2.0-orange)

---

## Features

### Display modes

- **Cursor Icons** — floating icons next to the mouse cursor showing tracked spells (cooldown sweep, charges, range/power state) and tracked auras (stack count and remaining time).

- **Character Rings** — concentric circular progress rings around your character that drain as the aura expires. Per-aura color, optional inline icon, configurable thickness/spacing/segments.

- **Cooldown Pulse** — large central icon that briefly flashes when a tracked spell finishes its cooldown or a tracked aura is gained. Optional sound cue per entry.

- **Cursor Ring** *(optional)* — decorative ring following the mouse, with sub-features:

- **Cast progress** — 180-wedge progress sub-ring that fills during `UnitCastingInfo` / `UnitChannelInfo`.

- **Center dot** with optional grow-on-movement.

- **Trail** — mouse trail with configurable color, lifetime, and visibility.

- **Sparkles** — particle effects (dot / thin ring / thick ring / wedge / mixed), with path-fill so fast cursor moves don't leave gaps.

- Class-color option for the ring.

### MRT / NSRT Timeline Reminders

Parses your raid notes from **Method Raid Tools** or **Northern Sky Raid Tools** and shows reminders for each spell you're assigned, near the cursor / around your character / as a center pulse, as the trigger time approaches.

- Dual format parser: MRT (`{time:M:SS.t} - Name {spell:N}`) and NSRT (`time:N;tag:Name;spellid:N`).

- One note per encounter — auto-detection of `EncounterID` / `Name` from the NSRT header on import.

- **Difficulty filter per note**: LFR / Normal / Heroic / Mythic checkboxes; runtime matcher picks the right note for the current pull. Keep variants of the same fight for different difficulties.

- **Manual enable toggle per note** (checkbox in the row) — alternate between notes depending on raid comp without deleting them.

- **Encounter Journal integration**: boss portrait + raid name in each row, autocomplete by boss name in the ID field.

- State machine per entry: `PRE` (countdown 3,2,1 with dim icon), `ACTIVE` (saturated icon, configurable window), `CONSUMED` (cast detected via `UNIT_SPELLCAST_SUCCEEDED`).

- Three visual integrations, selectable: cursor (stacked icons), ring (segmented progress around the player), pulse (one-shot at trigger).

- Optional sound on trigger with LibSharedMedia awareness and channel selector.

- **Test pull** button to preview any note without being in the encounter.

### Tracking flexibility

- Track spells by **ID or name** (drag-and-drop from spellbook supported).

- Auras on any unit (`player`, `target`, `focus`, `pet`, `mouseover`) with `HELPFUL` / `HARMFUL` filters.

- Per-aura **show modes**: always, only when active, only when missing.

- Minimum stacks threshold and manual duration override for hidden auras.

- **Visibility dropdown** per feature (Always / Only in combat / Only out of combat), applied to displays and sub-features (trail, sparkle, etc.).

HNZ Healing Tools (Cursor Icons, Ring & MRT / NSRT)