Events A-Z (full list)

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

arg1 

The id of the achievement gained.

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.

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.

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

no arguments

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.

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

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

Fired when something in the actionbar or your inventory becomes usable (after eating or drinking a potion, or entering/leaving stealth; for example).

no arguments

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

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.

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

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.

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

This event is fired when the auction interface is closed.

Note

It appears to fire twice, but the reason is unknown.

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

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

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

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

Fired when the player ceases following an ally

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

arg1 

container ID

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

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

Fired when a cooldown update call is sent to a bag

arg1 

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

Fired twice when the bank window is closed.

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

Fired when the bank frame is opened

Fired when the battlegrounds signup window is closed.

Fired when the battlegrounds signup window is opened.

Fired when Enchanting an unbound item.

Fired when the calendar API is busy or free

arg1 

busyFlag

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

Fired when the calendar has received information about pending event invitations.

Fired after CalendarEventSortInvites once the invite list has been sorted.

Fired when a player cancels a roll on an item

arg1 

rollID

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

Fired when user changes selected channel in Blizzards ChannelFrame

arg1 

channel id (item number in Blizzards ChannelFrame -> quod vide API GetChannelDisplayInfo)

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

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

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

arg1 

unknown

arg2 

unknown

arg3 

unknown

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)

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.

(new with patch 1.12)

Fired when the client receives a message from SendAddonMessage

arg1 

prefix

arg2 

message

arg3 

distribution type ("PARTY", "RAID", "GUILD", "BATTLEGROUND" or "WHISPER")

arg4 

sender

Fired when the client receives an AFK auto-response

arg1 

AFK response message

arg2 

author

(new with patch 1.12)

Fired when a message is received through the battleground group channel

arg1 

chat message

arg2 

author

arg3 

language

(new with patch 1.12)

Fired when a message is received from the leader of the battleground group

arg1 

chat message

arg2 

author

arg3 

language

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

arg1 

Battleground Message (eg. "The Alliance has taken the Blacksmith!")

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

arg1 

Battleground Message (eg. "The Horde has taken the Blacksmith!")

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

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

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)

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

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"

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

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

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a creature hits another creature. Note that this can fire for players if the server is out of sync.

arg1 

chat message

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a creature misses another creature. Note that this can fire for players if the server is out of sync.

arg1 

chat message

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a creature hits a party member

arg1 

chat message

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a creature misses a party member

arg1 

chat message

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a creature hits you or your pet

arg1 

chat message

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a creature misses you or your pet

arg1 

chat message

Replaced in 2.4.0 with COMBAT_LOG_EVENT

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

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a friendly player dies

arg1 

chat message (format: "%s dies")

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

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

If you provide the killing blow, you may or may not get a 'unit dies' event but you will get a 'slain unit' event, the 'slain unit' event is fired before the 'unit dies' message is, if you do not provide the killing blow you will get a 'unit dies'.

Fired when any hostile NPC or player dies near you.

arg1 

Message (eg: "Snowshow Rabbit dies." )

Fired when you are the killing blow against any NPC or player

arg1 

Message (eg: "You have slain Snowshow Rabbit!")

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)

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a you hit a creature. Also called when you hurt yourself by falling, drowning or burning on a campfire.

arg1 

chat message

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a you miss a creature

arg1 

chat message

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

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

arg1 

DND response message

arg2 

author

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

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

Fired when a guild member 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, arg11 

Some integer that (but not the achievement ID, or the total number of achievement points for the player; this seems to increment if two consecutive achievements are posted (needs to be verified)).

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

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

Fired when a unit loots money.

arg1 

Chat message

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)

Fired when a NPC says something.

arg1 

Message

arg2 

NPC name

arg3 

Language used

Fired when a NPC whispers you something

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)

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

arg1 

Message that was received

arg2 

Author

arg3 

Language used

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

arg1 

Message that was received

arg2 

Author

arg3 

Language used

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

arg1 

chat message

arg2 

author

arg3 

language

arg1 

emote message

arg2 

Name of the boss

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

arg1 

chat message

arg2 

author

arg3 

language

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

arg1 

chat message

arg2 

author

arg3 

language

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

arg1 

chat message

arg2 

author

arg3 

language

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.

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

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired whenever a buff or debuff wears off of a mob, npc, or another player. Does not fire for party members. Examples: Thorns, Trueshot Aura, Recently Bandaged. arg1 is the full chat text, i.e. "Thorns fades from Someguy."

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired whenever a buff or debuff wears off - examples, Prowl, Mark of the Wild, Cat Form, or Disarm. arg1 is the full chat text, i.e. "Prowl fades from you."

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a mob begins casting a beneficial spell and again when the casting is completed. arg1 is the full combat chat text. Examples: Mob begins to cast Heal. Mob's Heal heals Mob for 20.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a creature begins to cast a damage spell or when a creature casts a damage spell on a raid member who is not in your group. Also triggered when a pet is damaged by a creature's spell.

Ex: Ragnaros' Wrath of Ragnaros hits PlayerName for 1000.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a mob completes casting a harmful spell on you. (The message for the mob beginning to cast is given by CHAT_MSG_SPELL_CREATURE_VS_CREATURE_DAMAGE.)

arg1

full combat chat text and includes results of the cast or skill use (e.g. hit, resist, dodge).

Examples:

Mob's Poison hits you for 10.

Mob's Melee Special was dodged.

Mob's Nuke was resisted.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a buff (or possibly item) damages an opponent in response to an action... IE Thorns.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when you fail to successfully cast a spell, for one of several reasons. arg1 is the full combat chat text and includes the reason. Examples: You fail to cast Heal: Interrupted. You fail to perform Bear Form: Not enough mana.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a non-hostile player begins casting a spell or using a skill.

arg1

the full combat chat text.

Some examples:

Someguy casts Reinforced Armor +40 on Someguys's Pants.

Someguy begins to cast Elixir of Whatever.

Someguy begins to cast Conjure Food.

Someguy begins to cast Summon Felsteed.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired on multiple silly occasions.

arg1; the full combat log text

Example:

Runaway 's Flash of Light heals you for 1350.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Discovered a bug with this event as of v1.8. You can use CHAT_MSG_FRIENDLYPLAYER_DAMAGE to check for "Bob begins to cast Firebolt." However, if Bob joins your party, it does not show up in CHAT_MSG_SPELL_PARTY_DAMAGE as one would expect. It shows up in CHAT_MSG_SPELL_HOSTILEPLAYER_DAMAGE. This seems to only be the case for "begins to cast". Other damage messages properly show up under CHAT_MSG_SPELL_PARTY_DAMAGE.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a mob gains an "insta-cast" beneficial effect. arg1 is the full combat chat text. Examples: Mob gains Defensive Stance. Mob gains Rushing Charge. Mob gains Demon Skin.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Example:

Highland Strider suffers 8 Fire damage from your Fireball.

Also records other people's DoT's, whether you are grouped or not, in combat or not.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a non-hostile player gains a "buff" effect.

arg1

the full combat chat text.

Examples:

Someguy gains Arcane Intellect.

Someguy gains Aspect of the Pack.

Someguy gains Felsteed.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

For some weird reason, this event is fired when someone heals yourself or another player, eg "Priest's Flash Heal critically heals you for 2342"

Haven't tested any other conditions as of yet.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Indicates afflictions on players which are classified as hostile to the player. Covers ability types such as rend, polymorph, sap etc.

arg1 - full combat text

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Example:

Awauna gains Power Word: Shield.

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when a buff is cast on self. (Unknown if external buff triggers this).

arg1

full combat text

Example:

"You gain BuffName."

Also called for each "tick" of recurring effects, such as "heal-over-time" spells. Example: You gain 10 health from Rejuvenation. --Syllani

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired (possibly among other times) when you are debuffed - so Disarm, Silenced, etc. I know the name doesn't match, but if you want to verify, enable printing this in your chat log. Get into combat and get debuffed. After combat, scroll back up, and while the debuff message is onscreen, change the chat color of this message, and you will see it change... Very strange. I assume this is named after poisons or diseases, but I haven't actually tested if those trigger this. See CHAT_MSG_SPELL_AURA_GONE_SELF if you want to know when it wears off (both buffs and debuffs). This is accurate as of US Release 1.2.4 (4222), tested by hacking Scrolling Combat Text.

arg1

full text of the debuff message, e.g. "You are Disarmed."

This is also fired during the Gnomish Death Ray's channel.

This is indeed triggered by poison / disease. arg1 messages in the form of: "You suffer 3 damage from Scorpid's Poison" or "You are afflicted by Something" come from this event. --Syllani

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired when you cast a beneficial spell. arg1 is the full combat chat text. Examples: Your Heal heals you for 50. Your Regrowth critically heals Someguy for 100.

UnitHealth(...) is not updated when this event occours, it is possible to determine the exact overheal with something like this: Overheal = HealFromCombatChat - (UnitHealthMax(...) - UnitHealth(...));

Replaced in 2.4.0 with COMBAT_LOG_EVENT

Fired whenever you cast a harmful spell, be it direct damage or debuff of any kind, be it Warrior's taunt or DoT. arg1 holds the exact same string that is posted to the Combat Log. (eg. "Your Fireball hits Snivvle for 842.")

Also fired when your spell does not actually take effect; ie. if it is resisted, or if the target is immune. A "resist" message is "Your Banish was resisted by Felguard Elite." while an "immune" message is of the format "Your Fire Blast failed. Firelord is immune."

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.

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

arg1

Emote Message

arg2

Name of person who emoted

Fired when a whisper is received from another player.

The rest of the arguments appear to be nil

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)

Fired when the player sends a whisper to another player

arg1 

Message sent

arg2 

Player who was sent the whisper

arg3 

Language

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

arg1 

Message that was received

arg2 

Author

arg3 

Language used

Fired when the tooltip needs to be wiped

Fired when the guild dress frame is closed

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.

New in 2.4.0

See API COMBAT LOG EVENT for more information. This event fires only if it matches current global combat log filter settings.

(New in 2.4.0)

See API COMBAT LOG EVENT for more information. AddOns wanting to parse all events the moment they happen should register for this event.

(See blue posting http://forums.worldofwarcraft.com/thread.html?topicId=2968233433&sid=1&pageNo=9#177 for more info)

(new with 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

(New with patch 3.0)

(New with patch 3.0)

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 also fires when anyone around you updates a companion, and by proxy, when a person comes into your detectable range mounted (since the UI does not know if the person is mounted when they are outside). If you are in a major city, expect this event to fire constantly.

Appears in Patch 2.2 PTR. Apparently signals that a player has started speaking using Voice Chat.

arg1 

The UnitId (eg. "player", "party1", etc) of the player that started the voice chat.

Appears in Patch 2.2 PTR. Supposidly indicates that a player has stopped speaking using Voice Chat.

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.

Fired when the player is in range of his body.

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

Fired when a crafting skill window closes. Crafting skills are Enchanting, <craftSkill2>,...

arg1 

The mouse button used to close the window.

(since at least 3.1, seems obsolete. use TRADE_SKILL_CLOSE instead)

Fired when a crafting skill window opens. Crafting skills are Enchanting, <craftSkill2>,...

arg1 

The mouse button used to open the window.

(since at least 3.1, seems obsolete. use TRADE_SKILL_SHOW instead)

Fired when a crafting event is updating.

(since at least 3.1, seems obsolete. use TRADE_SKILL_UPDATE instead)

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

Fired when the spell being cast is changed.

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.

Fired when a CVar is changed

arg1 

cvarname

arg2 

value

Fired when the player attempts to destroy an item.

arg1 

item name

Fired when a duel is finished.

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

Fired when the player leaves the bounds of the duel

Fired when the player is challenged to a duel

arg1 

opponent name

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

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

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.

Fired when the chat line needs to be processed.

arg1 

Chat line

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.

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)

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

Fired when the guild-bank contents change

Fired when the guild-bank frame is closed

Fired when the guild-bank frame is opened

Fired when the guild-bank log is updated.

Fired when the guild invitation is declined.

Fired when you are invited to join a guild.

arg1 

guild inviter

arg2 

guild name

Fired when the guild messages of the day is shown.

arg1 

guild message of the day

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

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

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

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

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.

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

Fired when an items text begins displaying

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

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

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

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

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

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

Fired when a player ceases looting a corpse.

Fired when a corpse is looted

arg1

1 if autolooting, otherwise 0 (not nil!)

Fired when loot is removed from a corpse.

arg1

Slot number

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

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

Fired when the mailbox window is closed.

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

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

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?

Fired when the mailbox is first opened.

arg1 

returns "up"

Fired when all memory allocated to the UI is exhausted.

arg1

Current memory limit (in MB).

Note: This event no longer fires. The client no longer uses a fixed memory limit.

Fired when WoW recovers from an out of memory error.

Note: This event no longer fires. The client no longer uses a fixed memory limit.

Fired when a merchant frame closes. (Called twice)

arg1

button used to close the window)

Fired when the merchant frame is shown.

Fired when a merchant updates

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

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.

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

(this event doesn't seem to be used anymore since 2.4, use ZONE_CHANGED and ZONE_CHANGED_INDOORS)

Fired whenever the text above the Minimap changes, i.e. each time the player changes the area or the zone in the current area. The main difference to the ZONE_CHANGED event is that at the time the MINIMAP_ZONE_CHANGED event is fired, the GetRealZoneText(), GetSubZoneText() and GetMinimapZoneText() do already return the information for the new zone.

Fired when the mirror timer is paused.

arg1 

pause duration

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

Fired when a mirror timer is stopped.

arg1 

timer ( for ex. "BREATH" )

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

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

Fired when the guild dress frame is opened.

Fired when you decline a party invite.

Fired when a player invite you to party.

arg1 

team leader name

Fired when the player's leadership changed.

Referred to as buggy.

Fired when the party's loot method changes

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.

Fired when a specific party member is offline or dead

arg1 

Player Name

Fired when a specific party member is still connected

arg1 

Player Name

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

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.

Fired when the player's pet begins attacking.

Fired when the player's pet ceases attack

Fired when pet spells are dropped into the PetActionBar.

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

arg1

MouseButton used (e.g. "LeftButton","RightButton")

Fired when the pet bar is updates.

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