WoW:Events/U: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(added new 3.2 events: UNIT_SPELLCAST_INTERRUPTIBLE, UNIT_SPELLCAST_NOT_INTERRUPTIBLE. VERY likely that these are slightly incorrect and indicated that I guessed at args)
m (Move page script moved page Events/U to Events/U without leaving a redirect)
 
(9 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<noinclude>__NOTOC__{{eventlistheader}}</noinclude>


|}
===== =====
{|
{{evt|UI_ERROR_MESSAGE|System}}
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
{{evt|UI_INFO_MESSAGE|System,Communication}}
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
{{evt|UNIT_ATTACK|Unit Info}}
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').
{{evt|UNIT_ATTACK_POWER|Unit Info}}
Fired when a unit's attack power changes.
|}
===== =====
{|
{{evt|UNIT_ATTACK_SPEED|Unit Info}}
Fired when your attack speed is being listed or affected
{{evt|UNIT_AURA|Unit Info,Buff}}
Fired when a buff, debuff, status, or item bonus was gained by or faded from an entity (player, pet, NPC, or mob.)
; arg1 : the [[API_TYPE_UnitId|UnitID]] of the entity
1-28-06: This event '''IS NOT''' fired when changing targets any longer.
|}
===== =====
{|
{{evt|UNIT_CLASSIFICATION_CHANGED|Unit Info}}
{{evt|UNIT_COMBAT|Unit Info,Combat}}
Fired when an npc or player participates in combat and takes damage
; arg1 : the [[API_TYPE_UnitId|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)
|}
===== =====
{|
{{evt|UNIT_COMBO_POINTS|Unit Info,Combat}}
{{evt|UNIT_DAMAGE|Unit Info}}
Fired when the units melee damage changes.
Be warned that this often gets fired multiple times, for example when you change weapons.
{{evt|UNIT_DEFENSE|Unit Info}}
Fired when a units defense is affected
{{evt|UNIT_DISPLAYPOWER|Unit Info}}
Fired when the unit's mana stype is changed. Occurs when a druid shapeshifts as well as in certain other cases.
; arg1 : [[API_TYPE_UnitId|UnitID]]
|}
===== =====
{|
{{evt|UNIT_DYNAMIC_FLAGS|Unit Info}}
Fired when the unit's flags are changed.
{{evt|UNIT_ENERGY|Unit Info,Player}}
Fired whenever a units energy is affected. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_POWER}} instead.'''
; arg1 : the name of the unit whose energy is affected
Seen unit names:
* player
{{evt|UNIT_ENTERED_VEHICLE|Unit Info,Vehicle}}
; arg1 : the [[API_TYPE_UnitId|UnitID]] of the entity entering a vehicle
; arg2 : unknown boolean value
; arg3 : vehicleType (possible values are 'Natural' and 'Mechanical')
{{evt|UNIT_ENTERING_VEHICLE|Unit Info, Vehicle}}
{{evt|UNIT_EXITED_VEHICLE|Unit Info,Vehicle}}
; arg1 : the [[API_TYPE_UnitId|UnitID]] of the entity exiting a vehicle
{{evt|UNIT_EXITING_VEHICLE|Unit Info,Vehicle}}
{{evt|UNIT_FACTION|Unit Info}}
Fired when a target's faction is announced.
; arg1 : the name of the unit whose faction changed
|}
===== =====
{|
{{evt|UNIT_FLAGS|Unit Info}}
{{evt|UNIT_FOCUS|Unit Info}}
Fires when a unit's focus resource value changes; focus is primarily used for hunter pets. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_POWER}} instead.'''
; arg1 : String - [[unitId]] of the unit whose focus value changed.
{{evt|UNIT_HAPPINESS|Unit Info,Pet}}
Fired when the Pet Happiness changes. Used in PetFrame.lua to decide when to update the happiness display. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_POWER}} instead.'''
|}
===== =====
{|
{{evt-cata|UNIT_HEALTH_PREDICTION|Unit Info,Spell}}
Added in 4.0
; arg1 : [[unitId]] receiving the incoming heal
|}
===== =====
{|
{{evt|UNIT_HEALTH|Unit Info}}
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 [[API_TYPE_UnitId|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 [[API_TYPE_UnitId|UnitID]] of the unit whose health is affected
Seen unit names:
* player, pet, target, mouseover, party1..4, partypet1..4, raid1..40
|}
===== =====
{|
{{evt|UNIT_INVENTORY_CHANGED|Unit Info,Item}}
Fired when the player equips or unequips an item. This can also be called if your target, [[API_TYPE_UnitId|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.
This event is also raised when a temporary enhancement (poison, lure, etc..) is applied to the player's weapon (untested for other units). It will again be raised when that enhancement is removed, including by manual cancellation or buff expiration.
If multiple slots are equipped/unequipped at once it only fires once now. 
This event is no longer triggered when changing zones or logging in. Inventory information is available when PLAYER_ENTERING_WORLD is triggered.
; arg1 : the [[API_TYPE_UnitId|UnitID]] of the entity
|}
===== =====
{|
{{evt|UNIT_LEVEL|Unit Info}}
Fired whenever the level of a unit is submitted (e.g. when clicking a unit or someone joins the party)
; arg1 : the [[API_TYPE_UnitId|UnitID]] of the entity whose level is submitted
{{evt|UNIT_MANA|Unit Info}}
Fired whenever a unit's mana changes. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_MAXPOWER}} instead.'''
; arg1 : the [[API_TYPE_UnitId|UnitID]] of the entity
|}
===== =====
{|
{{evt|UNIT_MAXENERGY|Unit Info}}
Fired when a unit's maximum energy changes. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_MAXPOWER}} instead.'''
; arg1 : [[unitId]]
{{evt|UNIT_MAXFOCUS|Unit Info}}
Fired when a unit's maximum focus changes. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_MAXPOWER}} instead.'''
; arg1 : [[unitId]]
{{evt|UNIT_MAXHAPPINESS|Unit Info}}
Fired when a unit's maximum happiness changes. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_MAXPOWER}} instead.'''
{{evt|UNIT_MAXHEALTH|Unit Info}}
Fired when a unit's maximum health changes.
; arg1 : [[unitID]] of the unit whose health is affected
|}
{|
{{evt|UNIT_MAXMANA|Unit Info}}
Fired when a unit's maximum mana changes. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_MAXPOWER}} instead.'''
; arg1 : [[unitId]]
{{evt-cata|UNIT_MAXPOWER|Unit Info}}
Fired when a unit's maximum power (mana, rage, focus, energy, runic power, ...) changes.
; arg1 : [[UnitId]] whose resource maximum changed
; arg2 : String representation of the resource whose maximum value changed: "MANA", "RAGE", "ENERGY", "FOCUS", "HAPPINESS", "RUNIC_POWER".
{{evt|UNIT_MAXRAGE|Unit Info}}
Fired when a unit's maximum rage changes. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_MAXPOWER}} instead.'''
; arg1 : [[unitId]]
{{evt|UNIT_MAXRUNIC_POWER|Unit Info}}
Added in 3.0. Fired when a unit's maximum runic power changes. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_MAXPOWER}} instead.'''
; arg1 : [[unitId]]
|}
===== =====
{|
{{evt|UNIT_MODEL_CHANGED|Unit Info}}
Fired when the unit's 3d model changes.
{{evt|UNIT_NAME_UPDATE|Unit Info}}
Fired when a unit's name changes.
; arg1 : the [[API_TYPE_UnitId|UnitID]] of the entity whose name changed
|}
===== =====
{|
{{evt|UNIT_PET|Unit Info,Pet}}
Fired when a unit's pet changes.
; arg1 : The [[API_TYPE_UnitId|UnitID]] of the entity whose pet changed
{{evt|UNIT_PET_EXPERIENCE|Unit Info,Pet}}
Fired when the pet's experience changes.
{{evt|UNIT_PORTRAIT_UPDATE|Unit Info}}
Fired when a units portrait changes.
; arg1 : Unit name
{{evt-cata|UNIT_POWER|Unit Info}}
Fired when a unit's current power (mana, rage, focus, energy, runic power, holy power, ...) changes.
; arg1 : [[UnitId]] whose resource value changed
; arg2 : String representation of the resource whose value changed: "MANA", "RAGE", "ENERGY", "FOCUS", "HAPPINESS", "RUNIC_POWER", "HOLY_POWER".
|}
===== =====
{|
{{evt|UNIT_QUEST_LOG_CHANGED|Unit Info,Quest}}
Fired whenever the quest log changes. (Frequently, but not as frequently as QUEST_LOG_UPDATE)
; arg1 : unit name
Seen unit names:
* player
* party1
{{evt|UNIT_RAGE|Unit Info}}
Fired whenever a units rage is affected. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_POWER}} instead.'''
; arg1 : [[unitId]] of a unit whose rage is affected
{{evt|UNIT_RANGEDDAMAGE|Unit Info}}
Fired when a unit's ranged damage changes.
|}
===== =====
{|
{{evt|UNIT_RANGED_ATTACK_POWER|Unit Info}}
Fired when a unit's ranged attack power changes.
|}
===== =====
{|
{{evt|UNIT_RESISTANCES|Unit Info}}
Fired when the units resistance changes
|}
===== =====
{|
{{evt|UNIT_RUNIC_POWER|Unit Info}}
Added in 3.0. Fired when a unit's runic power changes. '''Removed in [[Patch 4.0]], use {{api|t=e|UNIT_POWER}} instead.'''
; arg1 : unit id
|}
===== =====
{|
{{evt|UNIT_SPELLCAST_CHANNEL_START|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_CHANNEL_STOP|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_CHANNEL_UPDATE|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_DELAYED|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_FAILED|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_FAILED_QUIET|Unit Info,Spell}}
; arg1 : Unit casting the spell
; arg2 : Spell name
; arg3 : Spell rank (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_INTERRUPTED|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_INTERRUPTIBLE|Unit Info,Spell}}
Added in 3.2 (Had to guess at the args)
; arg1 : Unit casting the spell
; arg2 : Spell name
; arg3 : Spell rank
{{evt|UNIT_SPELLCAST_NOT_INTERRUPTIBLE|Unit Info,Spell}}
Added in 3.2 (guessing at the args)
; arg1 : Unit casting the spell
; arg2 : Spell name
; arg3 : Spell rank
{{evt|UNIT_SPELLCAST_SENT|Unit Info,Spell}}
<Added in '''Patch 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 (deprecated in 4.0)
; arg4 : Spell target
{{evt|UNIT_SPELLCAST_START|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_STOP|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_SPELLCAST_SUCCEEDED|Unit Info,Spell}}
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 (deprecated in 4.0)
; arg4 : Spell lineID counter
; arg5 : Spell ID (added in 4.0)
{{evt|UNIT_STATS|Unit Info}}
Fired when a units stats are being passed to the player/thing
; arg1 : Unit Name
{{evt|UNIT_TARGET|Unit Info}}
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.
{{evt|UNIT_THREAT_LIST_UPDATE|Unit Info}}
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.
{{evt|UNIT_THREAT_SITUATION_UPDATE|Unit Info}}
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.
|}
===== =====
{|
{{evt|UPDATE_BATTLEFIELD_SCORE|Battleground}}
Fired whenever new battlefield score data has been recieved, this is usually fired after [[API RequestBattlefieldScoreData|RequestBattlefieldScoreData]]() is called.
{{evt|UPDATE_BATTLEFIELD_STATUS|Battleground}}
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.
{{evt|UPDATE_BINDINGS|System}}
Fired when the keybindings are changed.  Fired after completion of [[API LoadBindings|LoadBindings()]], [[API SaveBindings|SaveBindings()]], and [[API SetBinding|SetBinding()]] (and its derivatives).
{{evt|UPDATE_BONUS_ACTIONBAR|Action Bar}}
|}
===== =====
{|
{{evt|UPDATE_CHAT_COLOR|Communication}}
Fired when the chat colour needs to be updated. Refer to the [[API_ChangeChatColor|ChangeChatColor API call]] for details on the parameters.
; arg1 : Chat type
; arg2 : red
; arg3 : green
; arg4 : blue
{{evt|UPDATE_CHAT_COLOR_NAME_BY_CLASS|Communication}}
{{evt|UPDATE_FLOATING_CHAT_WINDOWS|Communication}}
Fired on load when chat settings are available for a certain chat window.
{{evt|UPDATE_CHAT_WINDOWS|Communication}}
Fired on load when chat settings are available for chat windows.
{{evt|UPDATE_EXHAUSTION|Player}}
Fired when your character's XP exhaustion (i.e. the amount of your character's [[rest|rested bonus]]) changes. Use [[API_GetXPExhaustion|GetXPExhaustion()]] to query the current value.
{{evt|UPDATE_FACTION|Player}}
Fired when your character's reputation of some faction has changed.
{{evt|UPDATE_GM_STATUS|Misc}}
|}
===== =====
{|
{{evt|UPDATE_INSTANCE_INFO|Instance}}
Fired when data from RequestRaidInfo() is available
{{evt|UPDATE_INVENTORY_ALERTS|Item,Player}}
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.
{{evt|UPDATE_INVENTORY_DURABILITY|Item,Player}}
Should fire whenever the durability of an item in the character's possession changes. (?)
{{evt|UPDATE_LFG_LIST|Communication}}
When fired prompts the LFG UI to update the list of LFG players. Signals LFG query results are available. See [[API LFGQuery]].
{{evt|UPDATE_LFG_LIST_INCREMENTAL|Looking for Group}}
{{evt|UPDATE_LFG_TYPES|Communication}}
{{evt|UPDATE_MACROS|System}}
{{evt|UPDATE_MASTER_LOOT_LIST|Loot}}
{{evt|UPDATE_MOUSEOVER_UNIT|Misc,Unit Info}}
Fired when the mouseover object needs to be updated.
Fired when the target of the [[API_TYPE_UnitId|UnitID]] 'mouseover' has changed and is a 3d model. (Does not fire when UnitExists('mouseover') becomes nil, or if you mouse over a unitframe.)
{{evt|UPDATE_MULTI_CAST_ACTIONBAR|Action Bar}}
Fired when the shaman totem multicast bar needs an update.
|}
===== =====
{|
{{evt|UPDATE_PENDING_MAIL|Mail}}
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
{{evt|UPDATE_SHAPESHIFT_COOLDOWN|Player,Action Bar}}
{{evt|UPDATE_SHAPESHIFT_FORM|Buff}}
Fired when the current form changes.
* Source [http://forums.worldofwarcraft.com/thread.html;jsessionid=D146E049F46C5045187B54D405866741?topicId=1602252224&sid=1#2]
{{evt|UPDATE_SHAPESHIFT_FORMS|Buff}}
Fired when the available set of forms changes (i.e. on skill gain)
* Source [http://forums.worldofwarcraft.com/thread.html;jsessionid=D146E049F46C5045187B54D405866741?topicId=1602252224&sid=1#2]
{{evt|UPDATE_SHAPESHIFT_USABLE|Player,Action Bar}}
{{evt|UPDATE_STEALTH|Buff}}
|}
===== =====
{|
{{evt|UPDATE_TICKET|Misc}}
{{evt|UPDATE_TRADESKILL_RECAST|Tradeskill}}
{{evt|UPDATE_WORLD_STATES|Battleground}}
Fired within Battlefields when certain things occur such as a flag being captured.
{{evt|USE_BIND_CONFIRM|Item}}

Latest revision as of 04:48, 15 August 2023

Event API


[edit]
"UI_ERROR_MESSAGE"
Category: System
 

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


"UI_INFO_MESSAGE"
Category: System,Communication
 

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


"UNIT_ATTACK"
Category: Unit Info
 

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').


"UNIT_ATTACK_POWER"
Category: Unit Info
 

Fired when a unit's attack power changes.


[edit]
"UNIT_ATTACK_SPEED"
Category: Unit Info
 

Fired when your attack speed is being listed or affected


"UNIT_AURA"
Category: Unit Info,Buff
 


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

arg1
the UnitID of the entity

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

[edit]
"UNIT_CLASSIFICATION_CHANGED"
Category: Unit Info
 


"UNIT_COMBAT"
Category: Unit Info,Combat
 

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)


[edit]
"UNIT_COMBO_POINTS"
Category: Unit Info,Combat
 


"UNIT_DAMAGE"
Category: Unit Info
 

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


"UNIT_DEFENSE"
Category: Unit Info
 

Fired when a units defense is affected


"UNIT_DISPLAYPOWER"
Category: Unit Info
 

Fired when the unit's mana stype is changed. Occurs when a druid shapeshifts as well as in certain other cases.

arg1
UnitID


[edit]
"UNIT_DYNAMIC_FLAGS"
Category: Unit Info
 

Fired when the unit's flags are changed.


"UNIT_ENERGY"
Category: Unit Info,Player
 

Fired whenever a units energy is affected. Removed in Patch 4.0, use UNIT_POWER instead.

arg1
the name of the unit whose energy is affected

Seen unit names:

  • player
"UNIT_ENTERED_VEHICLE"
Category: Unit Info,Vehicle
 
arg1
the UnitID of the entity entering a vehicle
arg2
unknown boolean value
arg3
vehicleType (possible values are 'Natural' and 'Mechanical')
"UNIT_ENTERING_VEHICLE"
Category: Unit Info, Vehicle
 
"UNIT_EXITED_VEHICLE"
Category: Unit Info,Vehicle
 
arg1
the UnitID of the entity exiting a vehicle
"UNIT_EXITING_VEHICLE"
Category: Unit Info,Vehicle
 
"UNIT_FACTION"
Category: Unit Info
 

Fired when a target's faction is announced.

arg1
the name of the unit whose faction changed


[edit]
"UNIT_FLAGS"
Category: Unit Info
 


"UNIT_FOCUS"
Category: Unit Info
 

Fires when a unit's focus resource value changes; focus is primarily used for hunter pets. Removed in Patch 4.0, use UNIT_POWER instead.

arg1
String - unitId of the unit whose focus value changed.


"UNIT_HAPPINESS"
Category: Unit Info,Pet
 

Fired when the Pet Happiness changes. Used in PetFrame.lua to decide when to update the happiness display. Removed in Patch 4.0, use UNIT_POWER instead.


[edit]
Template:Evt-cata Added in 4.0
arg1
unitId receiving the incoming heal
[edit]
"UNIT_HEALTH"
Category: Unit Info
 

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


[edit]
"UNIT_INVENTORY_CHANGED"
Category: Unit Info,Item
 

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.

This event is also raised when a temporary enhancement (poison, lure, etc..) is applied to the player's weapon (untested for other units). It will again be raised when that enhancement is removed, including by manual cancellation or buff expiration.

If multiple slots are equipped/unequipped at once it only fires once now.

This event is no longer triggered when changing zones or logging in. Inventory information is available when PLAYER_ENTERING_WORLD is triggered.

arg1
the UnitID of the entity


[edit]
"UNIT_LEVEL"
Category: Unit Info
 

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


"UNIT_MANA"
Category: Unit Info
 

Fired whenever a unit's mana changes. Removed in Patch 4.0, use UNIT_MAXPOWER instead.

arg1
the UnitID of the entity


[edit]
"UNIT_MAXENERGY"
Category: Unit Info
 

Fired when a unit's maximum energy changes. Removed in Patch 4.0, use UNIT_MAXPOWER instead.

arg1
unitId
"UNIT_MAXFOCUS"
Category: Unit Info
 

Fired when a unit's maximum focus changes. Removed in Patch 4.0, use UNIT_MAXPOWER instead.

arg1
unitId
"UNIT_MAXHAPPINESS"
Category: Unit Info
 

Fired when a unit's maximum happiness changes. Removed in Patch 4.0, use UNIT_MAXPOWER instead.


"UNIT_MAXHEALTH"
Category: Unit Info
 

Fired when a unit's maximum health changes.

arg1
unitID of the unit whose health is affected
"UNIT_MAXMANA"
Category: Unit Info
 

Fired when a unit's maximum mana changes. Removed in Patch 4.0, use UNIT_MAXPOWER instead.

arg1
unitId

Template:Evt-cata Fired when a unit's maximum power (mana, rage, focus, energy, runic power, ...) changes.

arg1
UnitId whose resource maximum changed
arg2
String representation of the resource whose maximum value changed: "MANA", "RAGE", "ENERGY", "FOCUS", "HAPPINESS", "RUNIC_POWER".
"UNIT_MAXRAGE"
Category: Unit Info
 

Fired when a unit's maximum rage changes. Removed in Patch 4.0, use UNIT_MAXPOWER instead.

arg1
unitId
"UNIT_MAXRUNIC_POWER"
Category: Unit Info
 

Added in 3.0. Fired when a unit's maximum runic power changes. Removed in Patch 4.0, use UNIT_MAXPOWER instead.

arg1
unitId
[edit]
"UNIT_MODEL_CHANGED"
Category: Unit Info
 

Fired when the unit's 3d model changes.


"UNIT_NAME_UPDATE"
Category: Unit Info
 

Fired when a unit's name changes.

arg1
the UnitID of the entity whose name changed


[edit]
"UNIT_PET"
Category: Unit Info,Pet
 

Fired when a unit's pet changes.

arg1
The UnitID of the entity whose pet changed


"UNIT_PET_EXPERIENCE"
Category: Unit Info,Pet
 

Fired when the pet's experience changes.

"UNIT_PORTRAIT_UPDATE"
Category: Unit Info
 

Fired when a units portrait changes.

arg1
Unit name

Template:Evt-cata Fired when a unit's current power (mana, rage, focus, energy, runic power, holy power, ...) changes.

arg1
UnitId whose resource value changed
arg2
String representation of the resource whose value changed: "MANA", "RAGE", "ENERGY", "FOCUS", "HAPPINESS", "RUNIC_POWER", "HOLY_POWER".
[edit]
"UNIT_QUEST_LOG_CHANGED"
Category: Unit Info,Quest
 

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

arg1
unit name

Seen unit names:

  • player
  • party1
"UNIT_RAGE"
Category: Unit Info
 

Fired whenever a units rage is affected. Removed in Patch 4.0, use UNIT_POWER instead.

arg1
unitId of a unit whose rage is affected


"UNIT_RANGEDDAMAGE"
Category: Unit Info
 

Fired when a unit's ranged damage changes.


[edit]
"UNIT_RANGED_ATTACK_POWER"
Category: Unit Info
 

Fired when a unit's ranged attack power changes.

[edit]
"UNIT_RESISTANCES"
Category: Unit Info
 

Fired when the units resistance changes

[edit]
"UNIT_RUNIC_POWER"
Category: Unit Info
 

Added in 3.0. Fired when a unit's runic power changes. Removed in Patch 4.0, use UNIT_POWER instead.

arg1
unit id
[edit]
"UNIT_SPELLCAST_CHANNEL_START"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_CHANNEL_STOP"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_CHANNEL_UPDATE"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_DELAYED"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_FAILED"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_FAILED_QUIET"
Category: Unit Info,Spell
 
arg1
Unit casting the spell
arg2
Spell name
arg3
Spell rank (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_INTERRUPTED"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_INTERRUPTIBLE"
Category: Unit Info,Spell
 

Added in 3.2 (Had to guess at the args)

arg1
Unit casting the spell
arg2
Spell name
arg3
Spell rank
"UNIT_SPELLCAST_NOT_INTERRUPTIBLE"
Category: Unit Info,Spell
 

Added in 3.2 (guessing at the args)

arg1
Unit casting the spell
arg2
Spell name
arg3
Spell rank
"UNIT_SPELLCAST_SENT"
Category: Unit Info,Spell
 

<Added in Patch 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 (deprecated in 4.0)
arg4
Spell target
"UNIT_SPELLCAST_START"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_STOP"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_SPELLCAST_SUCCEEDED"
Category: Unit Info,Spell
 

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 (deprecated in 4.0)
arg4
Spell lineID counter
arg5
Spell ID (added in 4.0)
"UNIT_STATS"
Category: Unit Info
 

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

arg1
Unit Name


"UNIT_TARGET"
Category: Unit Info
 

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.


"UNIT_THREAT_LIST_UPDATE"
Category: Unit Info
 

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.


"UNIT_THREAT_SITUATION_UPDATE"
Category: Unit Info
 

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.
[edit]
"UPDATE_BATTLEFIELD_SCORE"
Category: Battleground
 

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


"UPDATE_BATTLEFIELD_STATUS"
Category: Battleground
 

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.


"UPDATE_BINDINGS"
Category: System
 

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


"UPDATE_BONUS_ACTIONBAR"
Category: Action Bar
 


[edit]
"UPDATE_CHAT_COLOR"
Category: Communication
 

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
"UPDATE_CHAT_COLOR_NAME_BY_CLASS"
Category: Communication
 
"UPDATE_FLOATING_CHAT_WINDOWS"
Category: Communication
 

Fired on load when chat settings are available for a certain chat window.

"UPDATE_CHAT_WINDOWS"
Category: Communication
 

Fired on load when chat settings are available for chat windows.


"UPDATE_EXHAUSTION"
Category: Player
 

Fired when your character's XP exhaustion (i.e. the amount of your character's rested bonus) changes. Use GetXPExhaustion() to query the current value.

"UPDATE_FACTION"
Category: Player
 

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


"UPDATE_GM_STATUS"
Category: Misc
 


[edit]
"UPDATE_INSTANCE_INFO"
Category: Instance
 

Fired when data from RequestRaidInfo() is available


"UPDATE_INVENTORY_ALERTS"
Category: Item,Player
 

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.


"UPDATE_INVENTORY_DURABILITY"
Category: Item,Player
 

Should fire whenever the durability of an item in the character's possession changes. (?)


"UPDATE_LFG_LIST"
Category: Communication
 

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

"UPDATE_LFG_LIST_INCREMENTAL"
Category: Looking for Group
 
"UPDATE_LFG_TYPES"
Category: Communication
 


"UPDATE_MACROS"
Category: System
 


"UPDATE_MASTER_LOOT_LIST"
Category: Loot
 


"UPDATE_MOUSEOVER_UNIT"
Category: Misc,Unit Info
 

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.)

"UPDATE_MULTI_CAST_ACTIONBAR"
Category: Action Bar
 

Fired when the shaman totem multicast bar needs an update.

[edit]
"UPDATE_PENDING_MAIL"
Category: Mail
 

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

"UPDATE_SHAPESHIFT_COOLDOWN"
Category: Player,Action Bar
 
"UPDATE_SHAPESHIFT_FORM"
Category: Buff
 

Fired when the current form changes.

"UPDATE_SHAPESHIFT_FORMS"
Category: Buff
 

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

"UPDATE_SHAPESHIFT_USABLE"
Category: Player,Action Bar
 
"UPDATE_STEALTH"
Category: Buff
 
[edit]
"UPDATE_TICKET"
Category: Misc
 


"UPDATE_TRADESKILL_RECAST"
Category: Tradeskill
 


"UPDATE_WORLD_STATES"
Category: Battleground
 

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


"USE_BIND_CONFIRM"
Category: Item