WeakAuras

Trigger Types

Trigger Types

There are 4 categories of triggers: Auras, Statuses, Events, and Custom triggers. The first three will be explained here; for the fourth, see Custom Triggers.

Trigger types are considered separate entities from Display types, so any trigger can be used for any (non-group) Display type. Triggers pass information to the displays to which they are connected through 4 channels: Duration Info, Icon Info, Name Info, and Stack Info. See Dynamic Information for more info. The Progress Bar type is the only Display type which shows all 4 of these types of information; the other display types so some or none of them. Similarly, some triggers do not provide all 4 types of information, some do not provide any, and some provide different types of information depending on circumstances. The types of information provided by each trigger type will be specified in this page, along with explanations of each trigger's options and behavior.


Aura

Auras are the most commonly used triggers in WeakAuras. Auras are also known as Buffs or Debuffs.

Auras provide Duration Info, Icon Info, Name Info, and Stack Info. However, if the Inverse option is checked, an Aura trigger will not provide any of this information. Additionally, if "Group" is chosen for the Unit option, the trigger will provide Duration Info and Stack Info but not an icon or name.

Trigger Options:

  • Aura Name: The name of the buff or debuff. It is possible to specify up to 9 different aura names; the trigger will activate when any of the specified names are detected.
  • Unit: The unit which should be watched for the specified aura. "Player", "Target", "Focus", and "Pet" are all normal units, but "Group" is a special case.
  • Group Member Count: Only available if "Group" is chosen for the Unit option. Such Aura triggers will screen all of the people in your party or raid, count how many people are affected by any of the specified aura names, and then that number will be tested by the comparison you specify in these two fields. For example, if Operator is set to "<" and Count is set to 5, then the trigger will only be active if less than 5 people in your party of raid are affected by any of the specified aura names.
  • Hide When Not In Group: Only available if "Group" is chosen for the Unit option. Prevents the trigger from being active when you are not in a party or raid.
  • Aura Type: Whether the aura is a buff or a debuff. Unfortunately, WoW makes you specify, and will not search for buffs and debuffs at the same time.
  • Stack Count: A comparison test for the stack count of the aura. Most auras do not stack, and those auras will have a stack count of 0 by default.
  • Own Only: Enabling this option will cause the trigger to only consider auras that were cast by the player.
  • Inverse: Enabling this option will completely flip the behavior of the trigger; it will make the display appear whenever the trigger's conditions are not met, and invisible when those conditions are met. It also removes the trigger's ability to provide any dynamic information.

Status

Status triggers are generally based on information about the player or the environment that can always be checked.

Action Usable

The Action Usable trigger checks whether a specified spell is able to be used. This directly correlates with the way it is displayed on the action bar; if the spell would be grayed out (its proc conditions are not met, or there is not enough mana/rage/etc. to cast it) or is on cooldown, then this trigger will not be active.

Action Usable triggers provide Duration Info, Icon Info, and Name Info, but do not show stacks.

Trigger Options:

  • Spell: The name of the spell to be checked. It is only possible to specify a spell that is currently in your spellbook. If this option is not enabled, the trigger will always be active.
  • Require Valid Target: If this option is enabled, the trigger will only be active if the current target is a valid target for the spell. Note that some spells, like AoE spells, cannot have a "valid" target.

Combo Points

The Combo Points trigger checks how many combo points the player has on the current target.

Combo Points triggers provide Duration Info, but not icon, name, or stack info.

Trigger Options:

  • Combo Points: A comparison test for the current number of combo points. If this option is not enabled, the trigger will always be active (which may be desirable).
  • Hide: See Triggers and Untriggers

Cooldown Progress (Spell)

The Cooldown Progress (Spell) trigger tracks the progress of a spell's cooldown.

Cooldown Progress (Spell) triggers provide Duration Info, Icon Info, and Name Info, but not stack info. If the Inverse option is enabled, the duration will always be full.

Trigger Options:

  • Spell: The name of the spell whose cooldown progress should be tracked. It is only possible to specify a spell that is currently in your spellbook. If this option is not enabled, the trigger will always be active.
  • Ignore GCD: Spells are technically put on cooldown whenever a gobal cooldown is used. Enable this option to ignore cooldowns with duration less than 1.5, which will effectively ignore GCDs. Unfortunately, it is not possible to distinguish between a GCD used for the specified spell and a GCD used by any other spell.
  • Inverse: Flips the behavior of the trigger; it will make the display visible if the spell is not on cooldown, and invisible if it is on cooldown.

Cooldown Progress (Item)

The Cooldown Progress (Item) trigger tracks the progress of an item's cooldown.

Cooldown Progress (Item) triggers provide Duration Info, Icon Info, and Name Info, but not stack info. If the Inverse option is enabled, the duration will always be full.

Trigger Options:

  • Item: The name of the spell whose cooldown progress should be tracked. It is only possible to specify a spell that is currently in your spellbook. If this option is not enabled, the trigger will always be active.
  • Ignore GCD: Items are technically put on cooldown whenever a gobal cooldown is used. Enable this option to ignore cooldowns with duration less than 1.5, which will effectively ignore GCDs. Unfortunately, it is not possible to distinguish between a GCD used for the specified item and a GCD used by any other spell.

Death Knight Rune

The Death Knight Rune trigger tracks a single death knight rune. You can specify which rune to track. Obviously, you can use 6 displays with Death Knight Rune triggers to track all 6 runes.

Death Knight Rune triggers provide Duration Info, Icon Info, and Name Info, but not stack info.

Trigger Options:

  • Rune: The rune which should be tracked.
  • Death Rune: This is a tri-state toggle option. If enabled as positive, the trigger will only be active if the specified rune is currently a Death rune. If enabled as negative, the trigger will only be active if the specified rune is currently not a Death Rune. This field can be useful for the purpose of creating 2 displays for a single rune in order to give the displays different settings depending on whether or not it is a Death rune. Note that if this option is left disabled, the display's Icon and Name will automatically be changed while the specified rune is a Death rune.
  • Ready For Use: This is a tri-state toggle option. If enabled as positive, the trigger will only be active if the specified rune is currently ready for use (not on cooldown). If enabled as negative, the trigger will only be active if the specified rune is currently on cooldown.

Health

The Health trigger tracks the health of a unit (not necessarily the player).

Health triggers provide Duration Info, but not icon, name, or stack info.

Trigger Options:

  • Unit: The unit whose health should be tracked. If the specified unit does not exist (e.g., Unit is set to "Target", but you do not currently have a target), the trigger will not be active.
  • Health: A comparison test for the amount of health of the specified unit.
  • Health (%): A comparison test for the percentage of health of the specified unit.
  • Hide: See Triggers and Untriggers

Holy Power

The Holy Power trigger tracks the amount of Holy Power a unit (not necessarily the player) has. Any unit who is not a Paladin will always have 0 Holy Power.

Holy Power triggers provide Duration Info, but not icon, name or stack info.

Trigger Options:

  • Unit: The unit whose Holy Power should be tracked.
  • Holy Power: A comparison test for the amount of Holy Power the specified unit has.
  • Hide: See Triggers and Untriggers

Item Count

The Item Count trigger tracks how many of a specified item the player possesses.

Item Count triggers provide Duration Info, Icon Info, and Name Info, but not stack info. Unlike most triggers that provide duration info, Item Count triggers only provide a "time remaining" value, and not a "maximum duration" value, which means that text displays of duration will display a number (specifically, the number of items possessed), but visual means of tracking duration will always remain at full.

Display Options:

  • Item: The item which should be counted.
  • Include Bank: If this option is enabled, items in the player's bank will also be counted.
  • Include Charges: If this option is enabled, items which can have more than one charge will have each charge counted separately. Note that stacks are different than charges.
  • Item Count: A comparison test for the item count.

Item Equipped

The Item Equipped trigger tracks whether the player is wearing the specified item.

Item Equipped triggers do not provide any dynamic information.

Trigger Options:

  • Item: The item which should be tracked. If this option is not enabled, the trigger will always be active.
  • Inverse: If this option is enabled, the trigger will be active if the player is not wearing the specified item, and not active if the player is.

Power

The Power trigger tracks a Power of a unit (not necessarily the player). There are many types of Power: Mana, Rage, Focus, Energy, Happiness, or Runic Power. The Power trigger can track all of these types at the same time, or one in particularly.

Power triggers provide Duration Info, but not icon, name, or stack info.

Trigger Options:

  • Unit: The unit whose power should be tracked. If the specified unit does not exist, the trigger will not be active.
  • Power Type: The specific type of power to be tracked. Units can generally have only one type of power at a time, so if this option is not enabled, the trigger will automatically test the type of power that the unit is currently using. If it is enabled, the trigger will only test the specified power type. If the unit is not currently using that type of power, the value will be 0.
  • Power: A comparison test for the amount of Power of the specified unit.
  • Power (%): A comparison test for the percentage of Power of the specified unit.
  • Hide: See Triggers and Untriggers

Shards

The Shards trigger tracks the amount of Soul Shards a unit (not necessarily the player) has. Any unit who is not a Warlock will always have 0 Shards.

Shard triggers provide Duration Info, but not icon, name or stack info.

Trigger Options:

  • Unit: The unit whose Holy Power should be tracked.
  • Shards: A comparison test for the amount of Shards the specified unit has.
  • Hide: See Triggers and Untriggers

Stance/Form/Aura

The Stance/Form/Aura trigger tracks the player's current shapeshift form. Many classes can take on different shapeshift forms, but they are called different things for different classes (e.g. "stances" for Warriors or "presences" for Death Knights. Death Knights, Druids, Paladins, Priests, Rogues, Shamans, Warlocks, and Warriors can all have different shapeshift forms. Curiously, although Paladin Auras do count as shapeshift forms, Hunter Aspects do not.

Stance/Form/Aura triggers provide Icon Info and Name Info, but not duration or stack info.

Trigger Options:

  • Class: The player's class.
  • Shapeshift Form: This option's name and value choices will change depending on the class specified. For example, if the Class option is set to "Paladin", this option will be named Aura and the dropdown box will have every Paladin Aura.

Threat Situation

The Threat Situation trigger tracks roughly how much aggro the player has.

Threat Situation triggers do not provide any dynamic info.

Trigger Options:

  • Unit: Unlike most Unit options, this option only allows the choice between "Target" and "At Least One Enemy". When set to "Target", the trigger will test the aggro the player has with the current target. When set to "At Least One Enemy", the trigger will test the aggro of every mob the player is in combat with.
  • Status: The aggro status. When Unit is set to "Target", the choices are straightforward, but when Unit is set to "At Least One Enemy", the situation becomes slightly more complex. In this case, "Lower Than Tank" means the player does not have threat higher than the tank on any mob in combat; "Higher Than Tank" means the player has threat higher than the tank on at least one mob in combat; "Tanking But Not Highest" means the player has aggro on at least one mob in combat, but someone else has higher threat; and "Tanking and Highest" means the player has aggro and highest threat on at least one mob in combat.
  • Hide: See Triggers and Untriggers

Totem

The Totem trigger tracks the duration of one of the four types of totems (Fire, Water, Earth, Air). Obviously, using 4 displays with Totem triggers will allow a Shaman to track all of his/her totems.

Totem triggers provide Duration Info, Icon Info, and Name Info, but not stack info.

Trigger Options:

  • Totem Type: The elemental type of totem to track.
  • Totem Name: If this option is enabled, the trigger will only show when the specified totem name is active.

Event

Event triggers are based on one-time events, and are generally active only for a specified amount of time.

Chat Message

The Chat Message trigger is checked whenever the player receives a chat message.

Chat Message triggers provide Duration Info if they are used with Hide set to "Timed", and no dynamic info if they are not.

Trigger Options:

  • Message Type: Checks the type of the message received. If this option is not enabled, all message types will be valid.
  • Message: This option can be used to check the text of the message in one of three ways. If set to "Is Exactly", the specified string will have to exactly match the text of the message for the trigger to become active. If set to "Contains", the text of the message will have to contain the specified string at some point (e.g., if the specified string is "Icecrown" and someone said "LFM Icecrown Citadel", the trigger would become active). If set to "Matches (Pattern)", the text of the message will be checked if it matches the specified Lua Pattern. Lua Patterns are an advanced programming concept. If you're familiar with regular expression matching, see this Wowpedia page for information on Lua's implementation of patterns. If not, you should probably avoid using this setting.
  • Source Name: Checks the name of the sender of the message. If this option is not enabled, all message senders will be valid.
  • Hide: Controls when the trigger will end once it becomes active. If set to "Timed", the trigger will simply last a specified amount of time (it will refresh if another valid message is detected before time runs out)(if no duration is specified, the display will remain visible indefinitely). If set to "Custom", another set of Chat Message options can be specified, and the display will remain visible until a message matching the second set of conditions is detected.

Combat Log

The Combat Log trigger is easily the most complex pre-defined trigger. It watches the Combat Log and tries to match combat log events. Combat Log triggers can have so many different arguments and meanings that a full description of the Combat Log trigger will not be attempted. Instead, see Wowpedia's overview on combat log messages for more information - although some fields cannot be checked in WeakAuras, most can. Additionally, consider using the

/combatlog

command in WoW to log your combat experiences to <WoW Directory>/Logs/WoWCombatLog.txt in order to find the specific arguments of a combat log message that you want to tell WeakAuras to detect.

Cooldown Ready (Item)

The Cooldown Ready (Item) trigger is checked whenever an item comes off cooldown (becomes ready to use). The point of the Cooldown Ready (Item) trigger is that it is only displayed on screen for a short time. If you want your display to be visible whenever a certain item is not on cooldown, use the Cooldown Progress (Item) trigger (in the Status category) with Inverse enabled.

Cooldown Ready (Item) triggers provide Duration Info, Icon Info, and Name Info.

Trigger Options:

  • Item: The item whose cooldown should be detected.
  • Hide: Controls when the trigger will end once it becomes active. If set to "Timed", the trigger will simply last a specified amount of time (it will refresh if the item goes on cooldown and then goes off cooldown again before time runs out)(if no duration is specified, the display will remain visible indefinitely). The "Custom" option is actually not usable for this trigger type; if you select it, no further options will be given, and the trigger will simply remain active forever once it occurs.

Cooldown Ready (Spell)

The Cooldown Ready (Spell) trigger is checked whenever an spell comes off cooldown (becomes ready to use). The point of the Cooldown Ready (Spell) trigger is that it is only displayed on screen for a short time. If you want your display to be visible whenever a certain spell is not on cooldown, use the Cooldown Progress (Spell) trigger (in the Status category) with Inverse enabled.

Cooldown Ready (Spell) triggers provide Duration Info, Icon Info, and Name Info.

Trigger Options:

  • Spell: The spell whose cooldown should be detected. Only spells currently in the player's spellbook can be specified.
  • Hide: Controls when the trigger will end once it becomes active. If set to "Timed", the trigger will simply last a specified amount of time (it will refresh if the spell goes on cooldown and then goes off cooldown again before time runs out)(if no duration is specified, the display will remain visible indefinitely). The "Custom" option is actually not usable for this trigger type; if you select it, no further options will be given, and the trigger will simply remain active forever once it occurs.

Custom Triggers

Custom triggers are an advanced feature that is only intended for users who know Lua. See Custom Triggers for more information.


Conditions

All triggers have a section at the bottom labeled "Conditions". These are six conditions that are too long-lasting to be treated as triggers, but too temporary to be treated as load conditions. Each can be left un-enabled, enabled as "positive" (green), or enabled as "negative" (red). If a condition is enabled as "positive", the display will only be visible if the condition is met. If the condition is enabled as "negative", the display will only be visible if the condition is not met.

Condition Options:

  • Mounted: Checks whether the player is on a mount.
  • Resting: Checks whether the player is gaining rested experience (i.e., is in a city or inn)
  • In Combat: Checks whether the player is currently in combat.
  • In Vehicle: Checks whether the player is in a vehicle of any type.
  • Alive: Checks whether the player is alive.
  • PvP Flagged: Checks whether the player is PvP flagged.

Multiple Triggers

Each display requires at least one trigger, but it is possible to use multiple triggers for a single display. All of a display's triggers must be active for that display to be shown. If you want to make a display that will show on any of multiple triggers, you will need to simply create many displays with the same graphical settings.

To use multiple triggers with your display, click the "Add Trigger" button at the top of the Trigger tab. This will add another trigger to your display. WeakAuras supports up to 10 triggers per display. You can choose which trigger you want to configure using the dropdown list next to the "Add Trigger" button. Triggers other than the Main Trigger can be deleted by pressing the large "Delete Trigger" button.

You must login to post a comment. Don't have an account? Register to get one!

  • 1 comment
  • Avatar of xiaopaopao xiaopaopao Oct 21, 2011 at 05:12 UTC - 0 likes

    found a mistake in the explanation of Shards trigger. "Unit: The unit whose Holy Power should be tracked. " It should be"Unit: The unit whose Shards should be tracked. "

  • 1 comment