Tank/Healer Death Alert
A tiny, dependency-free WoW addon: plays a sound (and shows a message) the instant your tank or healer dies in your current party/raid. It can also alert on your focus target's death, the raid's Main Assist, or any other group member — each independently toggleable with its own sound.
Why this one instead of DeathAlert/BigWigs/Details
- Doesn't touch the combat log at all — just
UNIT_DIEDandUnitGroupRolesAssigned, both simple roster APIs that Blizzard's Midnight addon restrictions did not lock down. Should stay working across patches without needing updates. - ~150 lines, no external libraries, easy to read/modify yourself.
Installation
- Copy the whole
TankHealerDeathAlertfolder into:World of Warcraft\_retail_\Interface\AddOns\(so you end up with...\AddOns\TankHealerDeathAlert\TankHealerDeathAlert.toc) - Restart WoW (or reload UI with
/reloadif it's already running). - If the addon list shows it grayed out as "out of date", enable "Load out of date AddOns" in the AddOns list at the character select screen (bottom left checkbox) — the interface version this was built against may lag a hotfix or two behind, but the APIs used are stable.
Usage
It works automatically once loaded — no setup needed. Defaults:
- Tank deaths: sound + chat message + raid-warning-style screen message
- Healer deaths: same
- Focus / Main Assist / other group members: off by default, enable in settings if you want them
A minimap button is added (drag it around the minimap border to reposition — works with reshaped minimaps too, e.g. ElvUI's square one). Left-click opens the settings window; right-click prints the current settings to chat.
Settings window
Open it with /tdalert or the minimap button (left-click). Everything is
configured there — there are no other slash commands:
- General checkboxes: enabled, chat message, screen message, debug logging
(verbose
UNIT_DIEDprinting), hide minimap button. - Death Alerts section — one row per category: Tank, Healer,
Focus (your current focus target, whether or not they're in your
group), Assist (the raid's designated Main Assist — a separate raid
assignment from the Tank/Healer role), and Other (any group member
who isn't the tank or healer). Each row has:
- A checkbox to enable/disable that alert.
- A sound picker button — opens a small scrollable sound browser (drag the scrollbar thumb, click the up/down arrows, or use the mouse wheel). "Built-in Sounds" has Raid Warning, Ready Check, Alarm Clock 1-3, Whisper Ping, Auction Window Open/Close, Quest Complete, Menu Open/Close, Character Info Tab. Each sound row in the browser has a small preview button next to it so you can hear a sound without committing to it — click the row itself to actually select it. Pick "Custom ID..." to enter any other SoundKit ID by number. The "Test" button next to the picker replays the currently selected sound.
- A "Simulate" button that fires the real alert (sound + chat + screen message) so you can verify the whole pipeline without an actual death.
- If you have another addon installed that provides LibSharedMedia-3.0 sounds (e.g. SharedMedia, or sound packs bundled with other addons), a "Media Library Sounds" folder appears in each sound browser with all of them. Sounds registered with a "Source - Name" or "Source: Name" naming convention (common for sounds bundled with BigWigs, DBM, KT, Details, etc.) get grouped into their own sub-folder automatically. This addon doesn't bundle the library itself — it only reads from it if something else already loaded it.
How it works (for your own tweaking)
- On
GROUP_ROSTER_UPDATE/PLAYER_ROLES_ASSIGNED/PLAYER_ENTERING_WORLD, it rebuilds a table mapping each group member's GUID to their assigned role (tank/healer/damager, viaUnitGroupRolesAssigned) and whether they're the Main Assist (viaGetPartyAssignment("MAINASSIST", unit)). - On
PLAYER_FOCUS_CHANGED(and on login/reload), it caches your current focus target's GUID separately, since focus doesn't have to be a group member at all. - On
UNIT_DIED, it looks up the dead unit's GUID in those caches. Tank, Healer, and Other are mutually exclusive (a group member has exactly one role); Focus and Main Assist are checked independently, since either can also be a tank, a healer, or (for focus) someone outside your group entirely. - Settings persist between sessions via
TankHealerDeathAlertDB(a SavedVariable), editable via the settings window.
Known limitations
- Role/assist status is only as accurate as what's assigned in the group (via the Blizzard role-check or raid-roster Main Assist assignment). If someone doesn't have a role assigned, they won't trigger tank/healer alerts; if no one is set as Main Assist, that alert never fires.
UNIT_DIEDonly fires for units the client currently has a token for (raid/party members, focus/target, etc.) — this comfortably covers your whole group and your focus target, which is what you want here.