TotemTracker

DESCRIPTION

* This mod helps you track your totems in two ways:

1) TotemTracker adds timers to the default Blizzard buff buttons for buffs you receive from your totems. Even better, if you are in a party with another player with TotemTracker, that player will see buff timers for the totems you drop, and vice-versa! This functionality works for non-shaman classes as well.

2) TotemTracker adds a totem tracking Panel that conveniently shows you information about the totems you have dropped. The panel consists of four colored timer bars partially filled to represent the time remaining on each totem element, and optional icons below the bars representing which totem you have placed. Optional text on the timer bars shows the time remaining on that totem element in secs/mins. Finally, the panel itself can be shown/hidden, and will be initially shown for Shaman class players, and initially hidden for other class players.

KNOWN LIMITATIONS

* Addons cannot determine whose totem is giving you a buff. In the case that two players in your party laid the same totem at different times, the buff timers will display the timer for whichever known totem has the shortest time remaining. This may or may not be the totem you are actually getting the buff from, depending on whether or not everyone in the party has TotemTracker, and whether or not the totem you are getting the buff from is the one with the shortest time remaining. Note that with this setup, it is safe to assume the buff you are getting from a totem will last for the remaining time OR LONGER, but never shorter (assuming you stay in range of the totem).
* The panel bar assumes Fire Nova Totem lasts 4 seconds, even if talents modify this. This may be fixed in the future but is considered a low-priority issue.
* While Totems being destroyed in combat is now detected, totems 'disappearing' from moving too far away from them is not. Keep this in mind if you leave your totems standing when you mount up and run far away.
* Earth/Fire Elemental totems actually have more than 5hp, so if someone/something hits the totem, the addon will think the totem was destroyed when in reality it wasn't.

PLANNED UPDATES

1) Properly handle players/mobs hitting the elemental summon totems

2) Options interface/menu for the panel (for text display on/off, etc.)

3) Ability to change the time at which the totem panel bars start flashing, and allow either percentage or absolute seconds) values.

4) Ability to change totem bar colors

5) Tooltip for totem info on mouseover of totem icons

6) Resizeable panel

7) Optional vertical bar orientation

CHANGELOG

2.52
- Source code revisions to fix memory leaks

2.51
- There was a change in Blizzard's code that was causing buff timers to not be able to be displayed. TotemTracker has been updated to fit the new scheme
- A change in slash-command usage has been implemented to make it more intuitive to use: '/ttr' now brings up the help menu and '/ttr panel' will now toggle the panel visibility

2.50
- Mana Spring and Healing Stream totems have had their durations updated
- Bar color and bar ordering can now be more easily modified from within 'TotemTracker.lua'; those comfortable with doing so may open this file using any text editor and modify the tables 'barColor' and 'barOrder'
- 'TotemTracker_new.lua' from the beta version has been renamed 'TotemTracker.lua', and the old code has been discarded.

2.40b
- The totem panel can now be locked and unlocked using the '/ttr lock' command
- Totem buff timers can now be shown/hidden using the '/ttr buffmode' command. Note that with some 3rd-party buff mods you may have to use the '/console reloadui' command to finalize the buff mode change
- TotemTracker now attempts to 'fool' buff mods into thinking totem buffs have a duration by hooking a global API call. This approach may not successfully fool all mods. See the Advanced Usage section of 'readme.txt' for details.
- Code now utilizes local functions/variables when possible to reduce the execution overhead associated with accessing global functions/variables.

2.33
- [Bugfix] Error message no longer displays when totems are hit by mobs.

2.32
- [Bugfix] Addon message now properly sent to party members when clearing totems with the 'Totemic Call' spell
- [Bugfix] Debug information no longer displays
- Totems being destroyed while in combat, are now detected. Functionality only tested vs. creatures (player hits might not register)

2.31
- [Bugfix] Wrath of Air Totem buff now properly displays a timer

2.30
- [Bugfix] Flametongue Totem (Rank 4) will now properly be tracked
- Timers will now be cleared when beginning a flight path
- Party buff sharing now actually works (99% confident)
- When using party buff timer sharing, events that clear totem timers for the player will now be sent to party members so their timers clear as well
- Burning Crusade expansion totems now should properly be tracked
- Totem time remaining text can now optionally be displayed on the tracking bars. There are three modes (no display, mouseover display [default], always display), type '/ttr text' to cycle between these three modes.
- Totem icons can now be optionally displayed underneath the tracking bars. Type '/ttr icons' to toggle the display on/off.
- Settings for the panel display, bar text display, and icon display are now saved between sessions
- LUA and XML code rewritten to be shorter and more compatible with other addons
- Buff timers now use the actual Blizzard buff timer objects, instead of seperate timers

2.23
- Air totem bar is now a slightly lighter shade of blue for better visibility
- 'Totemic Call' now clears totem timers and the totem bars
- Dying and entering an instance portal now clear totem timers and bars
- Party members' totems will now be included in buff timer checks only if they are visible to you

2.22
- 2.0.3 compliant
- Attempted to fix party sharing
- Added support for the Enamored Water Spirit trinkey totem
- Added support for Totem of Wrath (untested)

2.21
- Cross-party addon communication implemented. Totem timer buffs will now show the shortest duration timer for each buff from all party members
- The totem panel now flashes a bar if the totem duration drops below 10%

2.11
- Updated documentation for slash commands
- Confirmation message now displayed on resetting the panel

2.10
- A small movable panel was added with colored bars to graphically show the time remaining on your earth, fire, water and air totems. This includes all totems, not just buffing totems, and will still display when away from the totem
- Slash commands were added to show/hide the panel, as well as reset it to the center of the screen
- The panel display is shown by default for Shaman classes; hidden for others. Other classes can still show the panel, but there really isn't a reason to do so
- Party sharing is still experimental; it is not yet implemented

2.00
- Updated for the API 2.00 changes
- Version history and installation instructions prepared for web upload