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.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.
Links
------------------------------------------------------------------------
r87 | taleden | 2009-12-08 17:40:17 +0000 (Tue, 08 Dec 2009) | 1 line
Changed paths:
A /tags/1.1.2 (from /trunk:86)
Tagging as 1.1.2
------------------------------------------------------------------------
r86 | taleden | 2009-12-08 17:39:03 +0000 (Tue, 08 Dec 2009) | 1 line
Changed paths:
M /trunk/Auracle.toc
- TOC 30300 for WoW 3.3
------------------------------------------------------------------------
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...
