Collection of custom World of Warcraft AddOns specifically developed for Warmane's WotLK (3.3.5a) servers.
A big thanks goes to the owner of 3.3.5-interface-files GitHub repository, which I'm using a lot during the development.
First-party AddOns expose in-game settings under Interface -> AddOns -> Warmane AddOns.
📋 Tracks completed dungeon runs and stores both run history and aggregated per-character/per-instance stats.
- Main table UI (
/wit) now shows:CharacterInstanceTotal RunsAverage TimeFastest TimeLevels Per MinuteLevels Per Run
- Character rows include the latest known level in the table, for example
Baladie (42)- WIT updates the saved character level when you level up and when you enter the world on that character
- Instance names in the table include level ranges where available, for example
Wailing Caverns (15 - 25) - WIT normalizes known alternate dungeon names reported by the client/Warmane, including hub-and-wing names such as
Auchindoun: Sethekk Halls. - Completion detection handles known multi-step finales, including revived bosses, paired final bosses, and RDF completion rewards for scripted non-kill endings.
- Max-level and other no-XP runs are handled safely:
- Such runs still increase run counts and time statistics
- Level-based columns show
-when no precise level-progress data exists for that character+instance row - Level averages are calculated only from XP-bearing runs, so level 80 clears do not drag leveling stats down to zero
- Table quality-of-life features:
- Live text search filters rows as you type
- Character dropdown filter supports
Allplus multi-select toggles with instant checkmark updates - Clicking a column header sorts ascending/descending by that column
- Column widths are configurable in
addons/WarmaneInstanceTracker/vars/Constants.lua
- Table actions:
SettingsopensInterface -> AddOns -> Warmane AddOns -> Instance TrackerExportopens an in-game CSV export dialog with copyable text- Export is intentionally in-client only: WoW 3.3.5a addons cannot write files to arbitrary paths like
C:\wit-export
- Slash commands:
/witopens or closes the stats table/wit onand/wit offenable/disable instance tracking without reloading the UI/wit helpshows help
- Interface Options panel (
Interface -> AddOns -> Warmane AddOns -> Instance Tracker) includes:- Run statistics buttons: open table, export CSV
- Current run controls: status, start/end, pause/continue, reset, and live elapsed time
- User settings: instance tracker, party completion message
- Table settings: character scope, level-range filter, table size
- Developer settings: debug printing, debug logging
- On completion, can post one summary line to party chat:
[WIT] <instance> completed in <time>. Levels per minute: <value>. Levels per run: <value>.
- SavedVariables are split for clarity:
InstancesData(runs + aggregated stats)SettingsData(user/developer toggles)DebugData(debug death log)- New runs save per-run
levelsGainedplus alevelstable of level-to-next-level XP values, for example[30] = 38880 - Aggregated stats use a dedicated schema migration path so historical runs can be rebuilt after stat structure updates
⏰ Reminds you about upcoming Wintergrasp battle.
- Uses the in-game
GetWintergraspWaitTime()API for accurate battle timing - Shows notifications at 30, 15, and 5 minutes before battle
- Also shows notification right after the battle begins and ends
- Slash command
/wwrchecks time until next battle - Slash commands
/wwr onand/wwr offenable/disable automatic reminders without reloading the UI - Interface Options panel:
Warmane AddOns -> WG Reminder - Type
/wwr helpfor a list of available commands
ℹ️ This AddOn is only activates if logged in as a level 80.
📄 Makes chat messages copyable on mouse click.
- Click on a channel name to copy the message into a new window
- For messages without a channel, click into the message directly instead
- You can copy messages from the copy window with
CTRL-C - Works with all message types (channels, system, say, ...)
- Does not intervene with item or quest links, usernames, etc.
- Copying more messages makes them appear under eachother in the click order
- Clear button to reset the copy window content
- Slash commands
/wcc onand/wcc offenable/disable copying persistently without reloading the UI - Slash command
/wccshows help - Interface Options panel:
Warmane AddOns -> Chat Copy - Type
/wcc helpfor a list of available commands
🎯 Automatically switches Hunter tracking based on target type.
- Smart tracking switching for Hunters
- Triggers only for neutral/hostile targets
- GCD-aware to prevent false switching
- Implemented to work with manual tracking switching as well
- Slash commands
/wta onand/wta offenable/disable tracking switching without reloading the UI - Interface Options panel:
Warmane AddOns -> Tracking Aid - Type
/wta helpfor a list of available commands
ℹ️ This AddOn only activates if logged in as a Hunter.
💬 Warns your group when you are low on mana as the assigned healer.
- Active inside party/raid instances and while grouped outside instances; both location toggles are enabled by default
- Selected group sizes still control auto-activation; 5, 10, and 25-player groups are enabled by default
- Uses Blizzard's assigned healer role when available, with a healer talent/class fallback for manual portal groups
- Sends
Healer Mana: I'm out of mana!to group chat with a configurable 60-second default cooldown - Enabling the AddOn mid-fight starts a full warning delay before the first low-mana shout
- Slash command
/whmshows help - Slash commands
/whm onand/whm offenable/disable healer mana warnings without reloading the UI - Slash command
/whm helpshows help - Interface Options panel:
Warmane AddOns -> Healer Manawith enabled, inside/outside location, delay, mana threshold, and group-size auto-activate controls
💬 Warns your group when you have aggro as the assigned healer.
- Active inside party/raid instances and while grouped outside instances; both location toggles are enabled by default
- Selected group sizes still control auto-activation; 5, 10, and 25-player groups are enabled by default
- Uses Blizzard's assigned healer role when available, with a healer talent/class fallback for manual portal groups
- Sends
Healer Protection: I have aggro!to group chat with separate inside-instance and outside-instance cooldowns - Defaults to a 60-second inside-instance delay and 30-second outside-instance delay
- Defaults to 3 non-boss mobs or 1 boss mob inside instances, and 1 non-boss mob or 1 boss mob outside instances
- Enabling the AddOn mid-fight starts a full warning delay before the first aggro shout
- Slash command
/whpshows help - Slash commands
/whp onand/whp offenable/disable healer protection warnings without reloading the UI - Slash command
/whp helpshows help - Interface Options panel:
Warmane AddOns -> Healer Protectionwith enabled, inside/outside location, separate inside/outside delay and aggro-count threshold, and group-size auto-activate controls - Checks visible hostile targets and recent direct combat-log hits to detect mobs directly attacking you, without treating boss spell casts alone as aggro
🟢 Automatically clears your <Away> status when you become active.
- This should be WoW's default behvaior, but I've been having problems with it on Warmane
- Uses Blizzard's built-in
autoClearAFKoption to keep behavior safe and lightweight - Re-enables AFK auto-clear when the AddOn loads and when entering the world
- Slash commands
/wna onand/wna offenable/disable AFK auto-clear without reloading the UI - Interface Options panel:
Warmane AddOns -> Not Away - Type
/wna helpfor a list of available commands - No key listener, no polling loop, and no manual
/afksimulation
🧳 Backported third-party minimap button bag for Warmane's WotLK 3.3.5a client.
- Lives separately from first-party AddOns in
backports/MBB - Collects minimap buttons into a single pop-out menu
- Persists the MBB button position per character across
/reloadand addon syncs - Keeps the original AddOn identity while applying compatibility and bug fixes for this repository
- Includes English UI text only
A filterable, sortable in-game table tracking your dungeon runs with leveling context, level/time averages, and copyable CSV export.
Timely reminder for Wintergrasp battles to ensure you never miss one again.
Separate window to copy any message from the chat, created by clicking on the channel name or into the message directly.
Reactive tracking system adapting to enemy types in PvP combat.
No more getting stuck with <Away> above your name after you are already back in action.
- Download the latest release
- Extract the AddOn folders from the
addons/directory to yourWorld of Warcraft 3.3.5a/Interface/AddOnsdirectory - Ensure AddOn names match exactly (case-sensitive)
- Restart WoW if it was running
All AddOns are standalone, install only the ones you want to use.
This project is being under active develompent as of April 2026.
- If you encounter a bug or have a feature request for existing AddOn, open a GitHub issue
- If you have an AddOn idea, you can email me on
info@matejkadlec.cz- If I'll find it interesting, there's a good chance I will create it for you for a voluntary donation
- If I don't find it interesting, I can still do it for a fixed price (I can provide an invoice)
- Feel free to you use any of my AddOns in your project, in that case a link back to this repository is appreciated
-
Contributors are welcome, just create a PR and assign it to me for a review
-
Some general rules for all PRs, as we don't want any spaghetti code:
- Follow Lua language conventions and WoW AddOn development best practices
- If you code in VSCode, I highly recommend WoW Bundle extension
- Use PascalCase for function names and camelCase for variable names
- Comment your code
- Update this file so the description and screenshot correspond to the latest AddOn version
- Follow Lua language conventions and WoW AddOn development best practices
-
Additional rules for for completely new AddOns for this repository:
- Follow the naming format
Warmane[AddOn][Name]for consistency - Each AddOn must be fully standalone with no cross-AddOn dependencies
- Required
.tocfile attributes:## X-Collaboration: Matej Kadlec (https://github.com/matejkadlec) ## X-Repository: https://github.com/matejkadlec/warmane-addons
- Follow the naming format
-
Otherwise, there are no rules for branch names etc., just make it that the commit messages make sense
If you are developing the AddOns, you can sync the whole addons/ directory into your WoW client with the helper script:
- Copy
.env.sync-addons.exampleto.env.sync-addons - Set
SYNC_ADDONS_DEST_DIRto the absolute path of yourInterface/AddOnsfolder - Decide whether
SYNC_ADDONS_AUTO_INSTALL_RSYNCshould betrueorfalse- Set it to
trueif you want the script to try installingrsyncautomatically withapt-get - Set it to
falseif you prefer the script to skip installation attempts and usecpfallback when needed
- Set it to
- Run
./scripts/sync-addons.sh
Optional variables:
SYNC_ADDONS_SOURCE_DIRif your sourceaddons/directory lives somewhere elseSYNC_ADDONS_RSYNC_BINif you want to point to a specificrsyncbinary
The real .env.sync-addons file is ignored by Git, while .env.sync-addons.example stays in the repository as the shared template.
Made with ❤️ for the Warmane community