Get an Epic Experience with Premium


Buffs & Debuffs Login to Add Favorites
  • World of Warcraft
  • 4,454 Monthly Downloads
  • Supports: 6.2.2
  • 483,823 Total Downloads
  • Updated 11/03/2015
  • Created 02/16/2009
  • 599 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: GNU General Public License version 3 (GPLv3)
  • Newest File: 2.5.20

About ButtonTimers

ButtonTimers is action buttons with timers attached. The timers can be configured to show a buff/debuff or the cooldown of a spell. The timers are highly configurable, with lots of options to play with.

Important note:

There are a limited number of action slots (1-120). These correspond to 10 bars of 12 buttons each. These are the same 120 slots that every action bar mod has to use (Bartender, PitBull, Blizzard's standard UI, etc.)

Chances are you aren't using all 12 slots on all 10 bars. You can configure ButtonTimers to use any of the 120 action slots you want. Do this with the "First button on bar is.." slider in the bar configuration.

If you don't change the "First button on bar is..", the bars will default to bars 10, 9, 8, 7. Note that bars 7-9 are by default the stance bars, so if your class uses stances you may wish to change it.

Getting Started:

When you first start the mod, you will see 4 bars of 12 buttons each. Open up the options (in the interface->addons panel), and disable the bars you won't be using. Next change the number of buttons from 12 to however many buttons you would like to see.

Now change the action slots the bar is showing you. Just take the action offset slider and slide it until you see some unused action buttons. Then drag the spells/abilities of your choice onto the bar.

The default is to track dots/debuffs/buffs. If that's what you want the timer to reflect, you are done. If you want to see a cooldown instead, select the configuration for the button and change the selector from "Aura" to "Cooldown".

There are lots of configuration options, go ahead and play with them. But that should be enough to get you started.

Bar configuration options are:

  • '''Bar Enabled:''' enable / disable the bar.
  • '''Hide out of combat:''' don't show the bar out of combat.
  • '''Bar Locked:''' lock the bar in position so that it cannot be dragged.
  • '''Orientation:''' horizontal or vertical layout for the buttons on the bar. You can also put the timers on the buttons themselves.
  • '''Timer Location:''' you can select whether you want the bar be on the left or right of the button (in vertical orientation) or above/below the button (in horizontal orientation)
  • '''Button Spacing:''' the space between the buttons on the bar.
  • '''Bar Scale:''' size the whole bar larger or smaller
  • '''Bar Length:''' length of the timer bar
  • '''Button Count:''' number of buttons on the bar (1-12)
  • '''First button on bar is..''' action slot number of the first button on the bar. Blizzard gives 120 action slots, which are traditionally allocated into 10 bars, but this mod gives a finer control over which slots you wish to use. Just slide this control until you find some unused slots.

Button options are:

  • '''Type:''' Set whether you wish to monitor a cooldown or an aura on the default bar target. You can also monitor both aura and cooldown. The cooldown will show up on the button and the aura timer on the bar if you select both.
  • '''Timer Type:''' The timer can either be shown as a percentage of the aura/cooldown duration or in fixed time. For example, if you choose a fixed time with a time of 10s, a full bar will always represent 10 or more seconds. This makes it easier to see which aura/cooldown will complete first, regardless of the spell's length.
    • '''Bar Time:''' This sets the max time displayed on a fixed time timer bar. Any timer durations longer than Bar Time will show as a full bar.
  • '''Show others' spells:''' By default, the timer will only monitor auras on the target if you were the caster of the spell. Click this button if you wish to see other's spells as well. The timer will always show your own spell if you have one on the target. Note: Pet spells do not count as being cast by you, so if you wish to monitor a pet spell then click this button.
  • '''Other Auras:''' By default, an aura timer will monitor the bar's default target for an aura matching the name of the spell on the action button. In this field you can enter additional auras (in a comma separated list) to look for.
    • "Show Aura Icon:" When checked, the icon on the button will update to match the aura we are showing the timer for.
    • "Ignore Button Aura:" When checked, timers will only be created for the auras specified in the Other Auras field. If Show Aura Icon is also checked, then the icon on the button when no timer is present will be the first aura listed in the Other Auras field.
  • '''Cooldown spell:''' By default, a cooldown timer will monitor the cooldown on the action on the bar. But you can also enter a spell name to monitor instead.
  • '''Bar Color:''' The color of the timer bar.
  • '''Target:''' This will select the default target (to target, focus target, self, party, pet) for all actions on the bar. It also controls what target to monitor for auras.
  • '''Use as spell target:''' If set, target will be the spell target as well as the target to monitor for the selected aura.
  • '''Warn less than cast time:''' Change the bar color when timer less than cast time. Also tints the action button.
  • '''Warning Bar Color:''' Bar color for timers when remaining time less than cast time.
    • "Adjust Cast Time:" Additional number of seconds to add, or subtract, from the cast time. Set this value to the effect's duration * 0.3 for the warn color to show when its safe to refresh an effect without wastage.
  • '''Adjust Timer:''' Number of seconds to add to timer (can be negative).

Command line options:

'''/buttontimers reset''' - reset bar positions to default

'''/buttontimers config''' - open the configuration dialog (can also be accessed on Blizzards interface -> addons panel)

r71 | stencil | 2015-11-03 10:27:49 +0000 (Tue, 03 Nov 2015) | 1 line
Changed paths:
   A /tags/2.5.20 (from /trunk:70)

Tagging as release 2.5.20
r70 | stencil | 2015-11-03 10:25:54 +0000 (Tue, 03 Nov 2015) | 1 line
Changed paths:
   M /trunk/ButtonTimers.toc
   M /trunk/Core.lua

bug fix - Auras cast by those not in your group could show up in timers set to only show those cast by you. This is a regression from an older bug fix done to help user track things like weapon enchant procs which had no unitId for caster. New code will only consider a nil to be player as caster when the target checked is also player.


First Previous Page 1 of 63 Next Last
  • #968

    Love the addon but recently its started to track other players debuffs on the target.  I haven't clicked the "track others" box.  I've noticed it on my feral druid and destro lock.  It works great for soloing.  But with others putting same debuff on, it will show remaining time for mine or theirs... kind of random which.

  • #973

    new version (2.5.20) show fix the problem

  • #972

    UPDATE - From what I can tell, it looks like this happens with dots from people that AREN'T in a party with you. So, you shouldn't see this bug when raiding or doing instances but will on a world mob like Doomroller.  Will continue to investigate to try to find fix.

  • #967

    Hi there. If i set ex. Bar 3 to track all the DoTs on my focus target. is it possible for the list of icons to appear, only when I actually do have a focus target?

    It's kinda annoying when i see a vertical row of icons doing nothing during combat.

    Otherwise really appreciate the subtleties in the design of this add-on, the text colouring blending in with bar colour etc, which is not seen in other add-ons. Thanks!


  • #962

    If you are getting the error message: ..\AddOns\ButtonTimers\Core.lua line 1284: attempt to compare number with nil

    it can be easily fixed by modifying line 1284 in Core.lua from this:

    if maxCharges > 1 and maxCharges > charges then

    to this:

    if maxCharges ~= nil and maxCharges > 1 and maxCharges > charges then

  • #964

    thanks for the heads up

  • #963

    Not sure if you will also need to do the same for line 1293 since it has the same structure. It works for me without it but changed it just to be safe...

    Last edited by Elzilcho78 on 6/25/2015 5:13:01 AM
  • #960

    Having an issue as of the new patch. I have 2 bars active but when I load the game only one appears despite both being enabled in the options. If I disable and then re-enable the previously missing bar, it does appear and work normally. However, there's also some sort of lag going on. I've removed each addon in turn to narrow it down and the lag disappears completely whenever ButtonTimers is disabled. I realise it might not be BT that's directly to blame, possibly a conflict or outdated lib file or something, but coupled with the missing bar I thought there might be a bigger problem. The only difference between the two bars I use is that the 'missing on load' bar has the Timer Location set to 'Left/Bottom' rather than 'Right/Top'. Any help would be appreciated.

  • #961

    I should add, by lag I mean a noticeable delay - perhaps half a second - whenever the GCD activates - possibly to do with the GCD animation or something?

  • #959
    Boss 1-5 target

    Hi, always a button timers fan !

    Any chance to have more option on target dropdown menu please ?

    Boss 1, Boss 2, Boss 3 .... for multiple boss fight ( like in tellmewhen ), or custom string ?

    Maybe an advice to .lua file edit to achieve this ?


    Last edited by piloui on 5/27/2015 5:36:49 PM
  • #965
    Quote from piloui »

    Hi, always a button timers fan !

    Any chance to have more option on target dropdown menu please ?

    Boss 1, Boss 2, Boss 3 .... for multiple boss fight ( like in tellmewhen ), or custom string ?

    Maybe an advice to .lua file edit to achieve this ?


    this shouldn't be too hard to add; I'll try to find some time to work on it

  • #966

    Thanks a lot. I've tried to edit myself but failed for now. 

  • #957

    i logged onto multiple toons doing single and multiple test on a range of different addons and when with addonusage by it self took up 96% cpu  when dubbled with a differnt addon it verys to 40-50 split  lower cpu usage always went to addonusage but when i used 3 addons  the one the ones i  one at random took a higher cpu usage but when ever i use it with buttontimers single dubble or multiple buttontimers always takes the most cpu usage  the addons i am using are DBM Buttontimer Mogit i know its out of date waiting for a update Recount Postal Npc Scan and Baggon  but i am going to delete addonusage  toons i tested it on 100 mage 99 hunter 93 worrior 90 lock 90 rouge 90 dk  i have asked in gen chat if any else laggin some where while others where not ....  i thank you for your insight  and hope this helps im thinking its not buttontimers ...  just rattling my brain on trying to figure out the sourse

  • #958

    So it sounds like that addon is just reporting percentage of time each addon used out of the total of all addons.  You might want to try Broker_CPU instead.  It looks like it records the time spend inside each addon which it can then compare to total time elapsed which gives a better idea of how much time the addon is using compared to the game.  I ran it during some of the trash clearing tonight and while ButtonTimers was one that used a lot of cycles, but it didn't look that much worse than something like IceHud.

  • #955

    Not use if anyone else is having some lag issues? long story short i am!  wanted to see if addons was the sourse for the lag i downloaded addonusage and found that button timers is taking up a wooping 82% of my cpu useage and in 2nd place  was recount with 13% the rest of my addons used zero % I can not live without buttontimers is the heart that keep my blood flowing .. so question is  this normal anyone else having issues ? but 82% cpu usage seem preaty far out of an addon if i say so my self

  • To post a comment, please login or register a new account.
Login to Curse

Don't have an account? Create One.

Get an epic experience with Curse Premium
  • Faster addon downloads
  • Premium-Only Beta Giveaways
  • Ad-Free Curse experience
  • Premium Curse Client
  • and many More Features
  • Learn More »

The 8-Bit Salute for the Troops Benefit Tournament Entrance Code Giveaway

Get Your Beta Key