Auracle (De)Buff Monitor

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 "taleden0@gmail.com" and any amount, and mark it as a "personal gift."

Changelog

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.

Links

WoWAce Project Homepage
Ticket Tracker
Localization/Translation
WoWAce Forum Thread (or jump to the last page)

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

12 comments
1
2
Next →

- #12
Flamouria Thu, 03 Sep 2009 09:34:45
First of all, this addon has been a great help in min-maxing my dps. I use it to check short time procs and here comes the problem: The 2 piece proc from Tier 9.25 for Deathknights has the same buff name as the proc from the runeforge. I have tried filling in spellids for these, but the spellid gets translated to the buffname by auracle and when you have these 2 buffs available at the same time (this is what I check for max disease damage and reapply diseases to keep them rolling with glyph of disease) only one of them will be shown in any of the trackers.

So my wish is : - I want to be able to create 2 trackers which will show different buffs with the same name (Unholy Strength in this case)
- #11
taleden Fri, 28 Aug 2009 01:24:49
CosmicCleric: as of 1.1.0 the enabled checkbox should now be remembered between logouts. I still recommend disabling the addon entirely if you won't be using it though, since it will still use some memory if it's been loaded, even if it's disabled in-game; to skip it per-character, just choose the character from the dropdown in the Addons window on the char select screen.
- #10
CosmicCleric Thu, 27 Aug 2009 07:04:27
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.
- #9
taleden Wed, 26 Aug 2009 23:16:37
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. :)
- #8
CosmicCleric Tue, 25 Aug 2009 23:25:53
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!
- #7
braudrist Mon, 03 Aug 2009 07:06:15
Can I track the singed debuffs on Hodir with this addon?
- #6
taleden Fri, 24 Jul 2009 02:23:41
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).
- #5
goliath0 Sat, 18 Apr 2009 14:00:23
hehe Taleden, I added arena id's to your code and it just works :p
- #4
goliath0 Mon, 06 Apr 2009 12:50:49
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
- #3
goliath0 Sat, 04 Apr 2009 02:49:07
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.