Yatba stands for "Yet Another Timer Bar Addon". It is an aura (i.e. buff/debuff) tracker.
It relies on both unit aura information and combat log events to accurately track all those buffs and debuffs you put on your friends and foes. Being GUID-based, it handles efficiently several mobs with the same name.
Notice: Yatba may have some trouble catching new auras and health changes with untargeted units, i.e. units that are neither in your group nor the target of a member of you group. Hovering such unit with the mouse is sufficient to update its data.
Features
Customizable appearance and layout
The following graphical elements are customizable:
- bar thickness, length, scale and texture,
- bar colors, by type (buff/debuff) and optionnal by debuff type.
- bar orientation: either horizontal (from left to right or from right to left) or vertical (from bottom to top, or from top to bottom),
- timer bar labels through a simple template,
- font name, size and outline.
Target highlights
Yatba provides the following feature to help identifying
- All timer bars of the same target are grouped together.
- The bars of your current target and focus are always displayed at top of their bar group.
- You can enable visual highlight of your current target and current focus. Texture and color are customizable.
- Yatba can display the raid icons into the bars.
- Yatba can optionally display unit header bars. These bars have a different color and are always displayed in top of the unit timer bars.
- Unit headers can display the unit health.
- Unit header bar color can vary depending of the unit health.
Multiple bar groups
Yatba allow you to create several group of bars. Each one can be positioned as you want on the screen.
Filtering
Timer bars are distributed amongst all the bar groups using a simple filtering system. Each group has a set of filtering rules and an numerical priority.
When a new timer bar has to be show. The aura is tested against the filter of each bar group.
- when the aura matchs only one group rules, it is shown in that group,
- when the aura matchs no group rules, it is ignored,
- when the aura matchs more than one group, it is shown in the group with the highest priority.
The basic filtering rules :
- aura type : buff or debuff,
- affected unit (notice they don't overlap, e.g. other party members does not include player and its pets) :
- player,
- player's pet,
- other party members,
- other raid members,
- other friendly units,
- hostile units,
- optionally: aura duration, either by minimum or by maximum.
Group specific settings
The following settings are specific to each group :
- scale, length, orientation, maximum number of bars, growth direction, filling mode (either deplete or fill),
- displaying of unit headers,
Samples group configuration
2 groups: short auras on myself and the others
- create a group "myself", enable only "yourself", enable duration filter, set maximum duration to 120, set priority to 50,
- default group: enable duration filter and set maximum duration to 120, set priority set to 0.
3 groups: my pet and myself, our enemies, and others
- create a group "myself", enable only "yourself" and "your pet", set priority to 50,
- create a group "enemies": enable only "hostile units", set priority to 25,
- default group: set priority to 0.
Advanced filtering
TODO...
------------------------------------------------------------------------
r18 | adirelle | 2009-04-16 00:27:54 +0000 (Thu, 16 Apr 2009) | 3 lines
Changed paths:
M /trunk/Yatba.lua
M /trunk/Yatba.toc
Drycoded fix to 3.1 UnitAura changes.
TOC update.
------------------------------------------------------------------------
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)...
