DragonLoot replaces the default Blizzard loot window and roll frame with cleaner, more configurable replacements, and adds a dedicated loot history panel for tracking drops and winners.
- Modernized UI: Replaces the Blizzard loot window, roll frames, and introduces a loot history panel.
- Advanced Roll Frames: Custom frames featuring timer bars, an overflow FIFO queue, item-level overlays, and configurable layouts (including 3-row mode and hide-after-voting).
- Loot History: Track drops with class-colored winners, time-ago refresh intervals, and direct loot tracking via
CHAT_MSG_LOOTfor items picked up without a roll. - Smart Notifications: Filter Need, Greed, Disenchant, and Transmog notifications by instance type and item quality.
- DragonToast Integration: Suppresses duplicate toasts during loot and queues celebration or result toasts.
- ElvUI Compatibility: Detects conflicting ElvUI loot modules and provides a one-time prompt to disable them.
- Complete Customization: Control fonts (including outlines), per-frame icon sizes, quality-colored borders, LSM textures, and frame colors/transparency.
- Animated Transitions: Powered by LibAnimate with 4 selectable open/close styles and configurable durations.
- Modern Addon Stack: Minimap button support (LibDBIcon), AceDB profile management, and support for 11 locales.
- Performance Optimized: Companion
DragonLoot_Optionsaddon is LoadOnDemand to keep memory usage low during play.
| Client | Interface Versions |
|---|---|
| Retail | 120005 |
| TBC Anniversary | 20505 |
| MoP Classic | 50503 |
Available on major platforms:
- Download the latest release.
- Extract the
DragonLootandDragonLoot_Optionsfolders into your AddOns directory:World of Warcraft/_retail_/Interface/AddOns/
- Restart World of Warcraft or type
/reloadin-game.
DragonLoot is split into two modules to optimize performance:
- DragonLoot: The core engine that handles loot, rolls, and history. Always loaded.
- DragonLoot_Options: The configuration interface. It only loads when you open the settings panel and embeds the DragonWidgets shared library.
Use /dl or the alias /dragonloot.
| Command | Description |
|---|---|
/dl |
Toggle the addon on or off |
/dl toggle |
Explicitly toggle the addon on or off |
/dl enable |
Enable the addon |
/dl disable |
Disable the addon |
/dl config |
Open the options panel (aliases: options, settings) |
/dl history |
Open the loot history panel |
/dl test |
Spawn a single test roll |
/dl testroll loop |
Start continuous test roll spawning |
/dl testroll stop |
Stop continuous test roll spawning |
/dl reset |
Reset frame positions to defaults |
/dl version |
Print current version information |
/dl help |
Show the command list (alias: ?) |
Settings are stored in DragonLootDB using AceDB profiles.
| Tab | Settings |
|---|---|
| General | Addon toggle, UI lock, minimap icon, DragonToast suppression |
| Loot Window | Open at mouse, scale, lock, slot count, icon size |
| Loot Roll | 3-row layout, hide after voting, item-level overlay, timer texture, stack direction |
| Notifications | Roll type filters (Need/Greed/etc), instance filters, quality threshold, group wins |
| History | Auto-open on loot, max entries, direct loot tracking, minimum quality threshold |
| AutoLoot | Enable, quality threshold, exclusion list |
| Appearance | Fonts, outlines, per-frame icon sizes, quality borders, background/border styling |
| Animation | Toggle, selectable open/close styles (4 types), duration sliders |
| Profiles | Standard AceDB profile management (Save/Copy/Reset) |
DragonLoot features built-in integration with DragonToast. It uses a fire-and-forget communication system (AceComm) to:
- Suppress: Sends
DRAGONTOAST_SUPPRESSwhen loot opens so DragonToast doesn't show duplicate loot alerts. - Unsuppress: Sends
DRAGONTOAST_UNSUPPRESSwhen the loot window closes. - Celebrate: Sends
DRAGONTOAST_QUEUE_TOASTto trigger celebratory notifications for roll wins.
This integration has no hard dependency; DragonLoot works perfectly fine without DragonToast.
DragonLoot automatically detects if ElvUI's built-in loot module is active. To prevent visual conflicts, it will prompt you once to disable the ElvUI loot module. Your choice is remembered, and you can change it at any time in the ElvUI settings.
DragonLoot is localized for the following regions:
enUS, deDE, esES, esMX, frFR, itIT, koKR, ptBR, ruRU, zhCN, zhTW.
Translation contributions are welcome! Please submit a pull request or open an issue on GitHub if you would like to improve a specific locale.
Contributions are welcome! Please refer to AGENTS.md for full coding conventions.
- Linting: Run
luacheck .orjust lint - Testing: Run
busted --verboseorjust test - Formatting: Uses
stylua(just fmt) - Toolchain: Managed via
mise(Lua 5.1) andjustrecipes.
This project is licensed under the MIT License. See the LICENSE file for details.
Made with ❤️ by Xerrion