# 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
The ElvUI_DebuffHighlight Team
