Events/U

Fired when the interface creates an error message. These are the red messages that show in the top middle of the screen. "Your inventory is full." is one example.

arg1 

message

Fired when the interface generates a message. These are the yellow messages in the top middle of the window. "No fish are hooked." is one example.

arg1 

message

Fired when a units attack is affected (such as the weapon being swung). First argument returned appears to be which unit this even applies to (for example, 'player').

Fired when a unit's attack power changes.

Fired when your attack speed is being listed or affected

Fired when a buff, debuff, status, or item bonus was gained by or faded from a player, pet, NPC, or mob.

arg1 

the UnitID of the entity

1-28-06: This event IS NOT fired when changing targets any longer.

Seems like the same as UNIT_AURA above (including arguments) but only for short buffs. As a Paladin, it was triggered each time I gained a 30 second buff (Paladin Seals), lost/canceled it, or switched targets from another player to myself. Needs more testing with other classes etc.

Fired when an npc or player participates in combat and takes damage

arg1 

the UnitID of the entity

arg2 

Action,Damage,etc (e.g. HEAL, DODGE, BLOCK, WOUND, MISS, PARRY, RESIST, ...)

arg3 

Critical/Glancing indicator (e.g. CRITICAL, CRUSHING, GLANCING)

arg4 

The numeric damage

arg5 

Damage type in numeric value (1 - physical; 2 - holy; 4 - fire; 8 - nature; 16 - frost; 32 - shadow; 64 - arcane)

Fired when the units melee damage changes. Be warned that this often gets fired multiple times, for example when you change weapons.

Fired when a units defense is affected

Fired when the unit's mana stype is changed.

arg1 

unit name

Fired when the unit's flags are changed.

Fired whenever a units energy is affected.

arg1 

the name of the unit whose energy is affected

Seen unit names:

• player

Fired when a target's faction is announced.

arg1 

the name of the unit whose faction changed

Same as UNIT_MANA, except for certain classes. Hunter used to use focus, but now they use mana. But it is still used when a pets energy changes.

Fired when the Pet Happiness changes. Used in PetFrame.lua to decide when to update the happiness display.

Fired whenever a units health is affected.

This event may be sent more than once to represent the same change if the affected entity can be accessed through multiple UnitIDs. For example, two UNIT_HEALTH events will be sent for raid party members who are also in your party group.

UNIT_HEALTH events are sent for raid and party members regardless of their distance from the character of the host. This makes UNIT_HEALTH extremely valuable to monitor party and raid members.

arg1 

the UnitID of the unit whose health is affected

Seen unit names:

• player, pet, target, mouseover, party1..4, partypet1..4, raid1..40

Fired when the player equips or unequips an item. This can also be called if your target, mouseover or party member changes equipment (untested for hostile targets).

This event is also raised when a new item is placed in the player's containers, taking up a new slot. If the new item(s) are placed onto an existing stack or when two stacks already in the containers are merged, the event is not raised. When an item is moved inside the container or to the bank, the event is not raised. The event is raised when an existing stack is split inside the player's containers.

If multiple slots are equipped/unequipped at once it only fires once now. However it still fires many times (potentially hundreds) while zoning or logging in.

arg1 

the UnitID of the entity

Fired whenever the level of a unit is submitted (e.g. when clicking a unit or someone joins the party)

arg1 

the UnitID of the entity whose level is submitted

Fired whenever a unit's mana changes either by usage or by regeneration. The event is also called when a unit is clicked on. It only gets called once, unlike its more important brother, UNIT_HEALTH.

arg1 

the UnitID of the entity

Fired when a unit's maximum energy changes.

arg1 

Unit ID (probably)

Fired when a unit's maximum focus changes.

Not studied

Fired when a unit's maximum health changes.

Fired when a unit's maximum mana changes.

arg1 

Unit ID (probably)

Fired when a unit's maximum rage changes.

arg1 

Unit ID (probably)

Added in 3.0. Fired when a unit's maximum runic power changes.

arg1 

Unit ID (probably)

Fired when the unit's 3d model changes.

Fired when a unit's name changes.

arg1 

the UnitID of the entity whose name changed

Fired when a unit's pet changes.

arg1 

The UnitID of the entity whose pet changed

Fired when the pet's experience changes.

Fired when a units portrait changes.

arg1 

Unit name

-removed in 1.11, use UNIT_FACTION instead.

Fired when the UI is loaded, and when player PVP status is changed or updated.

arg1 

the unit whose pvp status has changed (ie. "player")

Fired whenever the quest log changes. (Frequently, but not as frequently as QUEST_LOG_UPDATE)

arg1 

unit name

Seen unit names:

• player
• party1

Fired whenever a units rage is affected.

arg1 

the name of the unit whose rage is affected

Seen unit names:

• player

Fired when a unit's ranged damage changes.

Fired when a unit's ranged attack power changes.

Fired when the units resistance changes

Added in 3.0. Fired when a unit's runic power changes.

arg1 

unit id

Added in 2.0. Fired when a unit begins channeling in the course of casting a spell. Received for party/raid members as well as the player.

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Added in 2.0. Fired when a unit stops channeling. Received for party/raid members as well as the player.

arg1

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Added in 2.0. Received for party/raid members, as well as the player

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Added in 2.0. Fired when a unit's spellcast is delayed, including party/raid members or the player

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Added in 2.0. Fired when a unit's spellcast fails, including party/raid members or the player

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Added in 2.0. Fired when a unit's spellcast is interrupted, including party/raid members or the player

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Added in 2.0. Fired when an event is sent to the server. Other messages indicate when the server begins timing or considers the cast successful.

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

arg4 

Spell target

Added in 2.0. Fired when a unit begins casting, including party/raid members or the player

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Added in 2.0. Fired when a unit stops casting, including party/raid members or the player

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Added in 2.0. Fired when a spell is cast successfully. Event is received even if spell is resisted.

arg1 

Unit casting the spell

arg2 

Spell name

arg3 

Spell rank

Fired when a spell misses

arg1 

Unit Name - can be 'target' 'mouseover' 'player' or 'party1..4' possibly also 'raid1..40'

arg2 

Action - can be 'RESISTED' 'DODGED' 'PARRIED' or 'BLOCKED'

Fired when a units stats are being passed to the player/thing

arg1 

Unit Name

Fired when the target of yourself, raid, and party members change: 'target', 'party1target', 'raid1target', etc.. Should also work for 'pet' and 'focus'. This event only fires when the triggering unit is within the player's visual range. New in 2.x.

arg1 

unitId of the unit which changed targets.

Fired when the client receives updated threat information from the server, if an available mob's threat list has changed at all (ie anybody in combat with it has done anything).

arg1 

unitId of the mob whose threat list changed.

Fired when an available unit on an available mob's threat list moves past another unit on that list.

arg1 

unitId of the unit whose threat situation changed.

Fired whenever new battlefield score data has been recieved, this is usually fired after RequestBattlefieldScoreData() is called.

Fired whenever joining a queue, leaving a queue, battlefield to join is changed, when you can join a battlefield, or if somebody wins the battleground.

Fired when the keybindings are changed. Fired after completion of LoadBindings(), SaveBindings(), and SetBinding() (and its derivatives).

Fired when the chat colour needs to be updated. Refer to the ChangeChatColor API call for details on the parameters.

arg1 

Chat type

arg2 

red

arg3 

green

arg4 

blue

Fired when there's a reason to update the chat windows.

Fired when your character's reputation of some faction has changed.

Fired when data from RequestRaidInfo() is available

Fires whenever an item's durability status becomes yellow (low) or red (broken). Signals that the durability frame needs to be updated. May also fire on any durability status change, even if that change doesn't require an update to the durability frame.

When fired prompts the LFG UI to update the list of LFG players. Signals LFG query results are available. See API LFGQuery.

Fired when the mouseover object needs to be updated.

Fired when the target of the UnitID 'mouseover' has changed and is a 3d model. (Does not fire when UnitExists('mouseover') becomes nil, or if you mouse over a unitframe.)

Fired when the player enters the world and enters/leaves an instance, if there is mail in the player's mailbox.

Fired when new mail is received.

Fired when mailbox window is closed if the number of mail items in the inbox changed (I.E. you deleted mail)

Does not appear to trigger when auction outbid mail is received... may not in other cases as well

GlueXML?

Fired when the current form changes.

• Source [1]

Fired when the available set of forms changes (i.e. on skill gain)

• Source [2]

Fired within Battlefields when certain things occur such as a flag being captured.