Display auras, and more, on action buttons.
AdiButtonAuras is a rewrite of Inline Aura, but with different design decisions based on my experience on the latter.
AdiButtonAuras uses a set of rules that apply to one or more spells. Each rule can track an aura on one or more unit and changes the display of the spell accordingly.
AdiButtonAuras has several custom rules to suggest using spells at meaningful times. By default, these suggestions are displayed using a rotary, shinning star on the buttons. These can be disabled.
AdiButtonAuras smartly track raid/group buffs: it shows the number of missing buffs and the duration of the shortest one, taking into account equivalent buffs.
Before heading straigth into a raid and/or playing with the options, you may want to read this short Getting started guide, which will introduce you with the basics of AdiButtonAuras.
- do not show flashing border for actions on cooldown (do not affect Blizzard flash),
- do not show flashing border for actions out of combat (do not affect Blizzard flash),
- select how suggestions are displayed (hidden, rotary star or flashing border),
- disable the spell,
- "promote to flash": replace any highlight with the flashing border animation,
- inverted highlight: highlight the spell when it is missing,
- select which rules should apply.
- customizable texts: font, format, size and colors.
- change the colors of "good" and "bad" highlights,
- select the highlight amongst 10 textures,
AdiButtonAuras allows you to enter and save your own rules, using a LUA-based language. Take a look at the rule reference to see what is available.
- sharing of custom rules, in-game using hyperlinks and out-of-game using copy-pastable strings,
- a better documentation about custom rules, with more examples.
Supported classes and specializations
Most of the simple buffs are supported through the libraries:
- most class, tradeskill and racial spells using LibPlayerSpells-1.0,
- crowd-control spells using DRData-1.0,
- dispel spells using LibSpellbook-1.0,
- trinket, enchantment and item buffs using LibDispellable-1.0.
Special cases and hints are handled using customized rules, see below.
There is also a default rule for items not supported by LibItemBuffs-1.0.
When I try to configure a spell, the button is dimmed and I cannot chose it. Why ?
AdiButtons has no rule about this spell. Consider filling an issue.
What do some rules ending with some obscure characters between brackets, like [LPS-DRUID-5.4.1-7] ?
These are references to the libraries AdiButtonAuras used to create the rule.
- LPS-XXX-A.B.C-N: data from LibPlayerSpells-1.0 for class XXX, patch A.B.C, Nth revision. E.g. "[LPS-DRUID-5.4.1-7]" stands for "rule created accordingly to LibPlayerSpells-1.0 data for druid, patch 5.4.1, 7th revision."
- DR-N: DRData-1.0, Nth revision.
- LSB-N: LibSpellbook-1.0, Nth revision.
- LD-N: LibDispellable-1.0, Nth revision.
Are you going to support ElvUI ?
AdiButtonAuras should work with ElvUI. I am not going to support its skin though.
Are you going to add a configuration panel to create custom rules ?
Not in the way InlineAura did it. However you can create custom rules in game using the Lua API.
Contributions & feedback
The project is open-source and hosted on github.com. You can report issues there. Pull request are also welcome. Adirelle often hands around on the freenode IRC network, in the #wowace channel.*
Before reporting issues
- Please check if any error happened; please copy-paste it as it in the issue.
- Open the configuration panel, check "Debugging tooltip" and check the spell identifier in the spellbook, in your action bar and in the (de)buff. Report these numbers in the issue.
- Regarding flashing, disable AdiButtonAuras and check if the unwanted behavior is caused by AdiButtonAuras or is the default behavior.
Thanks to the following people for testing and contributing to AdiButtonAuras and related libraries.
Contributors (in alphabetical order):
AdiButtonAuras is licensed under the GNU General Public License version 3.
- Date created
- Nov 03, 2013
- Last update
- Mar 04, 2015
- Development stage
- GNU General Public License version 3 (GPLv3)
- Curse link
- Recent files