WoWWiki

This wiki contains inaccurate and out-of-date information. Please head over to https://wowpedia.fandom.com for more accurate and up-to-date game information.

READ MORE

WoWWiki
Advertisement

Event API

This is a full list of all API events compiled on one page.  It might be more useful to use the normal Event API indexed pages which are simpler to glance at.

This page is aimed at simplifying event finding using the find feature in your browser, looking for a particular word or result. Use the Event API indexed pages if you know the name of the event and want to know what it returns, which might be simpler to glance at and will load faster and will save the wiki bandwidth.

This page is automatically updated from the sub pages. It does not need to be edited. It may however need to be purged sometimes to update with the individual indexed page changes.

A[]

[]
"ACHIEVEMENT_EARNED"
Category: Achievements
 

Fired when an achievement is gained. (New with patch 3.0)

arg1
The id of the achievement gained.
"ACTIONBAR_HIDEGRID"
Category: Action Bar
 

Fired when the actionbar numbers disappear, typically when you finish dragging something to the actionbar

arg1
the mouse button used to click the button. Known values: "LeftButton", "RightButton"
arg2
true or false for unknown reason.


"ACTIONBAR_PAGE_CHANGED"
Category: Action Bar
 

Fired when the actionbar page changes, typically when you press the pageup or pagedown button.

arg1
the mouse button used to click the button. Known values: "LeftButton", "RightButton"
arg2
true or false for unknown reason.


"ACTIONBAR_SHOWGRID"
Category: Action Bar
 

Fired when the actionbar numbers appear, typically when you drag a spell to the actionbar.

no arguments


"ACTIONBAR_SLOT_CHANGED"
Category: Action Bar
 

Fired when any actionbar slot's contents change; typically the picking up and dropping of buttons.

On 4/24/2006, Slouken stated "ACTIONBAR_SLOT_CHANGED is also sent whenever something changes whether or not the button should be dimmed. The first argument is the slot which changed." This means actions that affect the internal fields of action bar buttons also generate this event for the affected button(s). Examples include the Start and End of casting channeled spells, casting a new buff on yourself, and the cancellation or expiration of a buff on yourself.

arg1
the number of the slot that changed
arg2
true or false for unknown reason.
[]
"ACTIONBAR_UPDATE_COOLDOWN"
Category: Action Bar
 

Fired when the cooldown for an actionbar or inventory slot starts or stops. Also fires when you log into a new area.

arg1
if the cooldown is starting, the mouse button used to click the button. Known values: "leftButton"
if the cooldown is stopping or you are logging into a new zone, this is nil


"ACTIONBAR_UPDATE_STATE"
Category: Action Bar
 

Fired when the state of anything on the actionbar changes. This includes cooldown and disabling.

arg1
the mouse button used to click the button. Known values: "LeftButton", "RightButton"
can also be nil


"ACTIONBAR_UPDATE_USABLE"
Category: Action Bar
 

Fired when something in the actionbar or your inventory becomes usable (after eating or drinking a potion, or entering/leaving stealth; for example). This is affected by rage/mana/energy available, but not by range.

no arguments

"ACTIVE_TALENT_GROUP_CHANGED"
Category: Player
 

Fired when a player switches changes which talent group (dual specialization) is active.

arg1
Number - Index of the talent group that is now active.
[]
"ADDON_ACTION_BLOCKED"
Category: System
 

(this event doesn't seem to be used anymore, use ADDON_ACTION_FORBIDDEN instead)

[]
"ADDON_ACTION_FORBIDDEN"
Category: System
 

Fires when an AddOn tries use actions that are always forbidden (movement, targeting, etc.).

If called from an AddOn


arg1
Name of the AddOn that was last involved in the execution path.
arg2
The protected function that was called.
Notes
It's very possible that arg1 will not be the name of the addon that tried to call the protected function.

If called from the chat prompt (/script CastSpellByName("Attack"))


arg1
The protected function that was called.


[]
"ADDON_LOADED"
Category: System
 

This event fires whenever an AddOn is loaded (fires once for each AddOn loaded if multiple AddOns are being loaded), whether that is during the inital Loading Phase or when an AddOn is loaded using the LoadAddOn("addonname") or UIParentLoadAddon("addonname") function. This event always fires after SavedVariables of the AddOn have been loaded from disk and its OnLoad function has been executed.

arg1
name of the AddOn that was just loaded


"AREA_SPIRIT_HEALER_IN_RANGE"
Category: Death
 


"AREA_SPIRIT_HEALER_OUT_OF_RANGE"
Category: Death
 


"ARENA_TEAM_INVITE_REQUEST"
Category: Arena
 
"ARENA_TEAM_ROSTER_UPDATE"
Category: Arena
 

This event fires whenever an arena team is opened in the character sheet. It also fires (3 times) when an arena member leaves, joins, or gets kicked. It does NOT fire when an arena team member logs in or out.

"ARENA_TEAM_UPDATE"
Category: Arena
 

This does NOT fire when an arena member joins the team, leaves, gets kicked, logs in/out. Still unsure when this actually fires.

"ARENA_OPPONENT_UPDATE"
Category: Arena
 

?

"ARENA_SEASON_WORLD_STATE"
Category: Arena
 

?

"AUCTION_BIDDER_LIST_UPDATE"
Category: Auction
 


"AUCTION_HOUSE_CLOSED"
Category: Auction
 

This event is fired when the auction interface is closed.

Note
This event fires twice; once while auction information is still available and once when it is not.
"AUCTION_HOUSE_DISABLED"
Category: Auction
 

Fired when the auction house is not operational.

"AUCTION_HOUSE_SHOW"
Category: Auction
 

This event is fired when the auction interface is first displayed. This is generally done by right-clicking an auctioneer in a major city.


"AUCTION_ITEM_LIST_UPDATE"
Category: Auction
 

This event is fired when the Auction list is updated. Note that this is not only the case, if the list is completely changed but also if it is sorted (i.e. SortAuctionItems() is called).

"AUCTION_MULTISELL_FAILURE"
Category: Auction
 

Fired when listing of multiple stacks fails (or is aborted?).

"AUCTION_MULTISELL_START"
Category: Auction
 

Fired when the client begins listing of multiple stacks.

arg1
Number - total number of stacks the client has to list.
"AUCTION_MULTISELL_UPDATE"
Category: Auction
 

Fired when the client lists a stack as part of listing multiple stacks.

arg1
Number - number of stacks listed so far.
arg2
Number - total number of stacks in the current mass-listing operation.
[]
"AUCTION_OWNED_LIST_UPDATE"
Category: Auction
 


"AUTOEQUIP_BIND_CONFIRM"
Category: Item,Loot
 

Fired when the game attempts to autobind bind-on-equip items.


"AUTOFOLLOW_BEGIN"
Category: Movement
 

Fired when you begin automatically following an ally.

arg1
The unit you are following. Not necessarily your target (in case of right-clicking a group member's portrait or using the "/follow" command).


"AUTOFOLLOW_END"
Category: Movement
 

Fired when the player ceases following an ally

B[]

[]
"BAG_CLOSED"
Category: Item
 

Fired when a bag is (re)moved from its bagslot. Fires both for player bags and bank bags.

arg1
container ID


"BAG_OPEN"
Category: Item
 

Fired when a bag (NOTE: This is NOT fired for player containers, it's for those bag-like objects that you can remove items from but not put items into) is opened.

arg1
container ID
[]
"BAG_UPDATE"
Category: Item
 

Fired when a bags inventory changes. Bag zero, the sixteen slot default backpack, may not fire on login. Upon login (or reloading the console) this event fires even for bank bags. When moving an item in your inventory, this fires multiple times: once each for the source and destination bag. If the bag involved is the default backpack, this event will also fire with a container ID of "-2" (twice if you are moving the item inside the same bag).

arg1
container ID


"BAG_UPDATE_COOLDOWN"
Category: Item
 

Fired when a cooldown update call is sent to a bag

arg1
container ID (may also be nil, 00:47, 15 January 2007 (EST))


"BANKFRAME_CLOSED"
Category: Bank
 

Fired twice when the bank window is closed.

Only at the first one of them the bank data is still available (GetNumBankSlots(), GetContainerItemLink(), ...)

[]
"BANKFRAME_OPENED"
Category: Bank
 

Fired when the bank frame is opened

"BARBER_SHOP_APPEARANCE_APPLIED"
Category: Misc
 
"BARBER_SHOP_CLOSE"
Category: Misc
 
"BARBER_SHOP_OPEN"
Category: Misc
 
"BARBER_SHOP_SUCCESS"
Category: Misc
 


"BATTLEFIELDS_CLOSED"
Category: Battleground
 

Fired when the battlegrounds signup window is closed.


"BATTLEFIELDS_SHOW"
Category: Battleground
 

Fired when the battlegrounds signup window is opened.

"BATTLEFIELD_MGR_EJECTED"
Category: Misc
 

?

"BATTLEFIELD_MGR_EJECT_PENDING"
Category: Misc
 

?

"BATTLEFIELD_MGR_ENTERED"
Category: Misc
 

?

"BATTLEFIELD_MGR_ENTRY_INVITE"
Category: Misc
 

?

"BATTLEFIELD_MGR_QUEUE_INVITE"
Category: Misc
 

?

"BATTLEFIELD_MGR_QUEUE_REQUEST_RESPONSE"
Category: Misc
 

?

"BATTLEFIELD_MGR_STATE_CHANGE"
Category: Misc
 

?

[]
"BILLING_NAG_DIALOG"
Category: Misc
 


"BIND_ENCHANT"
Category: Item
 

Fired when Enchanting an unbound item.

"BN_BLOCK_LIST_UPDATED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_CLOSED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_CREATE_FAILED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_CREATE_SUCCEEDED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_INVITE_FAILED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_INVITE_SUCCEEDED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_JOINED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_LEFT"
Category: Battle.net
 
"BN_CHAT_CHANNEL_MEMBER_JOINED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_MEMBER_LEFT"
Category: Battle.net
 
"BN_CHAT_CHANNEL_MEMBER_UPDATED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_MESSAGE_BLOCKED"
Category: Battle.net
 
"BN_CHAT_CHANNEL_MESSAGE_UNDELIVERABLE"
Category: Battle.net
 
"BN_CHAT_WHISPER_UNDELIVERABLE"
Category: Battle.net
 
"BN_CONNECTED"
Category: Battle.net
 
"BN_CUSTOM_MESSAGE_CHANGED"
Category: Battle.net
 
"BN_CUSTOM_MESSAGE_LOADED"
Category: Battle.net
 
"BN_DISCONNECTED"
Category: Battle.net
 
"BN_FRIEND_ACCOUNT_OFFLINE"
Category: Battle.net
 
"BN_FRIEND_ACCOUNT_ONLINE"
Category: Battle.net
 
"BN_FRIEND_INFO_CHANGED"
Category: Battle.net
 
"BN_FRIEND_INVITE_ADDED"
Category: Battle.net
 
"BN_FRIEND_INVITE_LIST_INITIALIZED"
Category: Battle.net
 
"BN_FRIEND_INVITE_REMOVED"
Category: Battle.net
 
"BN_FRIEND_INVITE_SEND_RESULT"
Category: Battle.net
 
"BN_FRIEND_LIST_SIZE_CHANGED"
Category: Battle.net
 
"BN_FRIEND_TOON_OFFLINE"
Category: Battle.net
 
"BN_FRIEND_TOON_ONLINE"
Category: Battle.net
 
"BN_MATURE_LANGUAGE_FILTER"
Category: Battle.net
 
"BN_NEW_PRESENCE"
Category: Battle.net
 
"BN_REQUEST_FOF_FAILED"
Category: Battle.net
 
"BN_REQUEST_FOF_SUCCEEDED"
Category: Battle.net
 
"BN_SELF_OFFLINE"
Category: Battle.net
 
"BN_SELF_ONLINE"
Category: Battle.net
 
"BN_SYSTEM_MESSAGE"
Category: Battle.net
 
"BN_TOON_NAME_UPDATED"
Category: Battle.net
 

C[]

[]
"CALENDAR_ACTION_PENDING"
Category: Calendar
 

Fired when the calendar API is busy or free

arg1
busyFlag
"CALENDAR_CLOSE_EVENT"
Category: Calendar
 
"CALENDAR_EVENT_ALARM"
Category: Calendar
 
"CALENDAR_NEW_EVENT"
Category: Calendar
 
"CALENDAR_OPEN_EVENT"
Category: Calendar
 

Fired after calling CalendarOpenEvent once the event data has been retrieved from the server

"CALENDAR_UPDATE_INVITE_LIST"
Category: Calendar
 

Fired after CalendarEventSortInvites once the invite list has been sorted.

"CALENDAR_UPDATE_ERROR"
Category: Calendar
 
"CALENDAR_UPDATE_EVENT"
Category: Calendar
 
"CALENDAR_UPDATE_EVENT_LIST"
Category: Calendar
 
"CALENDAR_UPDATE_PENDING_INVITES"
Category: Calendar
 
"CANCEL_LOOT_ROLL"
Category: Loot
 

Fired when a player cancels a roll on an item

arg1
rollID
"CANCEL_SUMMON"
Category: Player
 
"CHANNEL_COUNT_UPDATE"
Category: Misc
 

Fired when number of players in a channel changes but only if this channel is visible in ChannelFrame (it mustn't be hidden by a collapsed category header)

arg1
channel id (item number in Blizzards ChannelFrame -> quod vide API GetChannelDisplayInfo)
arg2
number of players in channel
"CHANNEL_FLAGS_UPDATED"
Category: Misc
 

Fired when user changes selected channel in Blizzards ChannelFrame

arg1
channel id (item number in Blizzards ChannelFrame -> quod vide API GetChannelDisplayInfo)
"CHANNEL_INVITE_REQUEST"
Category: Communication
 
"CHANNEL_PASSWORD_REQUEST"
Category: Misc
 

Fired when user is asked for a password (normally after trying to join a channel without a password or with a wrong one)

arg1
channel name
"CHANNEL_ROSTER_UPDATE"
Category: Misc
 

Fired when user changes selected channel in Blizzards ChannelFrame or number of players in currently selected channel changes

arg1
channel id (item number in Blizzards ChannelFrame -> quod vide API GetChannelDisplayInfo)
arg2
number of players in channel
"CHANNEL_UI_UPDATE"
Category: Misc
 

Fired when Channel UI should change (e.g. joining / leaving a channel causes this event to fire)

"CHANNEL_VOICE_UPDATE"
Category: Misc
 
arg1
unknown
arg2
unknown
arg3
unknown
"CHARACTER_POINTS_CHANGED"
Category: Player
 

Fired when the player's available talent points change

arg1
indicates number of talent points changed: -1 indicates one used (learning a talent), 1 indicates one gained (leveling)
"CHAT_MSG_ACHIEVEMENT"
Category: Communication,Guild,Achievements
 

Fired when a player in your vicinity completes an achievement.

arg1
The full body of the broadcast message.
arg2, arg5
The name of player who has just completed the achievement.
arg7, arg8
Some integer.
"CHAT_MSG_ADDON"
Category: Communication
 

<Added in Patch 1.12>
Fired when the client receives a message from SendAddonMessage
Since patch 4.1, you must register the addon prefix with RegisterAddonMessagePrefix otherwise, events triggered by other players are blocked.

arg1
prefix
arg2
message
arg3
distribution type ("PARTY", "RAID", "GUILD", "BATTLEGROUND" or "WHISPER")
arg4
sender
"CHAT_MSG_AFK"
Category: Communication
 

Fired when the client receives an AFK auto-response

arg1
AFK response message
arg2
author
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_BATTLEGROUND"
Category: Communication,Battleground
 

<Added in Patch 1.12>
Fired when a message is received through the battleground group channel

arg1
chat message
arg2
author
arg3
language
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_BATTLEGROUND_LEADER"
Category: Communication,Battleground
 

<Added in Patch 1.12>
Fired when a message is received from the leader of the battleground group

arg1
chat message
arg2
author
arg3
language
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_BG_SYSTEM_ALLIANCE"
Category: Communication,Battleground
 

Fired for alliance specific events in the battleground such as assaulting a graveyard.

arg1
Battleground Message (eg. "The Alliance has taken the Blacksmith!")
"CHAT_MSG_BG_SYSTEM_HORDE"
Category: Communication,Battleground
 

Fired for horde specific events in the battleground such as assaulting a graveyard.

arg1
Battleground Message (eg. "The Horde has taken the Blacksmith!")
"CHAT_MSG_BG_SYSTEM_NEUTRAL"
Category: Communication,Battleground
 

Fired for non faction specific events in the battlegrounds such as the battle start announcement.

arg1
Battleground Message (eg. "Let the battle for Warsong Gulch begin.")
"CHAT_MSG_BN_CONVERSATION"
Category: Battle.net,Communication
 
"CHAT_MSG_BN_CONVERSATION_LIST"
Category: Battle.net,Communication
 
"CHAT_MSG_BN_CONVERSATION_NOTICE"
Category: Battle.net,Communication
 
"CHAT_MSG_BN_INLINE_TOAST_ALERT"
Category: Battle.net,Communication
 
"CHAT_MSG_BN_INLINE_TOAST_BROADCAST"
Category: Battle.net,Communication
 
"CHAT_MSG_BN_INLINE_TOAST_BROADCAST_INFORM"
Category: Battle.net,Communication
 

Fired when the Bnet Real ID Broadcast Message is changed or from API BNSetCustomMessage

arg1
Broadcast Message
arg11
Chat lineID
"CHAT_MSG_BN_INLINE_TOAST_CONVERSATION"
Category: Battle.net,Communication
 
arg1
toast message (ie. FRIEND_OFFLINE, FRIEND_ONLINE)
arg2
author
arg11
Chat lineID
arg13
Bnet presenceID
"CHAT_MSG_BN_WHISPER"
Category: Battle.net,Communication
 
arg1
chat message
arg2
author
arg6
AFK/DND/GM "CHAT_FLAG_"..arg6 flags
arg11
Chat lineID
arg13
Bnet presenceID
"CHAT_MSG_BN_WHISPER_INFORM"
Category: Battle.net,Communication
 
arg11
Chat lineID
arg13
Bnet presenceID
"CHAT_MSG_CHANNEL"
Category: Communication
 

Fired when the client receives a channel message.

arg1
chat message
arg2
author
arg3
language
arg4
channel name with number ex: "1. General - Stormwind City"
  • zone is always current zone even if not the same as the channel name
arg5
target
  • second player name when two users are passed for a CHANNEL_NOTICE_USER (E.G. x kicked y)
arg6
AFK/DND/GM "CHAT_FLAG_"..arg6 flags
arg7
zone ID used for generic system channels (1 for General, 2 for Trade, 22 for LocalDefense, 23 for WorldDefense and 26 for LFG)
  • not used for custom channels or if you joined an Out-Of-Zone channel ex: "General - Stormwind City"
arg8
channel number
arg9
channel name without number (this is _sometimes_ in lowercase)
  • zone is always current zone even if not the same as the channel name
arg11
Chat lineID used for reporting the chat message.
arg12
Sender GUID
"CHAT_MSG_CHANNEL_JOIN"
Category: Communication
 

Fired when someone joins a chat channel you are in

arg1
seems to be empty
arg2
Name of the player that joined
arg3
seems to be empty again
arg4
Number and name of the channel (e.g. "5. MyOwnChannel")
arg8
Channel number
arg9
channel name without number (this is sometimes in lowercase)
"CHAT_MSG_CHANNEL_LEAVE"
Category: Communication
 

Fired when a player leaves a channel that you are currently inside.

arg1
Appears to be left blank
arg2
Player name that left
arg4
Channel name with number
arg7
Appears to be left zero and no longer the channel number
arg8
Channel number
arg9
Channel name without number
"CHAT_MSG_CHANNEL_LIST"
Category: Communication
 

Fired when ListChannels() or ListChannelByName() is called, and the message is displayed in the chat frame.

arg1
The list of values displayed by ListChannels() or ListChannelByName() in one string.
arg4
The number and name of the channel the message came from. ie: "1. General"
"CHAT_MSG_CHANNEL_NOTICE"
Category: Communication
 

Fired when you enter or leave a chat channel (or a channel was recently throttled)

arg1
type ( "YOU_JOINED" if you joined a channel, or "YOU_LEFT" if you left, or "THROTTLED" if channel was throttled )
arg4
Channel name with number (e.g. "6. TestChannel")
arg7
Channel Type (e.g. 0 for any user channel, 1 for system-channel "General", 2 for "Trade")
arg8
Channel Number
arg9
Channel name without number
"CHAT_MSG_CHANNEL_NOTICE_USER"
Category: Communication
 

Fired when something changes in the channel like moderation enabled, user is kicked, announcements changed and so on. CHAT_*_NOTICE in GlobalStrings.lua has a full list of available types.

arg1
type ("ANNOUNCEMENTS_OFF", "ANNOUNCEMENTS_ON", "BANNED", "OWNER_CHANGED", "INVALID_NAME", "INVITE", "MODERATION_OFF", "MODERATION_ON", "MUTED", "NOT_MEMBER", "NOT_MODERATED", "SET_MODERATOR", "UNSET_MODERATOR" )
arg2
If arg5 has a value then this is the user affected ( eg: "Player Foo has been kicked by Bar" ), if arg5 has no value then it's the person who caused the event ( eg: "Channel Moderation has been enabled by Bar" )
arg4
Channel name with number
arg5
Player that caused the event (eg "Player Foo has been kicked by Bar" )
"CHAT_MSG_COMBAT_FACTION_CHANGE"
Category: Combat
 

Fires when player's faction changes. i.e.: "Your reputation with Timbermaw Hold has very slightly increased." -- NEW 1.9

arg1
chat message
arg11
Chat lineID
"CHAT_MSG_COMBAT_HONOR_GAIN"
Category: Honor,Combat
 

Fired when the player gains any amount of honor, anything from an honorable kill to bonus honor awarded.

arg1
chat message (format: "%s dies, honorable kill Rank: %s (Estimated Honor Points: %d)" or "You have been awarded %d honor.")
"CHAT_MSG_COMBAT_MISC_INFO"
Category: Misc
 

Fires when your equipment takes durability loss from death, and likely other situations as well.(no longer fires on reputation changes as of 1.9)

"CHAT_MSG_COMBAT_XP_GAIN"
Category: Player
 

Fired when you gain XP from killing a creature or finishing a quest. Does not fire if you gain no xp from killing a creature.

arg1
chat message
"CHAT_MSG_DND"
Category: Communication
 

Fired when the client receives a Do-Not-Disturb auto-response

arg1
DND response message
arg2
author
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_EMOTE"
Category: Communication
 

Fired on sending or receiving a custom emote (one used by /e, /emote or a send chat message command with the emote flag)

arg1
Message that was sent/received
arg2
Name of the player who sent the message
arg11
Chat lineID used for reporting the chat message.
arg12
Sender GUID
"CHAT_MSG_FILTERED"
Category: Communication
 
"CHAT_MSG_GUILD"
Category: Communication,Guild
 

Fired when a message is sent or received in the Guild channel.

arg1
Message that was sent
arg2
Author
arg3
Language that the message was sent in
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_GUILD_ACHIEVEMENT"
Category: Communication,Guild,Achievements
 

Fired when a guild member completes an achievement.

arg1
The full body of the achievement broadcast message.
arg2, arg5
Guildmember Name
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_IGNORED"
Category: Communication
 

Fired when you whisper a player that is ignoring you When testing this event the character name is sent twice as arg1 and arg2, Blizzard appears to use arg2 and ignores arg1.

arg1
Character name of who you tried to message
arg2
Character name of who you tried to message
"CHAT_MSG_LOOT"
Category: Loot
 

Fired when loot text is sent to the chat window (someone selects need, greed, passes, rolls, receives). This also fires messages like "Person creates <item>" via tradeskills, and "Person receives <item>" via a trade window.

arg1
Chat message
arg11
Chat lineID
"CHAT_MSG_MONEY"
Category: Loot
 

Fired when a unit loots money.

arg1
Chat message
"CHAT_MSG_MONSTER_EMOTE"
Category: Communication
 

Fired for emotes from a monster, such as 'Murloc Forager attempts to run away in fear!'

arg1
The body of the emote: '%s attempts to run away in fear!'
arg2
The name of the monster: 'Murloc Forager'

(Note: As of 1.12 arg1 now contains a %s string variable for where the mob name should be placed)

"CHAT_MSG_MONSTER_SAY"
Category: Communication
 

Fired when a NPC says something.

arg1
Message
arg2
NPC name
arg3
Language used
arg4
Unused
arg5
Receiver
"CHAT_MSG_MONSTER_WHISPER"
Category: Communication
 

Fired when a NPC whispers you something

"CHAT_MSG_MONSTER_PARTY"
Category: Communication
 
"CHAT_MSG_MONSTER_YELL"
Category: Communication
 

Fired when a NPC yells, example would be the yells during an Alterac Valley from the Herald or a raid boss.

arg1
Message
arg2
NPC Name (eg: Onyxia)
"CHAT_MSG_OFFICER"
Category: Communication
 

Fired when a message is sent or received in the Guild Officer channel.

arg1
Message that was received
arg2
Author
arg3
Language used
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_OPENING"
Category: Communication
 
"CHAT_MSG_PARTY"
Category: Communication,Party
 

Fired when a message is sent or received in the Party channel.

arg1
Message that was received
arg2
Author
arg3
Language used
arg11
Chat lineID
arg12
Sender GUID


"CHAT_MSG_PARTY_LEADER"
Category: Communication,Party
 

Fired when a message is sent or received by the party leader.

arg1
Message that was received
arg2
Author
arg3
Language used
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_PET_INFO"
Category: Communication
 
"CHAT_MSG_RAID"
Category: Communication,Party
 

Fired when a message is sent or received in the Raid.

arg1
chat message
arg2
author
arg3
language
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_RAID_BOSS_EMOTE"
Category: Communication
 
arg1
emote message
arg2
Name of the boss
"CHAT_MSG_RAID_BOSS_WHISPER"
Category: Communication
 
"CHAT_MSG_RAID_LEADER"
Category: Communication,Party
 

Fired when a message is sent or received from the raid leader.

arg1
chat message
arg2
author
arg3
language
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_RAID_WARNING"
Category: Communication,Party
 

Fired when a warning message is sent or received from the raid leader.

arg1
chat message
arg2
author
arg3
language
arg11
Chat lineID
arg12
Sender GUID
"CHAT_MSG_RESTRICTED"
Category: Communication
 
"CHAT_MSG_SAY"
Category: Communication
 

Fired when a message is sent or received in the Say channel.

arg1
chat message
arg2
author
arg3
language
arg11
Chat lineID used for reporting the chat message.
arg12
Sender GUID

Example:
Place this:RegisterEvent("CHAT_MSG_SAY"); in the <OnLoad>/</OnLoad> section of your MyMod.xml file.
Then, have an if (event == "CHAT_MSG_SAY") then MyMod_Say(event, arg1, arg2, arg3); end line, or something like it, in the <OnEvent>/</OnEvent> section

of your MyMod.xml file.

Then, have a function like the following in your MyMod.lua file:

function MyMod_Say(event, arg1, arg2, arg3)
  PrevMsg = arg1;
  PrevPlyr = arg2;
  PrevLang = arg3;
end

This would store the previous message, player who said it, and language it was said in into some variables.

"CHAT_MSG_SKILL"
Category: Player,Skill
 

Fired when some chat messages about skills are displayed.

arg1
The content of the chat message.

arg1 formats are found in Blizzard's GlobalStrings.lua. Some possibilities:

  • ERR_SKILL_GAINED_S (eg. "You have gained the Blacksmithing skill.")
  • ERR_SKILL_UP_SI (eg. "Your skill in Cooking has increased to 221.")
"CHAT_MSG_SYSTEM"
Category: Communication
 

Fired when a system chat message (they are displayed in yellow) is received.

arg1
The content of the chat message.

arg1 formats are found in Blizzard's GlobalStrings.lua. Some possibilities:

  • ERR_LEARN_RECIPE_S (eg. "You have learned how to create a new item: Bristle Whisker Catfish.")
  • MARKED_AFK_MESSAGE (eg. "You are now AFK: Away from Keyboard")

Note: Be very careful with assuming when the event is actually sent. For example, "Quest accepted: Quest Title" is sent before the quest log updates, so at the time of the event the player's quest log does not yet contain the quest. Similarly, "Quest Title completed." is sent before the quest is removed from the quest log, so at the time of the event the player's quest log still contains the quest.

"CHAT_MSG_TARGETICONS"
Category: Communication
 

Fired when a target marker is set. This is used by the chat filter, if the player is watching target markers in chat output (in the Filters right-click menu, under Other, look for Target Icons).

arg1
The formatted message to be displayed in the chat window.
arg12
Some kind of number; no more is known at the time of writing. (Yes, that's a "12", not a typo for "2".)

arg1 is formatted from the global variable TARGET_ICON_SET, which by default in an English client is set to the string

"|Hplayer:%s|h[%s]|h sets |TInterface\\TargetingFrame\\UI-RaidTargetingIcon_%d:0|t on %s."

The other arguments are unused.

"CHAT_MSG_TRADESKILLS"
Category: Communication
 
"CHAT_MSG_TEXT_EMOTE"
Category: Communication
 

Fired for emotes with an emote token. /dance, /healme, etc

arg1
Emote Message
arg2
Name of person who emoted
arg11
Chat lineID used for reporting the chat message.
arg12
Sender GUID
"CHAT_MSG_WHISPER"
Category: Communication
 

Fired when a whisper is received from another player.

arg1
Message received
arg2
Author
arg3
Language (or nil if universal, like messages from GM) (always seems to be an empty string; argument may have been kicked because whispering in non-standard language doesn't seem to be possible [any more?])
arg6
status (like "DND" or "GM")
arg7
(number) message id (for reporting spam purposes?) (default: 0)
arg8
(number) unknown (default: 0)
arg11
Chat lineID used for reporting the chat message.
arg12
Sender GUID
"CHAT_MSG_WHISPER_INFORM"
Category: Communication
 

Fired when the player sends a whisper to another player

arg1
Message sent
arg2
Player who was sent the whisper
arg3
Language
arg11
Chat lineID
arg12
Receiver GUID
"CHAT_MSG_YELL"
Category: Communication
 

Fired when a message is sent or received in the Yell channel.

arg1
Message that was received
arg2
Author
arg3
Language used
arg11
Chat lineID used for reporting the chat message.
arg12
Sender GUID
"CINEMATIC_START"
Category: Misc
 
"CINEMATIC_STOP"
Category: Misc
 
"CLOSE_INBOX_ITEM"
Category: Mail
 
"CLOSE_TABARD_FRAME"
Category: Misc
 

Fired when the guild dress frame is closed

"CLOSE_WORLD_MAP"
Category: Map
 

Supposed to fire whenever the world map is closed/hidden, though it doesn't. A workaround for this is to use "WORLD_MAP_UPDATE" to set a global variable to use elsewhere with an OnUpdate function; e.g.

local Map_Changed = false;

function MyAddon_OnEvent()
 if ( (event == "WORLD_MAP_UPDATE") and WorldMapFrame:IsVisible() ) then
  Map_Changed = true;
 end
end

function MyAddon_OnUpdate()
 if ( (Map_Changed) and not WorldMapFrame:IsVisible() ) then
  ...do this...
  Map_Changed = false;
 end
end

When the second function is called, it checks to see if the map has been opened/closed (Map_Changed), then checks to see if the map is currently open (WorldMapFrame).
The effect is a code that executes only when the map closes.

"COMBAT_LOG_EVENT"
Category: Combat
 

<Added in Patch 2.4.0> See API COMBAT LOG EVENT.
This event fires only if it matches current global combat log filter settings.

"COMBAT_LOG_EVENT_UNFILTERED"
Category: Combat
 

<Added in Patch 2.4.0> See API COMBAT LOG EVENT.
AddOns wanting to parse all events the moment they happen should register for this event. (See this blue posting for more info)

arg1
timestamp
arg2
event
arg3
sourceGUID
arg4
sourceName
arg5
sourceFlags
arg6
destGUID
arg7
destName
arg8
destFlags
arg9
spellID
arg10
spellName
arg11
spellSchool
arg12
SuffixParam1
arg13
SuffixParam2
arg14
SuffixParam3
arg15
SuffixParam4
arg16
SuffixParam5
arg17
SuffixParam6
arg18
SuffixParam7
arg19
SuffixParam8
arg20
SuffixParam9
"COMBAT_RATING_UPDATE"
Category: Player
 
"COMBAT_TEXT_UPDATE"
Category: Combat
 

<Added in Patch 1.12>
Fired when the currently watched entity (as set by the CombatTextSetActiveUnit function) takes or avoids damage, receives heals, gains mana/energy/rage, etc. This event is used by Blizzard's floating combat text addon.

arg1
Combat message type. Known values include "DAMAGE", "SPELL_DAMAGE", "DAMAGE_CRIT", "HEAL", "PERIODIC_HEAL", "HEAL_CRIT", "MISS", "DODGE", "PARRY", "BLOCK", "RESIST", "SPELL_RESISTED", "ABSORB", "SPELL_ABSORBED", "MANA", "ENERGY", "RAGE", "FOCUS", "SPELL_ACTIVE", "COMBO_POINTS", "AURA_START", "AURA_END", "AURA_START_HARMFUL", "AURA_END_HARMFUL", "HONOR_GAINED", and "FACTION".
arg2
For damage, power gain and honor gains, this is the amount taken/gained. For heals, this is the healer name. For auras, the aura name. For block/resist/absorb messages where arg3 is not nil (indicating a partial block/resist/absorb) this is the amount taken. For faction gain, this is the faction name. For the SPELL_ACTIVE message, the name of the spell (abilities like Overpower and Riposte becoming active will trigger this message).
arg3
For heals, the amount healed. For block/resist/absorb messages, this is the amount blocked/resisted/absorbed, or nil if all damage was avoided. For faction gain, the amount of reputation gained.

arg3 does NOT return amount absorbed since at least patch 2.4

"COMMENTATOR_ENTER_WORLD"
Category: Non-Public
 

Fired when the character logs in and the server sends the greeting text. (Currently "Scammers are trying harder than ever to phish for your account information!...") This is not fired when reloading the UI.

No arguments.

"COMMENTATOR_MAP_UPDATE"
Category: Non-Public
 
"COMMENTATOR_PLAYER_UPDATE"
Category: Non-Public
 
"COMMENTATOR_SKIRMISH_MODE_REQUEST"
Category: Non-Public
 
"COMMENTATOR_SKIRMISH_QUEUE_REQUEST"
Category: Non-Public
 
"COMPANION_LEARNED"
Category: Companion
 

<Added in Patch 3.0 (WotLK)>

"COMPANION_UNLEARNED"
Category: Companion
 
"COMPANION_UPDATE"
Category: Companion
 

<Added in Patch 3.0 (WotLK)>

If the type is nil, the UI should update if it's visible, regardless of which type it's managing. If the type is non-nil, then it will be either "CRITTER" or "MOUNT" and that signifies that the active companion has changed and the UI should update if it's currently showing that type.

This event fires when any of the following conditions occur:

  • You, or anyone within range, summons or dismisses a critter
  • You, or anyone within range, mounts or dismounts
  • Someone enters range with a critter summoned
  • Someone enters range while mounted

"Range" appears to be at least 40 yards. If you are in a major city, expect this event to fire constantly.

"CONFIRM_BINDER"
Category: Misc
 
"CONFIRM_DISENCHANT_ROLL"
Category: Loot
 

<Added in patch 3.3>
Fires when you try to roll "disenchant" for and item which Binds on Pickup.

arg1
RollId
arg2
roll (Need: 1, Greed: 2, Disenchant: 3; as in RollOnLoot(RollID, roll))

Note that arg2 should always be 3. In other cases the event "CONFIRM_LOOT_ROLL" would be fired.

"CONFIRM_LOOT_ROLL"
Category: Loot
 

Fires when you try to roll "need" or "greed" for and item which Binds on Pickup.

arg1
RollId
arg2
roll (Need: 1, Greed: 2, Disenchant: 3; as in RollOnLoot(RollID, roll))

Note that arg2 should never be 3. In that case the event "CONFIRM_DISENCHANT_ROLL" would be fired.

"CONFIRM_SUMMON"
Category: Misc
 
"CONFIRM_TALENT_WIPE"
Category: Misc
 

Fires when the user selects the "Yes, I do." confirmation prompt after speaking to a class trainer and choosing to unlearn their talents.

arg1
Cost (260000 is equivalent to 26g). This value is then passed to different frames, depending on where the event is being handled, by calling the MoneyFrame_Update() function. In the case of this event, the cost of the transaction is displayed in a small static popup, and the user prompted for confirmation one final time.
"CONFIRM_XP_LOSS"
Category: Death
 

Accept durability(!) loss in exchange for his body back.

History: Way back before WoW was released, you lost experience rather than durability when you resurrected at a spirit healer.

"CORPSE_IN_INSTANCE"
Category: Death
 
"CORPSE_IN_RANGE"
Category: Death
 

Fired when the player is in range of his body.

"CORPSE_OUT_OF_RANGE"
Category: Death
 

Fired when the player is out of range of his body.

"CRITERIA_UPDATE"
Category: Achievements
 

Fired when the criteria for an achievement has changed. (Fires several times at once, presumably for different levels of achievements and yet-unknown feats of strength, but this has yet to be confirmed and there may be another use for this Event. joequincy (talk) 18:24, 20 October 2008 (UTC))

"CURRENT_SPELL_CAST_CHANGED"
Category: Spell
 

Fired when the spell being cast is changed.

"CURRENCY_DISPLAY_UPDATE"
Category: Player,Misc
 
"CURSOR_UPDATE"
Category: Misc
 

Fired when the player right-clicks terrain, and on mouseover before UPDATE_MOUSEOVER_UNIT and on mouseout after UPDATE_MOUSEOVER_UNIT. This excludes doodads, player characters, and NPCs that lack interaction.

"CVAR_UPDATE"
Category: System
 

Fired when a CVar is changed

arg1
cvarname
arg2
value

D[]

[]
"DELETE_ITEM_CONFIRM"
Category: Item
 

Fired when the player attempts to destroy an item.

arg1
item name


"DISPLAY_SIZE_CHANGED"
Category: System
 
"DISABLE_LOW_LEVEL_RAID"
Category: Raid,Player
 

Fired when SetAllowLowLevelRaid is used to disable low-level raids on the character.

"DISABLE_TAXI_BENCHMARK"
Category: System
 

?

"DISABLE_XP_GAIN"
Category: Player
 

?

"DUEL_FINISHED"
Category: Combat
 

Fired when a duel is finished.


"DUEL_INBOUNDS"
Category: Combat
 

Fired when the player returns in bounds after being out of bounds during a duel.


[]
"DUEL_OUTOFBOUNDS"
Category: Combat
 

Fired when the player leaves the bounds of the duel


"DUEL_REQUESTED"
Category: Combat
 

Fired when the player is challenged to a duel

arg1
opponent name

E[]

[]
"ENABLE_LOW_LEVEL_RAID"
Category: Raid,Player
 

Fired when SetAllowLowLevelRaid is used to enable low-level raids on the character.

"ENABLE_TAXI_BENCHMARK"
Category: System
 

?

"ENABLE_XP_GAIN"
Category: Player
 

?

"END_BOUND_TRADEABLE"
Category: Item
 

?

"END_REFUND"
Category: Item
 

?

"EQUIPMENT_SWAP_PENDING"
Category: Item,Player
 

?

"EQUIP_BIND_CONFIRM"
Category: Loot,Item
 

Fired when the player attempts to equip bind on equip loot.

"EQUIPMENT_SETS_CHANGED"
Category: Misc,Item
 

Fired when a new equipment set is created, an equipment set is deleted or an equipment set has changed.

"EQUIPMENT_SWAP_FINISHED"
Category: Misc, Item
 

Fired when an equipment set has finished equipping

arg1
Boolean value: True if the set change was successful
arg2
String Value: The name of the set that was changed.
"EXECUTE_CHAT_LINE"
Category: Misc
 

Fired to execute macro commands.

arg1
The "chat line" (macro command line) to execute.

F[]

[]
"FRIENDLIST_UPDATE"
Category: Communication
 

Fired when...

  1. You log in
  2. Open the friends window (twice)
  3. Switch from the ignore list to the friend's list
  4. Switch from the guild, raid, or who tab back to the friends tab (twice)
  5. Add a friend
  6. Remove a friend
  7. Friend comes online
  8. Friend goes offline

No args.

G[]

[]
"GLYPH_ADDED"
Category: Glyph
 

?

"GLYPH_DISABLED"
Category: Glyph
 

?

"GLYPH_ENABLED"
Category: Glyph
 

?

"GLYPH_REMOVED"
Category: Glyph
 

?

"GLYPH_UPDATED"
Category: Glyph
 

?

"GMRESPONSE_RECEIVED"
Category: Communication
 

?

"GM_PLAYER_INFO"
Category: Misc
 

?

"GMSURVEY_DISPLAY"
Category: Misc
 
"GOSSIP_CLOSED"
Category: Misc
 

Fired when you close the talk window for an npc

(Seems to be called twice)
arg1
The mouse button used to close the window (nil if closed when you go out of range)
"GOSSIP_CONFIRM"
Category: Misc
 
"GOSSIP_CONFIRM_CANCEL"
Category: Misc
 
[]
"GOSSIP_ENTER_CODE"
Category: Misc
 
[]
"GOSSIP_SHOW"
Category: Misc
 

Fired when you talk to an npc

This event typically fires when you are given several choices, including choosing to sell item, select available and active quests, just talk about something, or bind to a location. Even when the the only available choices are quests, this event is often used instead of QUEST_GREETING.
no arguments
[]
"GROUP_ROSTER_CHANGED"
Category: Group
 

Fired when the group's player's group member status changes. ADDED (5.0.4)

Note: The below needs to be validated with 5.0.4 or newer.

Fired whenever a raid is formed or disbanded, players are leaving or joining a raid (unsure if rejected join requests also fire the event), or when looting rules are changed (regardless of being in raid or party.)

As of 1.8.3 this event also fires when players are moved around in a Raid and when a player leaves the raid. This holds true even if the changes do not affect your party within the raid.

4-2-05 Edit: This event is called twice when the event PARTY_LOOT_METHOD_CHANGED is called.

7-28-05 EDIT: This event is generated when someone joins or leaves the group, also generated whenever someone rejects an invite and you're in a group. Also, if for instance you have 3 people in your group and you invite a 4th, it will generate 4 events. If you call GetNumPartyMembers() it will return 0, 1, 2, and 3. First event returing zero, 2nd event returning 1, etc etc.

[]
"GUILDBANKBAGSLOTS_CHANGED"
Category: Bank
 

Fired when the guild-bank contents change

[]
"GUILDBANKFRAME_CLOSED"
Category: Bank
 

Fired when the guild-bank frame is closed

[]
"GUILDBANKFRAME_OPENED"
Category: Bank
 

Fired when the guild-bank frame is opened

[]
"GUILDBANKLOG_UPDATE"
Category: Bank
 

Fired when the guild-bank log is updated.

[]
"GUILDBANK_ITEM_LOCK_CHANGED"
Category: Bank
 


[]
"GUILDBANK_TEXT_CHANGED"
Category: Bank
 


[]
"GUILDBANK_UPDATE_MONEY"
Category: Bank
 


[]
"GUILDBANK_UPDATE_TABS"
Category: Bank
 


[]
"GUILDBANK_UPDATE_TEXT"
Category: Bank
 


[]
"GUILDBANK_UPDATE_WITHDRAWMONEY"
Category: Bank
 


[]
"GUILD_INVITE_CANCEL"
Category: Guild
 

Fired when the guild invitation is declined.

[]
"GUILD_INVITE_REQUEST"
Category: Guild
 

Fired when you are invited to join a guild.

arg1
guild inviter
arg2
guild name
[]
"GUILD_MOTD"
Category: Guild
 

Fired when the guild messages of the day is shown.

arg1
guild message of the day
[]
"GUILD_REGISTRAR_CLOSED"
Category: Guild
 


[]
"GUILD_REGISTRAR_SHOW"
Category: Guild
 
[]
"GUILD_ROSTER_UPDATE"
Category: Guild
 

Fired when the client's guild info cache has been updated after a call to GuildRoster() or after any data change in any of the guild's data, excluding the Guild Information window.

arg1
nil if this event was triggered by the client cache being updated after a call to GuildRoster, 1 if there was a local change to Guild roster data

|}

"GUILDTABARD_UPDATE"
Category: Guild
 

?

"GUILD_EVENT_LOG_UPDATE"
Category: Guild
 

?

[]

"GUILD_XP_UPDATE"
Category: Guild
 

Fired when the guild gains exp see also: UnitGetGuildXP()

H[]

"HONOR_CURRENCY_UPDATE"
Category: Honor
 

I[]

[]
"IGNORELIST_UPDATE"
Category: Communication
 

Fired when a player is added or removed from the ignore list. Event is called twice. Not certain why it is called twice.


"IGR_BILLING_NAG_DIALOG"
Category: Misc
 
"INSPECT_ACHIEVEMENT_READY"
Category: Inspect,Misc
 

?

"INSPECT_HONOR_UPDATE"
Category: Inspect,Misc
 

?

"INSPECT_READY"
Category: Talents
 

After a NotifyInspect(unit) is called, this is fired, indicating the Inspected player's talents have been loaded.

arg1
The GUID of the unit the inspection data is being provided for

NOTE: Added in the 4.0.1 patch

"INSPECT_TALENT_READY"
Category: Talents
 

After a NotifyInspect(unit) is called, this is fired, indicating the Inspected player's talents have been loaded.

NOTE: This event was removed in the 4.0.1 patch

"INSTANCE_BOOT_START"
Category: Instance
 

Fired when the countdown to boot a player from an instance starts.

"INSTANCE_BOOT_STOP"
Category: Instance
 

Fired when the countdown to boot a player from an instance stops.

"INSTANCE_ENCOUNTER_ENGAGE_UNIT"
Category: Instance
 

?

"INSTANCE_LOCK_START"
Category: Instance
 

?

"INSTANCE_LOCK_STOP"
Category: Instance
 

Fired when quitting the game.

[]
"ITEM_LOCKED"
Category: Item
 

Fires when an item gets "locked" in the inventory or a container

arg1
Bag of item
arg2
Slot of item
"ITEM_LOCK_CHANGED"
Category: Item
 

Fires when the "locked" status on a container or inventory item changes, usually from but not limited to Pickup functions to move items.

- If arg2 is non-nil:

arg1
Bag of updated item.
arg2
Slot of updated item.

- If arg2 is nil:

arg1
Equipment slot of item
  • Usually fires in pairs when an item is swapping with another.
  • Empty slots do not lock.
  • GetContainerItemInfo and IsInventoryItemLocked can be used to query lock status.
  • This does NOT fire on ammo pickups.
"ITEM_UNLOCKED"
Category: Item
 

?

"ITEM_PUSH"
Category: Item
 

Fired when an item is pushed onto the "inventory-stack". For instance when you manufacture something with your trade skills or picks something up.

arg1
the bag that has received the new item
arg2
the path to the item's icon


"ITEM_TEXT_BEGIN"
Category: Item
 

Fired when an items text begins displaying


[]
"ITEM_TEXT_CLOSED"
Category: Item
 

Fired when the items text has completed its viewing and is done.


"ITEM_TEXT_READY"
Category: Item
 

Fired when the item's text can continue and is ready to be scrolled.


"ITEM_TEXT_TRANSLATION"
Category: Item
 

Fired when an item is in the process of being translated.

J[]

No events beginning with the letter J.

K[]

"KNOWLEDGE_BASE_ARTICLE_LOAD_FAILURE"
Category: Knowledge Base
 
"KNOWLEDGE_BASE_ARTICLE_LOAD_SUCCESS"
Category: Knowledge Base
 
"KNOWLEDGE_BASE_QUERY_LOAD_FAILURE"
Category: Knowledge Base
 
"KNOWLEDGE_BASE_QUERY_LOAD_SUCCESS"
Category: Knowledge Base
 
"KNOWLEDGE_BASE_SERVER_MESSAGE"
Category: Knowledge Base
 
"KNOWLEDGE_BASE_SETUP_LOAD_FAILURE"
Category: Knowledge Base
 
"KNOWLEDGE_BASE_SETUP_LOAD_SUCCESS"
Category: Knowledge Base
 
"KNOWLEDGE_BASE_SYSTEM_MOTD_UPDATED"
Category: Knowledge Base
 
"KNOWN_CURRENCY_TYPES_UPDATE"
Category: Currency
 

?

"KNOWN_TITLES_UPDATE"
Category: Player
 

?

L[]

[]
"LANGUAGE_LIST_CHANGED"
Category: Communication
 
"LEVEL_GRANT_PROPOSED"
Category: Player
 

?

"LEARNED_SPELL_IN_TAB"
Category: Spell
 

Fired when a new spell/ability is added to the spellbook. e.g. When training a new or a higher level spell/ability.

arg1
Number of the tab which the spell/ability is added to
"LFG_COMPLETION_REWARD"
Category: Instance
 

Fired when a random dungeon (picked by the Dungeon Finder) is completed. This event causes a window similar to the achievement alert to appear, with the details of your Dungeon Finder rewards.

"LFG_UPDATE"
Category: Instance
 

When fired prompts the LFG UI to update the list of available LFG categories and objectives (i.e. new quests, zones, instances available to LFG). See API GetLFGTypes

"LFG_BOOT_PROPOSAL_UPDATE"
Category: Instance
 

?

"LFG_LOCK_INFO_RECEIVED"
Category: Instance
 

?

"LFG_OFFER_CONTINUE"
Category: Instance
 

?

"LFG_OPEN_FROM_GOSSIP"
Category: Instance
 

Fired when a gossip option is used to initiate a Looking-for-Dungeon interaction.

arg1
Number - index of the dungeon the NPC wants us to queue for (index to GetLFGDungeonInfo(id)).
"LFG_PROPOSAL_FAILED"
Category: Instance
 

Fired when someone decline or don't make a choice within time in the dungeon queue invite

"LFG_PROPOSAL_SHOW"
Category: Instance
 

Fired when a dungeon group was found and the dialog to accept or decline it appears

"LFG_PROPOSAL_SUCCEEDED"
Category: Instance
 

Fired when everyone in the dungeon queue accepted the invite

"LFG_PROPOSAL_UPDATE"
Category: Instance
 

Fired when someone either accept or decline the dungeon queue invite

"LFG_QUEUE_STATUS_UPDATE"
Category: Instance
 

?

"LFG_ROLE_CHECK_HIDE"
Category: Instance
 

?

"LFG_ROLE_CHECK_ROLE_CHOSEN"
Category: Instance
 

?

"LFG_ROLE_CHECK_SHOW"
Category: Instance
 

?

"LFG_ROLE_CHECK_UPDATE"
Category: Instance
 

?

"LFG_ROLE_UPDATE"
Category: Instance
 

?

"LFG_UPDATE_RANDOM_INFO"
Category: Instance
 

?

"LOCALPLAYER_PET_RENAMED"
Category: Pet
 


"LOGOUT_CANCEL"
Category: System
 


[]
"LOOT_BIND_CONFIRM"
Category: Loot
 

Fired when the player attempts to take 'bind-on-pickup' loot


"LOOT_CLOSED"
Category: Loot
 

Fired when a player ceases looting a corpse. Note that this will fire before the last CHAT_MSG_LOOT event for that loot.


"LOOT_OPENED"
Category: Loot
 

Fired when a corpse is looted

arg1
1 if autolooting, otherwise 0 (not nil!)


"LOOT_SLOT_CLEARED"
Category: Loot
 

Fired when loot is removed from a corpse.

arg1
Slot number
"LOOT_SLOT_CHANGED"
Category: Loot
 

?

M[]

[]
"MACRO_ACTION_BLOCKED"
Category: System
 

(this event doesn't seem to be used anymore, use MACRO_ACTION_FORBIDDEN)

"MACRO_ACTION_FORBIDDEN"
Category: System
 

Sent when a macro tries use actions that are always forbidden (movement, targeting, etc.).

arg1
As of 3.0.2 (possibly sooner) this argument appears to always be "UNKNOWN()"
[]
"MAIL_CLOSED"
Category: Mail
 

Fired when the mailbox window is closed.

"MAIL_FAILED"
Category: Mail
 
"MAIL_INBOX_UPDATE"
Category: Mail
 

This event is fired when the inbox changes in any way, including

  • when the inbox list is loaded while the frame is open
  • when a mail item changes from new to read
  • when a mail item is opened for the first time in a session
arg1
the mouse button clicked when opening a mail item; otherwise arg1 is nil.
arg2
always false
"MAIL_LOCK_SEND_ITEMS"
Category: Mail
 

Fired when you send an item that needs a confirmation (e.g. heirlooms that are still refundable)

arg1
Mail Slot
arg2
itemLink
"MAIL_SEND_INFO_UPDATE"
Category: Mail
 

Fired when an item is dragged to or from the Send Item box in an outgoing mail message.

"MAIL_SUCCESS"
Category: Mail
 

?

"MAIL_UNLOCK_SEND_ITEMS"
Category: Mail
 

Fires when the mail confirmation is cancelled and the concerned item(s) need to be unlocked

[]
"MAIL_SEND_SUCCESS"
Category: Mail
 

Fired when a mail has been successfully sent to the mailbox of the recipient, it is also called when the mailbox is opened for some reason ... bug?


"MAIL_SHOW"
Category: Mail
 

Fired when the mailbox is first opened.

arg1
returns "up"


"MERCHANT_CLOSED"
Category: Misc
 

Fired when a merchant frame closes. (Called twice)

arg1
button used to close the window)
[]
"MERCHANT_SHOW"
Category: Misc
 

Fired when the merchant frame is shown.


"MERCHANT_UPDATE"
Category: Misc
 

Fired when a merchant updates

"MINIGAME_UPDATE"
Category: Misc
 

?

"MINIMAP_PING"
Category: Map
 

Fired when the minimap is pinged.

arg1
UnitId of the one that created the ping (ie "player" or any of the group members)
arg2
x
arg3
y


[]
"MINIMAP_UPDATE_ZOOM"
Category: Map
 

Fired when the minimap scaling factor is changed. This happens, generally, whenever the player moves indoors from outside, or vice versa. There are no arguments to this event. To test the player's location, compare the minimapZoom and minimapInsideZoom CVars with the current minimap zoom level (see GetZoom).

This event does not relate to the + and - minimap zoom buttons.


"MINIMAP_UPDATE_TRACKING"
Category: Map
 

Added in 2.3, this event is fired when the player selects a different tracking type from the menu attached to the mini map. There seems to be no useful arguments as of the time of this writing.

arg1
Mouse button used to click the tracking button (i.e. "LEFTBUTTON")


"MIRROR_TIMER_PAUSE"
Category: Misc
 

Fired when the mirror timer is paused.

arg1
pause duration
[]
"MIRROR_TIMER_START"
Category: Misc
 

Fired when some sort of timer starts.

arg1
timer ( for ex. "BREATH" )
arg2
value ( start-time in ms, for ex. 180000 )
arg3
maxvalue ( max-time in ms, for ex. 180000 )
arg4
scale ( time added per second in seconds, for ex. -1 )
arg5
paused
arg6
label ( for ex. "Breath" )


"MIRROR_TIMER_STOP"
Category: Misc
 

Fired when a mirror timer is stopped.

arg1
timer ( for ex. "BREATH" )


"MODIFIER_STATE_CHANGED"
Category: Misc
 

Fired when shift/ctrl/alt keys are pressed or released. Does not fire when an EditBox has keyboard focus.

arg1
"LSHIFT", "RSHIFT", "LCTRL", "RCTRL", "LALT", "RALT"
arg2
1 for pressed, 0 (not nil!) for released
"MOVIE_COMPRESSING_PROGRESS"
Category: Movie Capture
 

?

"MOVIE_RECORDING_PROGRESS"
Category: Movie Capture
 

?

"MOVIE_UNCOMPRESSED_MOVIE"
Category: Movie Capture
 

?

"MUTELIST_UPDATE"
Category: Communication
 

?

N[]

"NEW_AUCTION_UPDATE"
Category: Auction
 

Sent out whenever a user drags an item into the Auction Item box on the Auctions tab of the auction house window.

"NEW_TITLE_EARNED"
Category: Misc
 
"NPC_PVPQUEUE_ANYWHERE"
Category: PvP
 

?

O[]

"OLD_TITLE_LOST"
Category: Misc
 
"OPEN_MASTER_LOOT_LIST"
Category: Loot
 


"OPEN_TABARD_FRAME"
Category: Misc
 

Fired when the guild dress frame is opened.

P[]

[]
"PARTY_CONVERTED_TO_RAID"
Category: Party, Raid
 

?

"PARTY_INVITE_CANCEL"
Category: Party
 

Fired when you decline a party invite.


"PARTY_INVITE_REQUEST"
Category: Party
 

Fired when a player invite you to party.

arg1
team leader name


"PARTY_LEADER_CHANGED"
Category: Party
 

Fired when the player's leadership changed.

Referred to as buggy.

"PARTY_LFG_RESTRICTED"
Category: Party, Instance
 

?

[]
"PARTY_LOOT_METHOD_CHANGED"
Category: Party,Loot
 

Fired when the party's loot method changes

[]
"PARTY_MEMBERS_CHANGED"
Category: Party
 

REMOVED (5.0.4) - see: GROUP_ROSTER_UPDATE

Fired when the player's party changes.

As of 1.8.3 this event also fires when players are moved around in a Raid and when a player leaves the raid. This holds true even if the changes do not affect your party within the raid.

4-2-05 Edit: This event is called twice when the event PARTY_LOOT_METHOD_CHANGED is called.

7-28-05 EDIT: This event is generated when someone joins or leaves the group, also generated whenever someone rejects an invite and you're in a group. Also, if for instance you have 3 people in your group and you invite a 4th, it will generate 4 events. If you call GetNumPartyMembers() it will return 0, 1, 2, and 3. First event returing zero, 2nd event returning 1, etc etc.

[]
"PARTY_MEMBER_DISABLE"
Category: Party
 

Fired when a specific party member is offline or dead

arg1
Player Name


"PARTY_MEMBER_ENABLE"
Category: Party
 

Fired when a specific party member is still connected

arg1
Player Name


[]
"PETITION_CLOSED"
Category: Arena,Guild
 

Fired when a petition is closed, e.g. by you signing it. See PETITION_SHOW.

"PETITION_SHOW"
Category: Arena,Guild
 

Fired when you are shown a petition to create a guild or arena team. This can be due to someone offering you to sign it, or because of you clicking your own charter in your inventory. GetPetitionInfo() will tell you more.

"PETITION_VENDOR_CLOSED"
Category: Arena,Guild
 
"PETITION_VENDOR_SHOW"
Category: Arena,Guild
 
"PETITION_VENDOR_UPDATE"
Category: Arena,Guild
 


[]
"PET_ATTACK_START"
Category: Combat,Pet
 

Fired when the player's pet begins attacking.


"PET_ATTACK_STOP"
Category: Combat,Pet
 

Fired when the player's pet ceases attack


[]
"PET_BAR_HIDE"
Category: Pet,Action Bar
 

?

"PET_BAR_HIDEGRID"
Category: Pet,Action Bar
 

Fired when pet spells are dropped into the PetActionBar.


"PET_BAR_SHOWGRID"
Category: Pet, Action Bar
 

Fired when pet spells are dragged from the pet spellbook or the PetActionBar.

arg1
MouseButton used (e.g. "LeftButton","RightButton")
"PET_BAR_UPDATE"
Category: Pet, Action Bar
 

Fired when the pet bar is updates.

"PET_BAR_UPDATE_USABLE"
Category: Pet,ActionBar
 

?

[]
"PET_BAR_UPDATE_COOLDOWN"
Category: Pet, Action Bar
 

Fired when a pet spell cooldown starts. It is not called when cooldown ends.

"PET_DISMISS_START"
Category: Pet
 

?

"PET_SPELL_POWER_UPDATE"
Category: Pet
 

Fires when the pet's spell power bonus changes. Use GetPetSpellBonusDamage() to retrieve the new value.

"PET_FORCE_NAME_DECLENSION"
Category: Pet
 

?

"PET_RENAMEABLE"
Category: Pet
 

?

"PET_STABLE_CLOSED"
Category: Pet
 


"PET_STABLE_SHOW"
Category: Pet
 


"PET_STABLE_UPDATE"
Category: Pet
 


[]
"PET_STABLE_UPDATE_PAPERDOLL"
Category: Pet
 
"PET_TALENT_UPDATE"
Category: Pet
 

?

"PET_UI_CLOSE"
Category: Pet
 


"PET_UI_UPDATE"
Category: Pet
 
"PLAYER_DIFFICULTY_CHANGED"
Category: Raid
 

This event fires when the raid leader changes the difficulty of an instance.

"PLAYERBANKBAGSLOTS_CHANGED"
Category: Bank
 

This event only fires when bank bags slots are purchased. It no longer fires when bags in the slots are changed. Instead, when the bags are changed, PLAYERBANKSLOTS_CHANGED will fire, and arg1 will be NUM_BANKGENERIC_SLOTS + BagIndex.

[]
"PLAYERBANKSLOTS_CHANGED"
Category: Bank
 

Fired when the One of the slots in the player's 24 bank slots has changed, or when any of the equipped bank bags have changed.

Does not fire when an item is added to or removed from a bank bag.

arg1
When (arg1 <= NUM_BANKGENERIC_SLOTS), arg1 is the index of the generic bank slot that changed. When (arg1 > NUM_BANKGENERIC_SLOTS), (arg1 - NUM_BANKGENERIC_SLOTS) is the index of the equipped bank bag that changed.
"PLAYER_ALIVE"
Category: Death
 

Fired when the player:

  • Releases from death to a graveyard.
  • Accepts a resurrect before releasing their spirit.

Does not fire when the player is alive after being a ghost. PLAYER_UNGHOST is triggered in that case.


[]
"PLAYER_AURAS_CHANGED"
Category: Buff
 

11/8/2008 This was removed with 3.02. Use UNIT_AURA instead.

Called when a buff or debuff is either applied to a unit or is removed from the player. (Further details to follow, study needed).

Also fired when you start eating and/or drinking (which really is only a buff being applied like any other).

Druid
This event is also called when a Druid changes form (or prowl state). arg1 - arg9 are all nil in this case. These args are probably nil for other classes as well. Also, this event is called multiple times per form change.


"PLAYER_CAMPING"
Category: Player
 

Fired when the player is camping

[]
"PLAYER_CONTROL_GAINED"
Category: Player,Combat
 

Fires after the PLAYER_CONTROL_LOST event, when control has been restored to the player.

"PLAYER_CONTROL_LOST"
Category: Player,Combat
 

Fires whenever the player is unable to control the character. Examples are when afflicted by fear, mind controlled, or when using a taxi.

[]
"PLAYER_DAMAGE_DONE_MODS"
Category: Misc
 


"PLAYER_DEAD"
Category: Death
 

Fired when the player has died.

"PLAYER_DIFFICULTY_CHANGED"
Category: Player,Raid
 

?

"PLAYER_ENTERING_BATTLEGROUND"
Category: Player
 

?

"PLAYER_ENTERING_WORLD"
Category: System,Player,Instance
 

Fired when the player enters the world, enters/leaves an instance, or respawns at a graveyard. Also fires any other time the player sees a loading screen.

To check if the player is entering an instance, check [[API_IsInInstance|IsInInstance].

Correction on the above comment: When PLAYER_ENTERING_WORLD fires, you'll notice that WORLD_MAP_UPDATE fires just before it. My instincts tell that leaving an instance puts the player in void space momentarily. So for the case that you are entering AND leaving an instance, GetPlayerMapPosition always returns the coordinates [0,0] and hence there is no way to determine using the event PLAYER_ENTERING_WORLD if the player is entering an instance or not. When leaving an instance the following events fire (ignoring party/raid events).

WORLD_MAP_UPDATE
PLAYER_ENTERING_WORLD
WORLD_MAP_UPDATE <--- Player coordinates are non-zero here

Instances do have coordinates for units once the second WORLD_MAP_UPDATE event has fired. For the case of entering a battleground such as WSG, WORLD_MAP_UPDATE won't fire until you leave Silverwing Hold or Warsong Lumber Mill and you are outside. --Salanex

[]
"PLAYER_ENTER_COMBAT"
Category: Combat
 

Fired when a player engages auto-attack. Note that firing a gun or a spell, or getting aggro, does NOT trigger this event.

From a post by Dhrago on the WoW forums:

PLAYER_ENTER_COMBAT and PLAYER_LEAVE_COMBAT are for *MELEE* combat only. They fire when you initiate autoattack and when you turn it off. However, any spell or ability that does not turn on autoattack does not trigger it. Nor does it trigger when you get aggro.
You probably want PLAYER_REGEN_DISABLED (happens when you get aggro) and PLAYER_REGEN_ENABLED (happens when you lose aggro).
"PLAYER_FARSIGHT_FOCUS_CHANGED"
Category: Player,Spell
 
"PLAYER_FLAGS_CHANGED"
Category: Player,Communication
 

This event fires when a Unit's flags change (eg: due to /afk, /dnd, etc.)

arg1
The UnitId affected, eg: "player"
NOTE
WoW appears to condense simultaneous flag changes into a single event. If you are currently AFK and not(DND) but you type /dnd you'll see two Chat Log messages ("You are no longer AFK" and "You are now DND: Do Not Disturb") but you'll only see a single PLAYER_FLAGS_CHANGED event.
"PLAYER_EQUIPMENT_CHANGED"
Category: Player
 
arg1
The item slot that changed.
arg2
If the changed slot is empty now.
"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_GAINS_VEHICLE_DATA"
Category: Player,Vehicle
 
"PLAYER_GUILD_UPDATE"
Category: Guild,Player
 

This appears to be fired when a player is gkicked, gquits, etc.

Reference handler in [DEPRECATED http://wowprogramming.com/utils/xmlbrowser/live/FrameXML/FriendsFrame.lua FriendsFrame.lua].


"PLAYER_LEAVE_COMBAT"
Category: Combat
 

Fired when the player leaves combat through death, defeat of opponents, or an ability. Does not fire if a player flees from combat on foot.


"PLAYER_LEAVING_WORLD"
Category: System
 

Fired when a player logs out and possibly at other situations as well


[]
"PLAYER_LEVEL_UP"
Category: Player
 

Fired when a player levels up.

arg1
New player level. Note that UnitLevel("player") will most likely return an incorrect value when called in this event handler or shortly after, so use this value.
arg2
Hit points gained from leveling.
arg3
Mana points gained from leveling.
arg4
Talent points gained from leveling. Should always be 1 unless the player is between levels 1 to 9.
arg5 - arg9
Attribute score increases from leveling. Strength (5) / Agility (6) / Stamina (7) / Intellect (8) / Spirit (9).


[]
"PLAYER_LOGIN"
Category: System
 

Triggered immediately before PLAYER_ENTERING_WORLD on login and UI Reload, but NOT when entering/leaving instances.

Note: Player skills such as those available through GetNumSkillLines() and relatives does not appear to be available when this event or PLAYER_ENTERING_WORLD fires during an actual player login from character-selection, as all the GetNumSkillLines()-function returns is 0 in those cases. When these events trigger from other reasons, such as zoning, the skill-related functions appear to work normally.


"PLAYER_LOGOUT"
Category: System
 

Sent when the player logs out or the UI is reloaded, just before SavedVariables are saved. The event fires after PLAYER_LEAVING_WORLD.

"PLAYER_LOSES_VEHICLE_DATA"
Category: Player,Vehicle
 

?

"PLAYER_MONEY"
Category: Player
 

Fired whenever the player gains or loses money.

To get the amount of money earned/lost, you'll need to save the return value from GetMoney() from the last time PLAYER_MONEY fired and compare it to the new return value from GetMoney().
Example
"PLAYER_PVP_KILLS_CHANGED"
Category: Player,Honor
 

Fired when you slay another player


"PLAYER_PVP_RANK_CHANGED"
Category: Honor
 
"PLAYER_QUITING"
Category: System
 

Fired when the player tries to quit, as opposed to logout, while outside an inn. This event does not indicate that the "player has quit", but instead that the "player has the quitting option".

The dialog which appears after this event, has choices of "Exit Now" or "Cancel". The dialog which appears when you try to logout outside an inn, only has a "Cancel" choice, and the event is not fired.

"PLAYER_ROLES_ASSIGNED"
Category: Instance
 

?

[]
"PLAYER_REGEN_DISABLED"
Category: Player,Combat
 

Fired whenever you enter combat, as normal regen rates are disabled during combat. This means that either you are in the hate list of a NPC or that you've been taking part in a pvp action (either as attacker or victim).


"PLAYER_REGEN_ENABLED"
Category: Player,Combat
 

Fired after ending combat, as regen rates return to normal. Useful for determining when a player has left combat. This occurs when you are not on the hate list of any NPC, or a few seconds after the latest pvp attack that you were involved with.


"PLAYER_SKINNED"
Category: Player,Battleground
 

Fired when the player's insignia is removed in a Battleground.


[]
"PLAYER_TALENT_UPDATE"
Category: Player
 

Fired when the player changes between dual talent specs, and possibly when learning or unlearning talents (?).

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

This event fires whenever a totem is dropped (cast) or destroyed (either recalled or killed).

arg1
The number of the totem slot (1-4) affected by the update. See for example GetTotemInfo() for the uses of the totem slot number.
"PLAYER_TRADE_MONEY"
Category: Trade
 

Fired when the player trades money


[]
"PLAYER_UNGHOST"
Category: Death
 

Fired when the player is alive after being a ghost. Called after one of:

  • Performing a successful corpse run and the player accepts the 'Resurrect Now' box.
  • Accepting a resurrect from another player after releasing from a death.
  • Zoning into an instance where the player is dead.
  • When the player accept a resurrect from a Spirit Healer.

The player is alive when this event happens. Does not fire when the player is resurrected before releasing. PLAYER_ALIVE is triggered in that case.


"PLAYER_UPDATE_RESTING"
Category: Player
 

Fired when the player starts or stops resting, i.e. when entering/leaving inns/major towns.


[]
"PLAYER_XP_UPDATE"
Category: Player
 

Fired when the player's XP is updated (due quest completion or killing).

arg1
The UnitId affected, eg: "player"


"PLAYERBANKBAGSLOTS_CHANGED"
Category: Bank
 


"PLAYERBANKSLOTS_CHANGED"
Category: Bank
 


"PLAYTIME_CHANGED"
Category: Player
 

Fired when the playtime state changes.

"PLAY_MOVIE"
Category: Misc
 
arg1
File name (without extension) & path, eg: "INTERFACE\CINEMATICS\WOW_FOTLK_1024"
arg2
Sound volume (0-150)
"PREVIEW_PET_TALENT_POINTS_CHANGED"
Category: Pet
 

?

"PREVIEW_TALENT_POINTS_CHANGED"
Category: Player
 

?

"PVPQUEUE_ANYWHERE_SHOW"
Category: Battleground
 

?

"PVPQUEUE_ANYWHERE_UPDATE_AVAILABLE"
Category: Battleground
 

?

Q[]

[]
"QUEST_ACCEPTED"
Category: Quest
 

This event fires whenever the player accepts a quest.

arg1
Quest log index. You may pass this to GetQuestLogTitle() for information about the accepted quest.
arg2
QuestID.
"QUEST_ACCEPT_CONFIRM"
Category: Quest
 

This event fires when an escort quest is started by another player. A dialog appears asking if the player also wants to start the quest.

arg1
Name of player who is starting escort quest.
arg2
Title of escort quest. Eg. "Protecting the Shipment"
"QUEST_COMPLETE"
Category: Quest
 

Fired after the player hits the "Continue" button in the quest-information page, before the "Complete Quest" button.

In other words it fires when you are given the option to complete a quest, but just before you actually complete the quest (as stated above).

"QUEST_TURNED_IN"
Category: Quest
 

Fired after the player hits the "Complete Quest" button in the quest-information page, when quest is recorded as done.

"QUEST_POI_UPDATE"
Category: Quest
 

Fired whenever Quest POIs change. For example after accepting an quest.

"QUEST_QUERY_COMPLETE"
Category: Quest
 

Fired when the data requested by QueryQuestsCompleted() is available.

[]
"QUEST_DETAIL"
Category: Quest
 

Fired when the player is given a more detailed view of his quest.


"QUEST_FINISHED"
Category: Quest
 

Fired whenever the quest frame changes (Detail to Progress to Reward, etc.) or is closed.

arg1
mousebutton (LeftButton)


"QUEST_GREETING"
Category: Quest
 

Fired when talking to an NPC that offers or accepts more than one quest, i.e. has more than one active or available quest.


[]
"QUEST_ITEM_UPDATE"
Category: Quest
 

Fired when the quest items are updated


"QUEST_LOG_UPDATE"
Category: Quest
 

This event is fired very often. This includes, but is not limited to: viewing a quest for the first time in a session in the Quest Log; (once for each quest?) every time the player changes zones across an instance boundary; every time the player picks up a non-grey item; every time after the player completes a quest goal, such as killing a mob for a quest. It also fires whenever the player (or addon using the CollapseQuestHeader or ExpandQuestHeader() functions) collapses or expands any zone header in the quest log.


"QUEST_PROGRESS"
Category: Quest
 

Fired when a player is talking to an NPC about the status of a quest and has not yet clicked the complete button.

"QUEST_WATCH_UPDATE"
Category: Quest
 

Fired just before a quest goal was completed. At this point the game client's quest data is not yet updated, but will be after a subsequent QUEST_LOG_UPDATE event.

arg1
questIndex (not watch index)

R[]

[]
"RAID_INSTANCE_WELCOME"
Category: Party
 

Fired when the player enters an instance that saves raid members after a boss is killed.

arg1
instance name
arg2
seconds until reset


"RAID_ROSTER_UPDATE"
Category: Party
 

REMOVED (5.0.4) - see: GROUP_ROSTER_UPDATE

Fired whenever a raid is formed or disbanded, players are leaving or joining a raid (unsure if rejected join requests also fire the event), or when looting rules are changed (regardless of being in raid or party!)


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

"RAISED_AS_GHOUL"
Category: Player
 

?

[]
"READY_CHECK"
Category: Party
 

New in 1.11. Fired when a Ready Check is performed by the raid (or party) leader.

arg1
name of character requesting ready check (ie., "Ansu")
arg2
variable number (usually 30). Denotes time before automatic check completion.
"READY_CHECK_CONFIRM"
Category: Party
 

Fired when a player confirms ready status.

arg1
UnitID (raid1, party1). Fires twice if the confirming player is in your raid sub-group.
arg2
status (1=ready, 0=not ready)
"READY_CHECK_FINISHED"
Category: Party
 

Fired when the ready check completes.

"RECEIVED_ACHIEVEMENT_LIST"
Category: Player,Achievements
 

Fired when the achievement data of the player is available.

"REPLACE_ENCHANT"
Category: Item
 

Fired when the player must confirm an enchantment replacement.

arg1
new enchantment
arg2
current enchantment


"RESURRECT_REQUEST"
Category: Death
 

Fired when another player resurrects you

arg1
player name
"RUNE_POWER_UPDATE"
Category: Player
 

New in 3.x. Fired when a rune's state switches from usable to un-usable or visa-versa.

arg1
the rune that it's referencing to
arg2
is the rune usable (if usable, it's not cooling, if not usable it's cooling)


"RUNE_TYPE_UPDATE"
Category: Player
 

New in 3.x. Fired when a rune's type is changed / updated.

arg1
the rune that it's referencing to

S[]

[]
"SCREENSHOT_FAILED"
Category: System
 

Fired when a screenshot fails.


"SCREENSHOT_SUCCEEDED"
Category: System
 

Fired when a screenshot is successfully taken.


"SEND_MAIL_COD_CHANGED"
Category: Mail
 


"SEND_MAIL_MONEY_CHANGED"
Category: Mail
 


"SKILL_LINES_CHANGED"
Category: Skill
 

Fired when:

  • Spellbook initially loads on client initialization. (Attempting to use GetSpellName before this is complete will result in a UI error. Note: This event happens after ADDON_LOADED and VARIABLES_LOADED.)
  • Learning new stuff that goes in the spellbook.
  • Opening the spellbook.
  • Equipping/Removing/Swapping primary weapon. (Changes the Attack icon)
  • UpdateSpells() function is called, which is used throughout the spellbook.
arg1
nil when the char learns stuff. Also when changing weapons and shapeshifting. In addition it seems to be called on regular intervals for no apparent reason.
  1. when the user opens the spellbook.
'LeftButton' when using the mouse to open the spellbook or to browse through the pages and tabs of the open spellbook.
"SOCKET_INFO_CLOSE"
Category: Misc
 

?

"SOCKET_INFO_UPDATE"
Category: Misc
 
"SOUND_DEVICE_UPDATE"
Category: System
 

?

"SPELLS_CHANGED"
Category: Spell
 
[]
"SPELL_UPDATE_COOLDOWN"
Category: Spell
 

This event is fired every three seconds for no apparent reason (correct as of patch 3.3.3). When a spell that has a cooldown is triggered it gets fired twice in quick succession and then again a few milliseconds later.


"SPELL_UPDATE_USABLE"
Category: Spell
 

This event is fired when a spell becomes useable or unusable. However the definition of useable and unusable is somewhat confusing. Firstly, range is not taken into account. Secondly if a spell requires a valid target and doesn't have one it gets marked as useable. If it requires mana or rage and there isn't enough then it gets marked as unusable. This results in the following behaviour:

Start) Feral druid in bear form out of combat, no target selected.

1) Target enemy. Event is fired as some spells that require rage become marked as unusable. On the action bar the spell is marked in red as unusable.

2) Use Enrage to gain rage. Event is fired as we now have enough rage. On the action bar the spell is marked unusable as out of range.

3) Move into range. Event is not fired. On the action bar the spell is marked usable.

4) Rage runs out. Event is fired as we no longer have enough rage.

5) Remove target. Event is fired and spell is marked as useable on action bar.

It appears that the definition of useable is a little inaccurate and relates more to how it is displayed on the action bar than whether you can use the spell. Also after being attacked the event started firing every two seconds and this continued until well after the attacker was dead. Targetting a fresh enemy seemed to stop it.


"START_AUTOREPEAT_SPELL"
Category: Spell
 


"START_LOOT_ROLL"
Category: Loot
 

Fired when a group loot item is being rolled on.

arg1
The rollID of the item being rolled on.
arg2
The roll time.
"START_MINIGAME"
Category: Misc
 

?

[]
"STOP_AUTOREPEAT_SPELL"
Category: Spell
 
Lua error in package.lua at line 80: module 'Module:Inlinegfx/img_link_data.json' not found. "STREAMING_ICON"
Category: System
 

Added in 4.0 for the Streaming Launcher

arg1
? (number in 0-2 range)
"SYNCHRONIZE_SETTINGS"
Category: System
 

?

"SYSMSG"
Category: Misc
 

Fired when a system message occurs. Gets displayed in the UI error frame (the default red text in the top half of the screen) in the default UI.

arg1
message
arg2
red
arg3
green
arg4
blue

| |}

T[]

[]
"TABARD_CANSAVE_CHANGED"
Category: Misc
 

Fired when it is possible to save a tabard.


"TABARD_SAVE_PENDING"
Category: Misc
 


"TAXIMAP_CLOSED"
Category: Misc
 

Fired when the taxi frame is closed.


"TAXIMAP_OPENED"
Category: Misc
 

Fired when the taxi viewer is opened. Note that this will fire even if you know no flight paths connected to the one you're at, so the map doesn't actually open.


[]
"TALENTS_INVOLUNTARILY_RESET"
Category: Player,Talents
 

?

"TIME_PLAYED_MSG"
Category: Player,System,Communication
 

Fired when the client received a time played message.

arg1
Total time played in minutes
arg2
Current time at this level in minutes


"TRACKED_ACHIEVEMENT_UPDATE"
Category: Achievements
 

Fired when a timed event for an achievement begins or ends. The achievement does not have to be actively tracked for this to trigger.

arg1
achievmentID
arg2
criteriaID
arg3
Actual time

, arg4 : Time limit


"TRADE_ACCEPT_UPDATE"
Category: Trade
 

Fired when the status of the player and target accept buttons has changed. Target agree status only shown when he has done it first. By this, player and target agree status is only shown together (arg1 == 1 and arg2 == 1), when player agreed after target.

arg1
Player has agreed to the trade (1) or not (0)
arg2
Target has agreed to the trade (1) or not (0)


"TRADE_CLOSED"
Category: Trade
 

Fired when the trade window is closed by the trade being accepted, or the player or target closes the window.

[]
"TRADE_CURRENCY_CHANGED"
Category: {{{2}}}
 

?

"TRADE_MONEY_CHANGED"
Category: Trade
 

Fired when the trade window's money value is changed.


"TRADE_PLAYER_ITEM_CHANGED"
Category: Trade
 

Fired when an item in the target's trade window is changed (items added or removed from trade). First call not fired when start trading by dropping item on target.

arg1
index of the trade slot changed
"TRADE_POTENTIAL_BIND_ENCHANT"
Category: Trade
 

?

"TRADE_REPLACE_ENCHANT"
Category: Trade
 

Fired when the player must confirm an enchantment replacement in the trade window.

arg1
new enchantment
arg2
current enchantment


[]
"TRADE_REQUEST"
Category: Trade
 

It appears that this event was removed from the game. It was once used to ask you if you wanted to accept or reject a trade. It no longer triggers, not even when "Block Trades" is enabled.

Fired when another player wishes to trade with you.

arg1
player name


"TRADE_REQUEST_CANCEL"
Category: Trade
 

Fired when a trade attempt is cancelled. Fired after TRADE_CLOSE when aborted by player, before TRADE_CLOSE when done by target.

Upon a trade being cancelled (as in, either part clicking the cancel button), TRADE_CLOSE is fired twice, and then TRADE_REQUEST_CANCEL once.

[]
"TRADE_SHOW"
Category: Trade
 

Fired when the Trade window appears after a trade request has been accepted or auto-accepted

"TRADE_SKILL_FILTER_UPDATE"
Category: Tradeskill
 

?

"TRADE_SKILL_CLOSE"
Category: Tradeskill
 

Fired when a trade skill window is closed.


"TRADE_SKILL_SHOW"
Category: Tradeskill
 

Fired when a trade skill window is opened.


[]
"TRADE_SKILL_UPDATE"
Category: Tradeskill
 

Fired immediately after TRADE_SKILL_SHOW, after something is created via tradeskill, or anytime the tradeskill window is updated (filtered, tree folded/unfolded, etc.)


"TRADE_TARGET_ITEM_CHANGED"
Category: Trade
 

Fired when an item in the target's trade window is changed (items added or removed from trade).

arg1
index of the trade slot changed


"TRADE_UPDATE"
Category: Trade
 

Fired when the trade window is changed.


[]
"TRAINER_CLOSED"
Category: Trainer
 

Fired when the trainer is closed.

"TRAINER_DESCRIPTION_UPDATE"
Category: Trainer
 

?

"TRAINER_SHOW"
Category: Trainer
 

Fired when the class trainer frame is shown.

"TRAINER_UPDATE"
Category: Trainer
 

Fired when the trainer window needs to update.


"TUTORIAL_TRIGGER"
Category: Misc
 

Fired when the tutorial/tips are shown. Will not fire if tutorials are turned off.

U[]

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


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


[]
Lua error in package.lua at line 80: module 'Module:Inlinegfx/img_link_data.json' not found. "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
Lua error in package.lua at line 80: module 'Module:Inlinegfx/img_link_data.json' not found. "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
Lua error in package.lua at line 80: module 'Module:Inlinegfx/img_link_data.json' not found. "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_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
 


[]
"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
 


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

[]
"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
 
[]
"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
 

V[]

"VARIABLES_LOADED"
Category: System
 

Fired in response to the CVars, Keybindings and other associated "Blizzard" variables being loaded. Since key bindings and macros in particular may be stored on the server they event may be delayed a bit beyond the original loading sequence.

Previously (prior to 3.0.1) the VARIABLES_LOADED event was part of the loading sequence. Although it still occurs within the same general timeframe as the other events, it no longer has a guaranteed order that can be relied on. This may be problematic to addons that relied on the order of VARIABLES_LOADED, specifically that it would fire before PLAYER_ENTERING_WORLD.

Addons should not use this event to check if their addon's saved variables have loaded. They can use ADDON_LOADED (testing for arg1 being the name of the addon) or another appropriate event to initialize, ensuring that the addon works when loaded on demand.

"VEHICLE_ANGLE_SHOW"
Category: Vehicle
 

?

"VEHICLE_ANGLE_UPDATE"
Category: Vehicle
 

?

"VEHICLE_PASSENGERS_CHANGED"
Category: Vehicle
 

?

"VEHICLE_POWER_SHOW"
Category: Vehicle
 

?

"VEHICLE_UPDATE"
Category: Vehicle
 

?

"VOICE_CHANNEL_STATUS_UPDATE"
Category: Voice
 

?

"VOICE_CHAT_ENABLED_UPDATE"
Category: Misc
 

Fired when you enable or disable voice chat.

"VOICE_LEFT_SESSION"
Category: Misc
 


"VOICE_PLATE_START"
Category: Voice
 

?

"VOICE_PLATE_STOP"
Category: Voice
 

?

"VOICE_PUSH_TO_TALK_START"
Category: Misc
 

Fired when you click the Push-To-Talk hotkey to activate voice chat

"VOICE_PUSH_TO_TALK_STOP"
Category: Misc
 

Fired when you release the Push-To-Talk hotkey

"VOICE_SELF_MUTE"
Category: Voice
 

?

"VOICE_SESSIONS_UPDATE"
Category: Misc
 
"VOICE_START"
Category: Misc
 

Fired when someone starts using Voice Chat

arg1
The UnitId of the person who started talking
"VOICE_STATUS_UPDATE"
Category: Misc
 

Fired when someone in your group or raid updates their voice status. Triggers extremely frequently.

"VOICE_STOP"
Category: Misc
 

Fired when someone stops using Voice Chat

arg1
The UnitId of the person who stopped talking
"VOTE_KICK_REASON_NEEDED"
Category: Looking for Group
 

Fires when you need to supply a reason for the kick vote you wish to initiate. Use UninviteUnit("name", "reason") to provide the reason.

arg1
String - name of the player you wanted to initiate a kick vote for.

| |}

W[]

"WEAR_EQUIPMENT_SET"
Category: Player,Item
 

?

"WHO_LIST_UPDATE"
Category: Communication
 

Fired when the client receives the result of a SendWho() request from the server. use API SetWhoToUI to manipulate this functionality. This event is only triggered if the Who panel was open at the time the Who data was received (this includes the case where the Blizzard UI opens it automatically because the return data was too big to display in the chat frame).


"WORLD_MAP_NAME_UPDATE"
Category: Map
 
"WORLD_MAP_UPDATE"
Category: Map
 

Fired when the world map should be updated.

When entering a battleground, this event won't fire until the zone is changed (i.e. in WSG when you walk outside of Warsong Lumber Mill or Silverwing Hold --Salanex

"WORLD_STATE_UI_TIMER_UPDATE"
Category: Misc
 

?

"WOW_MOUSE_NOT_FOUND"
Category: Misc
 

Possibly fired after failing to DetectWowMouse().

X[]

No events beginning with the letter X.

Y[]

No events beginning with the letter Y.

Z[]

"ZONE_CHANGED"
Category: Map
 

Fired when the player enters a new zone in which the player is not indoors see also ZONE_CHANGED_INDOORS. Zones are the smallest named subdivions of the game world and are contained within areas (also called regions). Whenever the text over the minimap changes, either this event is fired or ZONE_CHANGED_INDOORS or ZONE_CHANGED_NEW_AREA


"ZONE_CHANGED_INDOORS"
Category: Map
 

Fired when a player enters a new zone and enters a location which is inside (Instances appear to be counted as indoors) See also ZONE_CHANGED or ZONE_CHANGED_NEW_AREA as mutually exclusive events For coding it would be advisable to register for all three events

"ZONE_CHANGED_NEW_AREA"
Category: Map
 

Fired when the user enters a new zone and a new area. e.g. moving from Duskwood to Stranglethorn Vale. In interface terms, this is anytime you get a new set of channels. The ZONE_CHANGED events are mutually exclusive!

Note: When this event fires, the UI may still think you're in the zone you just left. Don't depend on GetRealZoneText() and similar functions to report the new zone in reaction to ZONE_CHANGED_NEW_AREA. (untested for similar events)

Advertisement