Description
Dragon Toast
Every drop deserves a toast: a dragon-forged loot feed for your adventures.
🐉 Features
- 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
🎮 Supported Versions
| Version | Interface | Status |
|---|---|---|
| TBC Anniversary | 20505 | ✅ Primary |
| Mists Classic | 50502, 50503 | ✅ Supported |
| Retail | 110207, 120001, 120000 | ✅ Secondary |
📦 Installation
Download
Manual Install
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
⌨️ Commands
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 |
⚙️ Configuration
- 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.
🔌 Integration API
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.
🤝 Contributing
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.
❤️ Support
If you would like to support Dragon Toast, you can sponsor the project on GitHub Sponsors or buy me a coffee on Ko-fi.
📄 License
This project is licensed under the MIT License. See the LICENSE file for details.
Made with ❤️ by Xerrion