- Animated toast notifications for all loot types: items, gold, currency, quest items, XP, and honor gains
- Quality-colored item names with configurable minimum quality filter
- Stacking feed with configurable max toasts and growth direction (up/down)
- Smooth entrance, attention, and exit animations
- Duplicate stacking (x2, x3...) and consecutive XP gain aggregation
- ElvUI skin matching: automatically uses ElvUI fonts, textures, and borders when detected
- Toggleable toast info: icon, item level, type/subtype, looter name, quantity
- Shift-click to link items in chat, hover for tooltip
- Combat deferral: queue toasts during combat, flush when combat ends
- Optional loot sounds via LibSharedMedia
- Minimap icon with quick-access controls (left-click config, right-click toggle, shift-click test)
- Full LibSharedMedia-3.0 support for fonts, textures, and sounds
| Version | Interface | Status |
|---|---|---|
| TBC Anniversary | 20505 | ✅ Primary |
| Mists Classic | 50502, 50503 | ✅ Supported |
| Retail | 110207, 120001, 120000 | ✅ Secondary |
-
Download the latest release from one of the sources above
-
Extract the
DragonToastfolder into your AddOns directory:World of Warcraft/_retail_/Interface/AddOns/DragonToast/ -
Restart WoW or type
/reload
All commands use the /dt prefix (or the full /dragontoast):
| Command | Description |
|---|---|
/dt |
Toggle addon on/off |
/dt config |
Open settings panel |
/dt lock |
Toggle anchor lock (drag to reposition) |
/dt test |
Show a test toast |
/dt testmode |
Toggle continuous test toasts |
/dt clear |
Dismiss all active toasts |
/dt reset |
Reset anchor position to default |
/dt status |
Show current settings |
/dt help |
Show available commands |
- General: Enable/disable addon, show minimap icon, defer toasts during combat, test mode toggle, show test toast, clear all toasts
- Filters: Minimum item quality (Poor through Legendary), loot sources (self, group), reward types (gold, currency, quest items, XP, honor)
- Display: Layout (max toasts, growth direction, spacing), toast size (width, height), toast content (icon, item level, type/subtype, quantity, looter name, gold format, text padding), position (unlock anchor, reset position)
- Animation: Enable/disable animations, timing (entrance duration, display duration, fade-out duration), entrance (animation style, distance), attention (animation style, minimum quality, repeat count, delay), exit (animation style, distance), repositioning speed
- Appearance: Font (face, primary/secondary size, outline), background (color, opacity, texture), border and glow (quality-colored border, thickness, texture, quality glow strip, glow width, glow texture), icon size, ElvUI style matching
- Sound: Enable/disable notification sound, sound effect picker via LibSharedMedia
- Profiles: AceDB profile management (create, copy, delete, reset)
Access settings with /dt config or click the minimap icon.
DragonToast provides a generic AceEvent messaging API for other addons to control toast behavior:
| Message | Payload | Purpose |
|---|---|---|
DRAGONTOAST_SUPPRESS |
source (string) |
Suppress item toasts while your addon handles loot |
DRAGONTOAST_UNSUPPRESS |
source (string) |
Resume normal toast display |
DRAGONTOAST_QUEUE_TOAST |
toastData (table) |
Queue a custom toast notification |
Messages are fire-and-forget via AceEvent:SendMessage() - no dependency on DragonToast required. See AGENTS.md for the full toast data contract and integration guide.
Contributions are welcome! Please read CONTRIBUTING.md for setup, coding standards, and the PR process. All contributors are expected to follow the Code of Conduct.
If you would like to support Dragon Toast, you can sponsor the project on GitHub Sponsors or buy me a coffee on Ko-fi.
This project is licensed under the MIT License. See the LICENSE file for details.
Made with ❤️ by Xerrion
