WoW:Events/Unit Info

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ API events

← Event API

Note that this page is automatically generated; editing it is pointless. To edit event descriptions, edit the entries in the alphabetical pages, e.g. Events/A, Events/B, etc. Changes there will be copied over to here within a few hours. Unit Info related events

"PLAYER_FOCUS_CHANGED"	Category: Combat,Unit Info

This event is fired whenever the player's focus target (/focus) is changed, including when the focus target is lost or cleared.

"PLAYER_TARGET_CHANGED"	Category: Combat,Unit Info

This event is fired whenever the player's target is changed, including when the target is lost. arg1 up if you click the target directly, down if you press Escape to clear the target selection, LeftButton if you select the target using static frames in the UI, nil if the target moves out of range and is lost.

"RAID_TARGET_UPDATE"	Category: Party,Unit Info

New in 1.11. Fired when a raid target icon is changed or removed. Also fired when player join or leave a party or raid. arg1 is who gets updated. Note: Does not get triggered if a mob wearing a raid target icon dies (the icon is removed from that mob, however.) Question/Correction: I can not pick up arg1 at all from this event. Change in 1.12? Please clarify if possible. Question/Correction: You are correct. The only arg is 1, which is the event name itself. --Robinson 02:34, 15 January 2007 (CDT)

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

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

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

"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

"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

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

"UNIT_HEALTH_PREDICTION"	Category: Unit Info,Spell

Added in 4.0 arg1 unitId receiving the incoming heal

"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

"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

"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

"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

"UNIT_MAXPOWER"	Category: 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".

"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

"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

"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

"UNIT_POWER"	Category: 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".

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

"UNIT_RANGED_ATTACK_POWER"	Category: Unit Info

Fired when a unit's ranged attack power changes.

"UNIT_RESISTANCES"	Category: Unit Info

Fired when the units resistance changes

"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

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

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