Dragon Toast Logo

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 DragonToast folder 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