ActionButtonText - Version 1.02
(formerly known as O.B.I. - On Button Information - users should check the 0.9 upgrade notes for details)
by <Damage Inc> of (EU)Draenor - email damageinc [at] theedgeofthevoid.com
Adds text to your actionbuttons including
Last Damage/Heal Done or Miss (Block/Parry/Dodge)
Casts until OOM
Combo Points
Energy Deficit (Energy or Ticks)
Rune Power Deficit (Death Knights)
Buff/Debuff remaining time/stacks
Supports spells,items and macros
Tested with standard Blizzard Action Bars, Bartender3/4, Bongos2/3, Trinity 1.0/2.0(*), CogsBar, Dominos, idActionBar and nMainBar
Should work with any bar addon which is based on the Blizzard Action Bars
(*) Trinity 2.0 needs a small 'hack' to make it work - see "Changes in Version 0.5" for details (at the end of this document)
How to add ActionButtonText to your actionbuttons
Type /abt (or access ActionButtonText from Menu>>Interface>>Addons)
Presets specific to you race/class are shown here - simply tick the ones you'd like to use.
To change font size/color/position - or to create your own ActionButtonTexts - click through to the Configuratron
ActionButtonText Configuratron! (/abt config)
Select an existing Spell or "New ActionButtonText" to create a new ActionButtonText (/abt add)
Spells which begin "PRESET" are created by the Presets you selected - you can edit these if you wish.
Add ActionButtonText to which buttons
Spell/Item/Macro: (the only thing you MUST enter)
A full (or partial e.g. "Seal of") spell, item (or macro) name.
Note: Any text preceding a # is NOT included when matching spells/items/macros - it's just to comment/describe the ActionButtonText e.g. MYABT#SEAL OF
Search Tooltip?:
Whether Spell/Item/Macro should be matched against the spell/item/macro tooltip rather than just the name
What ActionButtonText to show about Spell(s)
Show Damage/Heal/Miss/Block/Parry
Checking this will show the amount of damage or healing done or a miss (block, parry etc.)
Show Casts until OOM?
Show how many times you can cast a spell with your current mana
No=never, Yes=always, 1-9 =show when this or fewer casts remain
Show CPs?
Show Combo Points on your current target.
No=never, 0=always, 1=show 1 or more CPs
Show Energy Deficit
Shows how much energy you need before you can use an ability.
No=never, As Energy=shows energy required, As Ticks=shows energy ticks required
Show RP Deficit
Shows how much Rune Power you need before you can use an ability.
No=never, In-Combat=shows deficit only when in-combat, Always=shows deficit everywhere
What ActionButtonText to show about Buff/Debuff(s)
Buff:
A full (or partial e.g. "Poison") buff/debuff you wish to track
If blank, defaults to the spell matched (e.g. "Seal of Righteousness")
Debuff?
Whether the Buff is actually a Debuff (e.g. "Recently Bandaged" or "Shadow Word: Pain")
Anyones?
Whether to show a Buff/Debuff from any source (by default only your own Buffs/Debuffs will appear)
Player/Target/Pet
Whether the Buff/Debuff appears on the PLAYER, TARGET or PET
Hide Time?
Check if you DON'T want to see time remaining on the Buff/Debuff
Show Stacks?
Check if you want to see number of stacks of the Buff/Debuff
How ActionButtonText should look
You can set the Position, Font Size, Style and Color for the ActionButtonText text here
The example button shows how it will look.
Save Changes/Cancel Changes/Delete this ActionButtonText
Are self-explanatory...
How to add macros
Macros are identified by reading their tooltip.
You can either 'force' a spellname to show using #showtooltip or you can add the macroname as a 'Spell'
Example 1 - forcing spellnames inside the macro
#showtooltip judgement
[macro code]
This will behave as if you were using the Judgement spell
Example 2 - referencing the macroname
In /abt, select "New ActionButtonText" and enter the macroname in 'Spell'
Spell: TESTMACRO
Buff: SEAL OF
This will show the remaining time on any "Seal of" spell on macro "TESTMACRO"
Macros which use modifiers to change the spell being cast also work
#showtooltip
/cast [modifier:alt] seal of command; seal of righteousness
This will show remaining time on SoR normally and SoC if [ALT] is held down
FAQ
Q - Is this an ACE/ACE2/ACE3 Mod?
A - No - partly because I'm not familiar with ACE and partly because it wouldn't greatly benefit from ACE's framework/libraries.
It's very low-cpu and low-memory - it typically uses < 60kb memory and less than .1% CPU
Q - ActionButtonText seems to use quite a lot of CPU time
A - ActionButtonText has to check the status of buffs/spells and update upto 120 actionbuttons AT LEAST once a second.
It works constantly - even out of combat - hence it will clock-up CPU time constantly.
I've never seen it exceed 1% usage at any one time and it's overall usage is always less than my actionbars/inventory addon tho.
and my PC is old and creaky!!
Known Issues
Q - The 'example' button on the config. screen is black/invisible.
A - It's icon/texture is taken from from the spell you enter OR from ActionButton1
If neither exist/are valid - nothing will appear here...
Credits
Credit to Gagorian for his addon DrDamage
His code for finding and adding text to actionbuttons (Blizzard AND addon-based) was ENORMOUSLY helpful
Credit to Mikk for MSBT - the MSBTOptions frame creation code is used as-is for the Configuratron
My thanks go to these authors for granting permission to use their code...