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.
- 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.
- 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 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)
1.3.1
Added ability to change text color
Fixed taint issue
Fixed disappearing/reappearing buttons
Fixed various lua errors
Updated Ace libraries
1.2.5.1 Fixed issue where aura timers were always looking to primary spec to see if a button was enabled.
1.2.5
Fixed issue with disappearing options panel when using a secondary spec.
1.2.4
Added dot tick prediction
Many bug fixes
1.2.3
Added SharedMedia support for font/texture configuration
Added pet as a target
Added ability to decouple spell target from aura monitoring target
Tint action button when warning color is triggered
Added support to monitor both a cooldown and an aura on the same button.
1.2.2.1 - experiemental
Also tint the action button when the bar changes to the warning color.
Configuration for fonts/bar textures. Media add-ins like Shared Media are not working.
1.2.2
New feature automatically switches settings with spec change.
1.2.1
3.1 bug fixes
1.2
Added an option to put timers on buttons.
Added an option to change the timer bar colors when aura time remaining is less than cast time of the spell.
Untested changes to deal with 3.1 patch
1.1
Fixed a bug with fixed length timers
Added a feature to tweak the length of a timer
Added hide tooltips feature
Show number of counts on stacking debuff when timer is vertical
1.0
ButtonFacade support
Clarified ActionOffset setting
Bars can go down/left
Hide out of combat option
Show number of counts on stacking debuffs
.4 Beta
Added key bindings
Moved target option from buttons to bars
Fixed a bug where targetless spells required a target
Added self as a target
Added party member as a target
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)...