Get an Epic Experience with Premium


Buffs & Debuffs Login to Add Favorites
  • World of Warcraft
  • 3,876 Monthly Downloads
  • Supports: 6.0.3
  • 452,938 Total Downloads
  • Updated 11/09/2014
  • Created 02/16/2009
  • 591 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: GNU General Public License version 3 (GPLv3)
  • Newest File: 2.5.16

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)

r63 | stencil | 2014-11-09 20:54:58 +0000 (Sun, 09 Nov 2014) | 1 line
Changed paths:
   A /tags/2.5.16 (from /trunk:62)

Tagging as 2.5.16
r62 | stencil | 2014-11-09 20:44:07 +0000 (Sun, 09 Nov 2014) | 1 line
Changed paths:
   M /trunk/ButtonTimers.toc
   M /trunk/Core.lua

bug fix - errors when "warn < cast time" is checked but button doesn't have an action
r60 | stencil | 2014-11-06 11:10:30 +0000 (Thu, 06 Nov 2014) | 1 line
Changed paths:
   M /trunk/ButtonTimers.toc
   M /trunk/Core.lua
   M /trunk/locale/enUS.lua

Added a cast time adjustment field to the option for warning when the cast time is less than the remaining duration of an aura. Useful for identifying when its safe to refresh the effect without clipping.
r58 | stencil | 2014-10-15 09:25:27 +0000 (Wed, 15 Oct 2014) | 1 line
Changed paths:
   M /trunk/ButtonTimers.toc
   M /trunk/Core.lua

bug fix - return values for GetSpellInfo changed, affects us when we're looking at the casttime of a spell
r56 | stencil | 2014-10-15 01:58:29 +0000 (Wed, 15 Oct 2014) | 1 line
Changed paths:
   M /trunk/ButtonTimers.toc

... and version number /facepalm
r55 | stencil | 2014-10-15 01:57:37 +0000 (Wed, 15 Oct 2014) | 1 line
Changed paths:
   M /trunk/ButtonTimers.toc

bumping toc file


First Previous Page 5 of 61 Next Last
  • #867

    I love this add-on, made my life a lot easier for all my specs and characters.

    But that doesn't mean I'm 100% happy. I've had problems with some of my bars, for example in some I can never put any spells because they always say "A water totem can only go into this slot" or some fire or what-ever-kind of totem. On my main I managed to set 2 bars, which is enough, but on my lock I would really love to have 2 - and I've got to stick with 1 bar. 2 bars are obsessed with totems (which a lock doesn't have at all) and the 3rd does something even more strange - it copies my only working bar, and if I touch anything on it - It automatically removes stuff from my main bar....  What can I do about this?

    It smells like some stupid setting, I've tried all options I can think of... I've got the latests updated version I hoped that would do it, but the problem continues.

  • #868

    Okay, so the option in question that you'll want to look at to fix both of your problems is the slider below the text "First button on bar is action slot:"   The 10 action bars that blizzard gives us are in a continuous range of 120 buttons.  For a button timers bar you set how many buttons you want and which button in that range to use as the start. 

    I was able to replicate the totem issue by taking that first button slider and moving it all the way to the max which means the first button of the button timers bar was the very last button of the 120 available.  So, then what happened when I tred to put a spell onto any of the bar slots after that first button?  I got those various totem error messages you saw.  After the 10 action bars / 120 buttons blizz gives us there's another 12 button bar that is reserved and special and was used for those three spells that would drop shaman totem sets.

    So, there is a ButtonTimers bug here in that the max value of the slider should adjust based on Button Count; so the only way you could set it to the last button of bar 10 is if the button count was also  set to 1.  I think that's going to be the best way to handle that.

    It sounds like the 3rd bar is starting at the first button of the first bar, that's why its replicating the main action bar.  When you make a change in one place it makes the same change in the other because, even though they are different bars, they contain the same buttons.

    So, you should be able to fix your config issues by giving those bars new starting positions on different bars.

    Last edited by stencil on 2/24/2013 3:22:26 AM
  • #869

    Thank you so much! That really did the trick... The speed of reply was amazing! Thanks!

  • #865

    I noticed that r44 now hides the bars during pet battles, but could I ask you to change this behaviour to a user choice/configurable option, please?

    I haven't yet been able to establish what iscausing the issue, but sometimes my Blizzard UI action bars disappear (or rather the standard ones don't reappear after the pet battle bar disappears) if a pet battle gets interrupted (or I'm in combat when I 'enter a possession vehicle', bizarrely), so until now I have been totally reliant on my Button Timer bars to repel the attacking mob/player.

    Thanks in advance

    Last edited by sayling on 2/22/2013 3:47:59 AM
  • #866

    Latest alpha build adds an option to each bars config to disable the hiding of a bar during pet battles.

  • #870

    Thanks, Stencil :D

  • #864

    I love buttontimers so much I made a tutorial on youtube.;list=UUH0hOXC_KZ6Yokhf9phQXbQ&amp;index=1

    I tried to be as thorough as I could.

  • #863

    Bug Report:  Every time I cast the warlock spell soulburn my game hangs for a split second.  I believe I have tracked the issue down to this addon, as turning it off is sufficient to eliminate the problem while having it as my only addon is sufficient to generate the problem.  In talking with other locks and looking at the forums, it seems this is a reasonably common problem.

    Love the mod, was so sad when it turned out to be the offender.

  • #857

    Bug report: The buttontimers bar is moving around on me. I drag it into the right spot over and over again, but every time I change specs it moves.

    BTW Stencil, you are doing an awesome job with the mod.

  • #860

    Scale was the key; it would repro whenever the profile was changed if they had different scale factor values.  So, if scale was set to .8 in both profiles it wouldn't repro.  Fixed in build 2.5.7.

    (I deleted my original reply since it was full of irrelevancy and the system nuked your reply to that)

  • #856

    No questions here atm, just wanted to say tks for keeping a great addon uptodate.  I have used this addon for years now.  I use it on every toon.  I would be lost without it.  So tks for keeping my most important addon running all these years.

  • #861

    Thanks for the kind, though probably undeserved*, words.  They were like an extra Christmas present :)

    * haven't been able to give it any time for improvements this xpac, been too busy fighting bigger fires in other addons and playing way too much.  dailies dailies and more dailies

  • #862

     This xpac has dailies in it? Surprised

  • #849

    I've just installed WOW on a new pc and, if possible, I'd like to transfer all my BT settings across from the old pc to the new,  to save having to set them up for each character again.  Is this possible?

    I've had a bit of a look around on the old pc (eg WTF, etc)  but haven't found anything that seems to store to BT settings.

    Thank  you  :-)


  • #850

    The user settings file, ButtonTimers.lua,  is under WTF in the general SavedVariables folder, the one that is at the same level as the per-realm folders.

    Please note that what you'll get from these settings is just the configuration info for the timers.  What spell/item/macro is actually *on* each button is not something we save or maintain.  That's because the button timer action bars are the games action bars and we share them with the game and all the other addons that display action bars. Its like the Bartender addon; its profiles are going to save what bars are shown, their positionining and size, etc, but swapping Bartender profiles doesn't change what abilites are on those buttons.

    If that's part of what you were looking for you'll have to find a differnet addon that does manipulate what's on your buttons, run it on the old pc to create a profile and then move it to the new.  There's an addon called ActionBarSaver that I think is supposed to do this; I've not yet  tried it out, so buyer beware.

  • 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 »

Plantronics GameCom Commander Headset Giveaway!