WoW TellMeWhen_Script_Tools addon Dragonflight/Wrath of the Lich King Classic 2023
wow addon TellMeWhen_Script_Tools


Game Version: 9.2.7
Total Downloads: 46,969
Updated: Aug 17, 2022
Created: May 10, 2018
download TellMeWhen_Script_ToolsDownload Earlier Versions

Earlier Versions

Name Size Uploaded Game Version Downloads
1.2.10 release 16.42 KB Aug 17, 2022 9.2.7 3 download TellMeWhen_Script_Tools 1.2.10 releaseDownload
1.2.9 release 17.49 KB Jun 1, 2022 9.2.5 2,912 download TellMeWhen_Script_Tools 1.2.9 releaseDownload
1.2.7 release 17.49 KB Mar 10, 2021 9.0.5 9,417 download TellMeWhen_Script_Tools 1.2.7 releaseDownload
1.2.6 release 17.49 KB Dec 5, 2020 9.0.2 7,777 download TellMeWhen_Script_Tools 1.2.6 releaseDownload
1.2.5 release 17.50 KB Nov 22, 2020 9.0.2 2,849 download TellMeWhen_Script_Tools 1.2.5 releaseDownload
1.2.4 release 17.49 KB Sep 13, 2020 9.0.1 3,338 download TellMeWhen_Script_Tools 1.2.4 releaseDownload
v1.2.3 release 17.50 KB Dec 16, 2018 8.1.0 9,958 download TellMeWhen_Script_Tools v1.2.3 releaseDownload
v1.2.2 release 17.50 KB Dec 11, 2018 8.0.1 789 download TellMeWhen_Script_Tools v1.2.2 releaseDownload
v1.2.1 release 15.63 KB Nov 15, 2018 8.0.1 736 download TellMeWhen_Script_Tools v1.2.1 releaseDownload
1.1.0 release 142.61 KB Sep 25, 2018 8.0.1 1,949 download TellMeWhen_Script_Tools 1.1.0 releaseDownload
v1.0.22 release 137.41 KB Aug 2, 2018 8.0.1 3,576 download TellMeWhen_Script_Tools v1.0.22 releaseDownload
v1.0.21 release 124.92 KB Aug 2, 2018 8.0.1 64 download TellMeWhen_Script_Tools v1.0.21 releaseDownload
v1.0.20 release 124.85 KB Jul 23, 2018 8.0.1 1,010 download TellMeWhen_Script_Tools v1.0.20 releaseDownload
1.0.10 release 105.88 KB Jul 18, 2018 8.0.1 +1 802 download TellMeWhen_Script_Tools 1.0.10 releaseDownload
v1.0.9 release 104.05 KB Jun 3, 2018 7.3.5 985 download TellMeWhen_Script_Tools v1.0.9 releaseDownload
v1.0.8 release 100.82 KB Jun 1, 2018 7.3.5 117 download TellMeWhen_Script_Tools v1.0.8 releaseDownload
v1.0.6 release 80.73 KB May 14, 2018 7.3.5 293 download TellMeWhen_Script_Tools v1.0.6 releaseDownload
v1.0.3 release 62.53 KB May 11, 2018 7.3.5 116 download TellMeWhen_Script_Tools v1.0.3 releaseDownload
v1.0.1 release 35.15 KB May 10, 2018 7.3.5 +2 109 download TellMeWhen_Script_Tools v1.0.1 releaseDownload
v1.0.0 release 30.63 KB May 10, 2018 7.3.5 95 download TellMeWhen_Script_Tools v1.0.0 releaseDownload
v1.0.7 alpha 90.07 KB May 24, 2018 7.3.5 74 download TellMeWhen_Script_Tools v1.0.7 alphaDownload


Share this:

his addon provides a list of utilities to help write icons driven by LUA scripts (Mostly through the Notifications>LUA interface, though the global methods will work just as well through the LUA Snippets interface)




Provided are some usage examples. Some examples contain explanations, so make sure to only copy the export code. 


  • Dynamic Absorb Bar
  • VDH Soul Fragments Tracker
  • Normalized Stagger bar (uses NormalizedStagger addon)
  • AHR Trinket tracker (tracks how much or the absorb is left, and how much damage was accumulated) 
  • Black Ox Statue Tracker
  • Last Defender buff tracker
  • Infested Tracker – a port of a very useful WA. This will only trigger when running keystones of level 10 or higher, and will add a floating icon on top of infested mobs
  • CC Trackers – this group will track all forms of CC (when they cast and when they will cancel). Uses the new Timers API



Enemy Count Utilities

This module provides 3 main tools to count nearby enemies (for eg – to have a rotation based on number of nearby targets). All tools max out at 5 nearby enemies. 

Script Tools > Enemy Count condition

A new condition type was added to allow you to set conditions based on enemy count


LUA Methods
TMW_ST:EnableUnitCounter / TMW:DisableUnitCounter

This will enable/disable a new counter – “tmwst_hostiles_in_range”.


This function will return the number of nearby enemies. Will stop counting once/if stop has been achieved. 


Azerite Trait Condition


You can now check how many traits are active for a given spell id.

Counter Management

The library provides tools to get set counters for TellMeWhen:



This method will return the value of an existing counter



This method will initialize a counter for future use. Please note that you must call this on the Icon Setup notification event for any counter that is defined in your LUA scripts. Failing to do that will prevent TMW icons from accessing your counter


TMW_ST:UpdateCounter(name, value)

This method will update a counter value. Note that value must be a number.


Dynamic Text Setup

This toolset will allow you to set dynamic text that can be accessed in your icon labels (so that you can change icon text through LUA)


TMW_ST:SetScriptText(name, text)

This method will set a variable that you can access in icon labels using the following DogTag. 



This DogTag will be accessible through your icon labels

Dynamic Bar

This tool is a new icon type- “Dynamic Bar” that allows you to manually set various properties of a bar icon. All the icon methods are only accessible through the Notifications > LUA interface.


There are 2 ways to control the bar growth – one is by setting a duration (startDurationTracking) or by manually setting max and current values.


This function can be used on Icon Setup event to register a function that will be called every time the icon goes through an update check. This function must return true for the icon to go through an update cycle. 


Set the max value for the bar


Set the current value of the bar.

icon:setBarColors(startColor, midColor, lastColor)

This allows you to manually set the color of your bar. A color is an 8-digit hex value representing an rgba color value (eg – “#aa12eeff”). Easiest way to access these colors is using TellMeWhen’s color picker. You can pass nil if you want to only pass one or two of the parameters.



Starts a duration countdown with {duration} length. If you use this without setting max/current values, it will control the bar display. Otherwise, it will create a value you can track using the various duration DogTags.


icon:setStacks(stacks[, stackText])

Will set the stacks attribute of the icon, so you can access in via DogTags. If you pass {stackText} it will control the value being displayed by the DogTag. 



You can now manipulate TMW timers using LUA:









Add a comment