# ElvUI Debuff Highlight

Adds **dispellable debuff highlighting** to ElvUI party and raid unit frames.

Built from scratch for **WoW 12.0 Midnight** using the new Secret Values–safe API.

---

## Features

### Visual Indicators

- **Border Glow** — Colored border around the unit frame matching the debuff's dispel type

- **Color Overlay** — Semi-transparent color tint over the health bar

- Both can be enabled independently or combined

### Dispel Type Color Coding

| Dispel Type | Color |

|-------------|-------|

| **Magic** | Blue |

| **Curse** | Purple |

| **Disease** | Brown |

| **Poison** | Green |

| **Non-dispellable** | Red (optional) |

### Smart Filtering

- **Dispellable-only mode** — Only highlights debuffs YOUR class/spec can actually dispel

- **Non-dispellable toggle** — Optionally show non-dispellable debuffs in red

- Automatically detects your current specialization and updates dispel capabilities on spec change

### Supported Frames

- Party frames

- Raid frames (5–40)

- Tank frames

- Assist frames

- All toggle-able per frame type

### Class/Spec Dispel Detection

Automatically detects dispel capabilities for all healing and hybrid specs:

| Class | Specs with Dispel | Types |

|-------|-------------------|-------|

| Priest | Holy, Discipline, Shadow | Magic, Disease |

| Paladin | Holy | Magic, Poison, Disease |

| Paladin | Protection, Retribution | Poison, Disease |

| Shaman | Restoration | Magic, Curse |

| Shaman | Elemental, Enhancement | Curse |

| Mage | All | Curse |

| Druid | Restoration | Magic, Curse, Poison |

| Druid | Balance, Feral, Guardian | Curse, Poison |

| Monk | Mistweaver | Magic, Poison, Disease |

| Monk | Brewmaster, Windwalker | Poison, Disease |

| Warlock | All | Magic (on pets/allies) |

| Evoker | Preservation | Magic, Poison |

| Evoker | Devastation, Augmentation | Poison |

---

## Configuration

Open ElvUI config with `/ec`, then navigate to:

**UnitFrames → Debuff Highlight**

### Options

| Option | Description | Default |

|--------|-------------|---------|

| Enable | Master toggle | On |

| Border Glow | Show colored border around frame | On |

| Background Overlay | Show color tint over health bar | On |

| Border Size | Border thickness (1–10 px) | 2 |

| Overlay Alpha | Overlay opacity (5–100%) | 25% |

| Dispellable Only | Only show debuffs you can dispel | On |

| Show Non-dispellable | Also highlight non-dispellable debuffs | Off |

| Party / Raid / Tank / Assist | Per-frame-type toggles | All On |

---

## Technical Details

### 12.0 Midnight API Compatibility

WoW 12.0 introduced **Secret Values** — aura data fields (`dispelName`, `isHarmful`, etc.) are now opaque and cannot be read or compared by addon code.

This addon works around Secret Values using:

1. **`C_CurveUtil.CreateColorCurve()`** — Creates a ColorCurve object for dispel type → color mapping

2. **`C_UnitAuras.GetAuraDispelTypeColor(unit, auraInstanceID, colorCurve)`** — Returns the dispel color directly without exposing the raw dispel type as a readable value

3. **`C_UnitAuras.GetDebuffDataByIndex()`** — Iterates debuffs by index, only accessing `auraInstanceID` (non-secret)

This approach is fully compliant with Blizzard's 12.0 security model and will not trigger secret value errors.

### Performance

- Only scans on `UNIT_AURA` events (no polling)

- ColorCurve object is cached (created once, reused)

- Frame hooks are applied lazily (only when frames exist)

- Minimal memory footprint

---

## Requirements

- **World of Warcraft** 12.0+ (Midnight)

- **ElvUI** 15.0+

---

## Installation

1. Download and extract to `World of Warcraft/_retail_/Interface/AddOns/`

2. Ensure the folder is named `ElvUI_DebuffHighlight`

3. Restart WoW or `/reload`

4. Configure via `/ec` → UnitFrames → Debuff Highlight

---

## Changelog

### v1.1.0

- Full 12.0 Midnight Secret Values API support

- Uses `C_CurveUtil.CreateColorCurve` + `C_UnitAuras.GetAuraDispelTypeColor`

- Safe ElvUI module hooks with existence checks

- ElvUI plugin system integration (`EP:RegisterPlugin`)

### v1.0.0

- Initial release