Auracle (De)Buff Monitor

Auracle

Auracle provides compact & customizable filtering, monitoring and grouping of buffs and debuffs.

Overview

Auracle's capabilities are organized roughly into "trackers", "windows" and "styles".

The most important of these is the "tracker", each of which can monitor a list of multiple auras (either buffs or debuffs, but not both at the same time). When any of those (de)buffs are found, the tracker lights up (or changes visually in any number of other interesting and configurable ways).

A "window" is just a collection of trackers that all watch the same unit. On a fresh installation, Auracle provides one window that watches "target", so any trackers in that window will activate according to the (de)buffs on your current target. You can create as many windows as you want, and each one can watch any unit you want (player, pet, focus, etc).

The visual aspects of windows and trackers are controlled by "styles". There is always a "Default" style (one each for windows and trackers), and you can create as many additional styles as you want.

Distribution & Translation

Please note that Auracle is kept current by the author on wowace.com, curse.com and wowinterface.com. If you get it from any other source, you are not guaranteed to get the latest version.

If you would like to help translate Auracle into other languages, please use the WoWAce Localization tool.

Getting Started

Since every role, class, spec and player will be interested in monitoring different (de)buffs, Auracle does not provide any trackers by default. The first thing you'll want to do, then, is add one.

To do this, open Auracle's configuration window, either with the chat command "/auracle" or from Interface Options->AddOns->Auracle. Select the "windows" tab to see your windows (you'll start with one, "Target") and their trackers (none yet). Select the light blue "(Add Tracker...)" option and click the button to add a new blank tracker to the window.

Click the new tracker, and then open its "Auras" tab. Set the type to "buffs" or "debuffs" according to what you want to monitor, and then type the names of as many auras as you want, one per line. Now, whenever your target has any of these (de)buffs applied, this tracker will light up and show the time remaining.

Configuration Ideas

Auracle is highly configurable; there are a great many ways you can set it up to display information however you want. Some ideas:

  • You could set up two windows that both watch "target" (or "focus", etc), but make one of them only visible when the target is a raid boss, and the other one only visible otherwise. Now you can have one set of trackers for bosses, and a different one for trash.
  • You could set up a window style with no border or background, and a tracker style that hides everything (border, icon, text) when missing. Now you can position a window with this style in the middle of your screen, and add trackers to watch for procs (like Clearcasting, for example). Now whenever that proc goes off, you get a big fat icon in the middle of the screen letting you know about it, but when you use it up, it disappears completely.
  • You could set a tracker's text to display the time remaining, and its spiral to display stacks. Now the spiral will fill up (or drain away) in chunks according to how many stacks are present, while the text shows you the duration: a nice compact way to see two kinds of information on the same icon.
  • You could set up trackers for various raid debuffs which are visible when missing, but disappear completely when present. This becomes your "big brother" raid-leader view; if someone slacks and doesn't put up a debuff, that one pops up for you to holler at them, without having to look through the other 40-odd debuffs which are all correctly applied.

Donations

You do not have to donate. Auracle is free, open-source software, and will always be free to use.

However, if you do use and enjoy Auracle, making a donation is a great way to show your appreciation and support future development. I no longer play WoW as a pastime, so the only reason for me to pay the subscription fee is to do addon development; any contribution to cover that cost is greatly appreciated.

If you do choose to donate, you may do so here: Donate!

If you have a PayPal account with an active balance, please consider logging in to your account and using the "send money" feature instead of the Donate button. PayPal deducts a flat fee from all donations, which can be a significant percentage of smaller amounts; if you "send money" instead, no fee will be deducted and your full amount will be donated. To do this, just click "send money" from your account home page, enter "[email protected]" and any amount, and mark it as a "personal gift."

Changelog

1.2.4:

  • SpellID corrections for Mists of Pandaria.

1.2.3:

  • SpellID corrections for Cataclysm.

1.2.2:

  • Overhauled preset categories to match (de)buff changes in 4.0.1/Cataclysm (big thanks to Malazee and many other folks at wow-petopia.com, as well as many folks on wowace.com, curse.com and elsewhere for additional research into the new (de)buff categories).
  • Fixed a bug when displaying stacks on the spiral for auras that don't stack.

1.2.1:

  • Updated SpellIDs for presets +% Damage (Ferocious Inspiration), +% AP (Abomination's Might and Unleashed Rage), +Melee Crit (Rampage) and +Spell Crit (Elemental Oath); the old SpellIDs were deleted by Blizzard when the respective auras became passive instead of procs. If you have trackers based on any of these presets, you may have to manually re-add the missing auras, or else delete and re-create the tracker from the preset.

1.2.0:

  • Added support for weapon buffs / temporary weapon enchants (ticket #12). This only works for the player, and matches on the buff name without rank (i.e. "Rockbiter", not "Rockbiter 1"). Thanks to: "lxs" for submitting an example patch; "Kitjan" for NeedToKnow's weapon buff scanning algorithm; and "ckknight" and "Shefki" for Pitbull4's weapon buff icon guessing algorithm.

1.1.2:

  • Removed obsolete SpellID 51880 from Stun tracker preset (Fire Nova Totem replaced by spell in WoW 3.3, talent no longer stuns).
  • Added error handling and logging for invalid SpellIDs in tracker presets.
  • TOC update for WoW 3.3.

1.1.1:

  • Performance optimizations (hopefully to fix ticket #19).

1.1.0:

  • Added preset (de)buff trackers. These buttons (in each window's "(Add Tracker...)" section) will create trackers pre-configured to track useful groups of (de)buffs.
  • Added support for SpellIDs in tracker (de)buff lists.
  • Added "Move Up" and "Move Down" buttons to tracker settings windows, to rearrange them without having to unlock+drag.
  • When a font set via LSM disappears (i.e. by deleting the addon that provided it), Auracle will now smoothly reset it to the default (built-in) font rather than throwing errors.
  • The "Auracle Enabled" toggle is now remembered after logging out. This setting (like all others) will affect all characters that share the same Auracle profile, but note that Auracle will still consume some memory (but not CPU cycles) while disabled in this fashion, unless you disable it entirely from your "Addons" button on the character selection screen.
  • Fixed support for LibSharedMedia selection widgets (broken 0.4-beta).

1.0.0:

  • No functional changes since beta 0.4, but it's about time to call this a release. Auracle is considered (for the moment anyway) stable and feature-complete, or at least feature-sufficient.

Beta 0.4:

  • overhauled the saved-variables update and validation routines; PLEASE NOTE: although this version should remain backwards-compatible with all previous versions (and you should not lose your setup), it is recommended to make a backup copy of your "WoW/WTF/Account/<account>/SavedVariables/Auracle.lua" file just in case (especially if you have a complicated setup!)
  • fixed a bug in target-of-(target/party/raid) tracking
  • added support for window visibility based on current stance/shapeshift/form (ticket #14)
  • added support for window visibility based on current talent spec (ticket #14)
  • added automatic global per-spec profile switching (via LibDualSpec)
  • added support for localization; if you would like to help translate Auracle, please visit http://www.wowace.com/addons/auracle/localization/
  • some of the libraries Auracle normally embeds are now optional; if you have installed without embedded libraries (advanced users only!), you may now safely disable AceDBOptions, AceConfig, AceConfigCmd, AceConfigDialog, AceConfigRegistry, LibDataBroker, LibDualSpec and LibSharedMedia (but will of course lose the associated functionality)

Beta 0.3.5:

  • added ConfigMode support (thanks Adirelle)
  • changed to MIT license

Beta 0.3.4:

  • trackers set to activate only for the player's auras ("mine") will now also activate for the player's pet or vehicle
  • added support for 3.1 API changes to UnitAura
  • fixed a bug in saved vars update (ticket #9)

Beta 0.3.3:

  • fixed a saved vars upgrade bug (attempt to index nil "plrInstance")
  • worked around an AceDB bug that caused the first window's visibility while out of combat to always revert to on after reloading the UI

Beta 0.3.2:

  • (hopefully) fixed a bug that caused saved variables to not update correctly from addon version 0.2.3 to 0.3.x
  • fixed a bug that caused changes to window visibility by group and combat status to not take effect immediately
  • window styles may now set scale and opacity, which will be inherited by trackers
  • windows may now set visibility based on instance type (none,battleground,arena,5man,raid)
  • tweaked "Always Update" for maximum stacks to only update on a new application of the aura (not, for example, charges being consumed without re-applying)

Beta 0.3.1:

  • fixed a bug in the saved var upgrade routine that made 0.3.0 inoperable for anyone who previously used 0.2.3
  • fixed a bug with window visibility by unit properties when changing a window's watched unit
  • windows and trackers now always become visible and tinted blue while unlocked

Beta 0.3.0:

  • fixed a bug that caused tracker spirals to flicker whenever any (even unrelated) aura changed on the unit
  • fixed a bug in window visibility by combat status
  • fixed a bug that sometimes caused autoupdating maximum stacks and durations to not show their current value in the configuration window
  • fixed a bug with window visibility by unit properties when changing a window's watched unit
  • added LibSharedMedia support for window borders and backgrounds, and tracker fonts
  • re-added tracker tooltips; if all tooltips are disabled (the default), then the tracker will remain transparent to mouse clicks
  • maximum stacks and duration values are now configurable separately for spirals and text
  • it is now possible to autoupdate maximum stacks and duration only upwards
  • moved tracker aura type, list and filter settings to the "Tracker" tab, and removed the "Aura" tab
  • removed the "white.tga" file from the distribution; tracker borders now use the (identical, built-in) "Interface\Buttons\WHITE8X8" texture instead
  • default window style background tiling is now off by default

Beta 0.2.3:

  • fixed a bug caused by setting both text sizes to 0 and reloading the UI
  • fixed a bug in the behavior of "Reset Profile", it should now leave the initial window and Default styles intact
  • added a LibDataBroker launcher to toggle the addon or open configuration

History

During its alpha development phase, Auracle was called AuraHUD. It was renamed to avoid confusion, since "HUD" has particular connotations for WoW addons which Auracle does not really reflect, and there was already another (completely unrelated) project called BuffHUD.

The concept for Auracle is based on Smarty by Luxx of Death and Taxes, but has been essentially rewritten from scratch.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of CosmicCleric CosmicCleric Aug 27, 2009 at 07:04 UTC - 0 likes

    Taleden,

    Thanks for replying.

    For #1, I hate to admit to this noobness, but I have a hard time to get my disable per character to work from the Addons screen. If I disable Auracle for one, it would be disabled for another. Right now I just use it on my lock, so I was just trying to use the Auracle config. Appreciate getting that to work.

    For #2, can you take a look at how TellMeWhen does it? Its what I use right now for weapon enchants, but I wanted to switch completely to Auracle. You hopefully could just lift the code from TellMeWhen that does the weapon buff checks and integrate it into Auracle.

    Thanks for your efforts, it is appreciated.

  • Avatar of taleden taleden Aug 26, 2009 at 23:16 UTC - 0 likes

    CosmicCleric re: 1, I'll take a look at that tomorrow. It's entirely possible I never bothered to save that flag, since I probably figured anyone who wanted Auracle to stay disabled after relogging would just disable it from their addons screen for that character. But it should be easy enough to fix.

    re: 2, This was requested before (http://www.wowace.com/addons/auracle/tickets/12-how-to-test-for-temp-weapon-enchant/) but is harder to implement than it might seem. Weapon buffs aren't accessible to addons the same way that unit auras are, so it would require a whole new mechanism for tracking them. It should be possible of course, but it's low-ish on the list, since there are far fewer possible weapon buffs so it's less annoying to just scan the whole list of them yourself rather than having Auracle categorize them for you. But of course if you want this you can vote on that ticket. :)

  • Avatar of CosmicCleric CosmicCleric Aug 25, 2009 at 23:25 UTC - 0 likes

    Hello Taleden! A couple of questions please, concerning the new 1.0 version...

    1) The enable/disable Auracle checkbox is not saving its state. If I disable it for a character that is currently not using Auracle, when I logout and log back in, the checkbox is checked and Auracle is enabled again. Bug, or am I supposed to do something else to save the checkbox state besides checking it and logging out?

    2) On my Warlock, I want to set up a window for weapon buffs, specifically [Grand Spellstone]. Can Auracle do this? I've been trying by setting up a buff window that shows when its missing, but Auracle doesn't seem to see the global buffs that show up at the upper right-hand corner of the game client window. The buff shows the weapon name, and I tried typing that in, as well as the buff name, but neither seem to do the trick. If Auracle can do this, could I get some kind of quick instructions on how to set it up?

    Thank you in advance for your time and efforts, it is appreciated!

  • Avatar of braudrist braudrist Aug 03, 2009 at 07:06 UTC - 0 likes

    Can I track the singed debuffs on Hodir with this addon?

  • Avatar of taleden taleden Jul 24, 2009 at 02:23 UTC - 0 likes

    goliath0: if you'd like to see your arena id change incorporated into the main release, feel free to send me your copy of the code (or a diff/patch).

  • Avatar of goliath0 goliath0 Apr 18, 2009 at 14:00 UTC - 0 likes

    hehe Taleden, I added arena id's to your code and it just works :p

  • Avatar of goliath0 goliath0 Apr 06, 2009 at 12:50 UTC - 0 likes

    The idea is for me to drop Gladius when 3.1 hits, since WoW will have enemy party frames built in. Gladius displays arena auras already...

    The built in arena mod checks for: self:RegisterEvent("UNIT_PET"); self:RegisterEvent("ARENA_OPPONENT_UPDATE"); self:RegisterEvent("UNIT_NAME_UPDATE");

    So it will be extremely simple. Adding auracle auras for that would make it usable :p

  • Avatar of goliath0 goliath0 Apr 04, 2009 at 02:49 UTC - 0 likes

    the "caster" variable for UnitAura will include arena id tokens. Dunno about the game event.

    I would love to see Party id tokens included too!.

    Thanks for the addon.

    Edit: From what I've seen, both the event and function call support party and arena id tokens. If you could add them as valid units, that would simply rock.

  • Avatar of taleden taleden Mar 28, 2009 at 15:02 UTC - 0 likes

    goliath0: beta 0.3.4 supports the change to UnitAura in 3.1 (and also supports 3.0.9), so it should be ready to go on patch day.

    As for tracking arena units, what's really needed is for the UNIT_AURA game event to fire for those units. I'll look into this.

  • Avatar of goliath0 goliath0 Mar 24, 2009 at 09:58 UTC - 0 likes

    Just so you know:

    they're changing UnitAura calls in 3.1 to return "caster" (unitID, the real owner of an effect, like you're the owner of your Malygos Drake fire breath debuff) instead of "isMine".

    Also, UnitAura can return arena players tokens, can you add them as a valid unit to track its buffs/debuffs?

Facts

Date created
Jan 14, 2009
Categories
Last update
Aug 04, 2014
Development stage
Release
Language
  • enUS
License
MIT License
Curse link
Auracle (De)Buff Monitor
Downloads
79,140
Recent files
  • A: r149 for 6.0.1 Aug 04, 2014
  • A: r148 for 6.0.1 Jul 30, 2014
  • A: r147 for 6.0.1 Jul 30, 2014
  • A: r146 for 6.0.1 Jul 30, 2014
  • A: r145 for 6.0.1 Jul 30, 2014

Authors