Description
MochaAlerts
A World of Warcraft addon that plays voice and sound alerts when your tracked spells and items come off cooldown and are ready to cast.
Author: CaffeineCafe
Version: 1.3.2 Interface: 120005 (Midnight 12.0.5)
Features
- Text-to-Speech (TTS) alerts - WoW's built-in TTS engine speaks the spell or item name when it's ready.
- Sound effect alerts - choose from 20+ Blizzard UI sounds or 60+ WeakAuras-style sound effects per spell/item.
- Visual on-screen alerts - animated text and icon overlay with configurable position and scale.
- Per-spell customization - set a custom TTS phrase, custom on-screen text, toggle the icon and text, or enable a double-alert repeat.
- Health Potion grouping - all health pot variants share one alert entry so you're never spammed.
- Fleeting potion grouping - cauldron variants and their base potions are merged into one entry automatically.
- Spell override support - correctly handles talent overrides and form transforms (e.g. Void Meta / Annihilation).
- GCD-immune alerting - alerts are never delayed by the global cooldown; interrupt-like spells (e.g. Disrupt) are auto-detected and gated on the real lockout CD.
- Configurable alert color - change the on-screen alert text color via the built-in color picker.
- Lockout suppression - suppresses false alerts triggered by movement abilities like Roll and Lighter Than Air.
- Configurable poll interval - adjust how frequently the addon checks for cooldown changes (0.01s-0.40s) for snappier or lighter alerts.
- Minimap button - left-click to open settings; drag to reposition around the minimap.
- No dependencies - no external libraries required.
Installation
- Download and extract the MochaAlerts folder.
- Place it in your AddOns directory:
World of Warcraft\_retail_\Interface\AddOns\ - Launch WoW and enable the addon in the character select screen.
Getting Started
Open the config panel with /malerts or click the minimap icon.
Adding spells: Shift-click a spell from your spellbook while the config panel is open, or type a spell name/ID into the Add box and press Enter.
Adding items: Shift-click an item from your bags, type an item name/ID, or click Scan Trinkets to auto-detect equipped trinkets with use effects.
Config Panel
| Control | Description |
|---|---|
| Enable alerts | Master on/off toggle for all alerts |
| Alert during combat | Allow alerts to fire while in combat |
| Unlock / Lock | Enable dragging the alert frame to a new position |
| Reset | Return the alert frame to its default position |
| Alert scale | Resize the alert overlay (50% - 200%) |
| Poll interval | Adjust how frequently the addon polls for cooldown changes (0.01s - 0.40s) |
| TTS Voice | Cycle through available TTS voices; plays a preview on selection |
| Test Alert | Fire a test voice alert |
| Add spell or item | Input box to add by name, ID, or shift-click link |
| Scan Trinkets | Auto-add equipped trinkets with use effects |
Spell / Item Row Buttons
Each tracked entry has a row of buttons on the right side:
| Button | Description |
|---|---|
| Sound dropdown | Choose TTS, None (visual only), or a sound effect |
| > | Preview the configured alert for this entry |
| Icon button | Toggle the spell/item icon on the alert frame |
| T | Toggle the alert text label on/off |
| x2 | Repeat the alert a second time after 1.5 seconds |
| Tt | Set a custom on-screen text override for this alert |
| X | Remove this spell or item from tracking |
When TTS mode is selected, a text box appears below the row where you can type a custom phrase (e.g. "Chaos Strike" instead of the default "Annihilation ready"). Leave it blank to use the default spell name.
Slash Commands
| Command | Description |
|---|---|
/malerts |
Open the config panel |
/malerts add [name or ID] |
Track a spell or item |
/malerts remove [name or ID] |
Stop tracking a spell or item |
/malerts list |
Print all tracked spells and items with their cooldown state |
/malerts scantrinkets |
Auto-add equipped trinkets with use effects |
/malerts toggle |
Enable or disable all alerts |
/malerts on / /malerts off |
Explicitly enable or disable alerts |
/malerts test |
Fire a test voice alert |
/malerts test [name or ID] |
Fire a test alert for a specific spell |
/malerts voice |
List available TTS voices |
/malerts voice [index] |
Select a TTS voice by index (e.g. /malerts voice 1) |
/malerts power |
Show current resource level and any resource threshold settings |
/malerts debug |
Toggle debug output (prints alert events and state changes to chat) |
/malerts tts |
Run full TTS diagnostic (requires debug mode) |
/malerts reset |
Reset all account-wide settings to defaults |
Saved Variables
| Variable | Scope | Contents |
|---|---|---|
MochaAlertsDB |
Account-wide | Global settings: enabled, alert in combat, visual alert on/off, alert scale, alert position, TTS voice index |
MochaAlertsCharDB |
Per-character | Tracked spells and items (including all per-spell customizations) |
Sound Library
MochaAlerts includes 60+ sound effects (sourced from the WeakAuras community sound pack) plus 20 Blizzard UI sounds selectable per spell/item.
Blizzard sounds include: Raid Warning, Ready Check, Alarm Clock, Level Up, Quest Complete, Map Ping, PVP Queue Ready, and more.
Custom sounds include: Air Horn, Batman Punch, Temple Bell, Warning Siren, Roaring Lion, Tada Fanfare, and many more.
Tips
- Spells are stored per character - your Demon Hunter's tracked spells won't appear on your Monk.
- The addon suppresses alerts on zone changes, resurrections, and form transitions to avoid false positives.
- If TTS isn't working, make sure Text-to-Speech is enabled in WoW's Accessibility settings and a voice is selected.
- Use
/malerts debugto troubleshoot alert timing or suppression behavior.
Contact
Questions or feedback? Stop by: twitch.tv/caffeinecafe
Support
If you found MochaAlerts useful, consider buying me a coffee.
Support
If you found MochaAlerts useful, consider buying me a coffee! ☕