Events |
From WoWDev
Intro
This is a full list of events compiled on one page. It is aimed at simplifying event finding using the find feature on you browser, looking for a particular word or result. If you know the name of the event and want to know what it returns it might be more useful to use the indexed pages which are simpler to glance at, will load faster and will save the wiki bandwidth.
Remember: If you update an event listing here, make sure you update the mirror on the indexed pages and visa versa.
Events A-B
ACTIONBAR_HIDEGRID
Fired when the actionbar numbers disappear, typically when you finish dragging something to the actionbar
no arguments
ACTIONBAR_PAGE_CHANGED
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"
ACTIONBAR_SHOWGRID
Fired when the actionbar numbers appear, typically when you drag a spell to the actionbar.
- arg1
- the mouse button used to drag the spell. Known values: "LeftButton", "RightButton"
ACTIONBAR_SLOT_CHANGED
Fired when any actionbar slot's contents change.
- arg1
- the number of the slot that changed
ACTIONBAR_UPDATE_COOLDOWN
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
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
Fired when something in the actionbar or your inventory becomes usable again (after eating or drinking a potion, for example).
no arguments
AREA_SPIRIT_HEALER_IN_RANGE
AREA_SPIRIT_HEALER_OUT_OF_RANGE
ADDON_LOADED
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 that Saved Variables of the AddOn that just finished loading have been loaded from the disk.
- arg1
- name of the AddOn that was just loaded
AUCTION_BIDDER_LIST_UPDATE
AUCTION_HOUSE_CLOSED
AUCTION_HOUSE_SHOW
AUCTION_ITEM_LIST_UPDATE
AUCTION_OWNED_LIST_UPDATE
AUTOEQUIP_BIND_CONFIRM
Fired when the game attempts to autobind bind-on-equip items.
AUTOFOLLOW_BEGIN
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
Fired when the player ceases following an ally
BAG_CLOSED
Fired when a bag is closed
- arg1
- container ID
BAG_OPEN
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
Fired when a bags inventory changes
- arg1
- container ID
BAG_UPDATE_COOLDOWN
Fired when a cooldown update call is sent to a bag
- arg1
- container ID
BANKFRAME_CLOSED
Fired when the bank window is closed
BANKFRAME_OPENED
Fired when the bank frame is opened
BATTLEFIELDS_CLOSED
BATTLEFIELDS_SHOW
BILLING_NAG_DIALOG
BIND_ENCHANT
Fired when Enchanting an unbound item.
Events C
CANCEL_LOOT_ROLL
CHARACTER_LIST_UPDATE
CHARACTER_POINTS_CHANGED
Fired when the player's character points are changed.
CHAT_MSG
Fired when the client recieves a chat message.
- arg4
- channel length
CHAT_MSG_AFK
Fired when the client receives an AFK auto-response
- arg1
- AFK response message
- arg2
- author
CHAT_MSG_BG_SYSTEM_ALLIANCE
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
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
Fired for non faction specific events in the battlegrounds such as the battle start announcement.
CHAT_MSG_CHANNEL
Fired when the client recieves a channel message.
- arg1
- chat message
- arg2
- author
- arg3
- language
- arg4
- channel name with number ex: "5. 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 genaric system channels (General, Trade, LookingForGroup and LocalDefense)
- 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
- zone is always current zone even if not the same as the channel name
CHAT_MSG_CHANNEL_JOIN
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
CHAT_MSG_CHANNEL_LEAVE
CHAT_MSG_CHANNEL_LIST
CHAT_MSG_CHANNEL_NOTICE
CHAT_MSG_CHANNEL_NOTICE_USER
CHAT_MSG_COMBAT_CREATURE_VS_CREATURE_HITS
Fired when a creature hits another creature
- arg1
- chat message
CHAT_MSG_COMBAT_CREATURE_VS_CREATURE_MISSES
Fired when a creature misses another creature
- arg1
- chat message
CHAT_MSG_COMBAT_CREATURE_VS_PARTY_HITS
Fired when a creature hits a party member
- arg1
- chat message
CHAT_MSG_COMBAT_CREATURE_VS_PARTY_MISSES
Fired when a creature misses a party memeber
- arg1
- chat message
CHAT_MSG_COMBAT_CREATURE_VS_SELF_HITS
Fired when a creature hits you
- arg1
- chat message
CHAT_MSG_COMBAT_CREATURE_VS_SELF_MISSES
Fired when a creature misses you
- arg1
- chat message
CHAT_MSG_COMBAT_ERROR
CHAT_MSG_COMBAT_FRIENDLYPLAYER_HITS
CHAT_MSG_COMBAT_FRIENDLYPLAYER_MISSES
CHAT_MSG_COMBAT_FRIENDLY_DEATH
CHAT_MSG_COMBAT_HONOR_GAIN
Fired when you successfully kill a worthy pvp opponent
- arg1
- chat message (format: "%s dies, honorable kill Rank: %s (Estimated Honor Points: %d)")
CHAT_MSG_COMBAT_HOSTILEPLAYER_HITS
CHAT_MSG_COMBAT_HOSTILEPLAYER_MISSES
CHAT_MSG_COMBAT_HOSTILE_DEATH
Fired when any hostile (NPC or player) dies near you.
- arg1
- complete text from combat-log (e.g. "Snowshoe Rabbit dies.")
CHAT_MSG_COMBAT_MISC_INFO
Fired when you gain reputation from killing a creature or finishing a quest.
CHAT_MSG_COMBAT_PARTY_HITS
CHAT_MSG_COMBAT_PARTY_MISSES
CHAT_MSG_COMBAT_PET_HITS
CHAT_MSG_COMBAT_PET_MISSES
CHAT_MSG_COMBAT_SELF_HITS
Fired when a you hit a creature. Also called when you hurt yourself by falling, drowning or burning on a campfire.
- arg1
- localized chat message
CHAT_MSG_COMBAT_SELF_MISSES
Fired when a you miss a creature
- arg1
- chat message
CHAT_MSG_COMBAT_XP_GAIN
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
Fired when the client receives a Do-Not-Disturb auto-response
- arg1
- DND response message
- arg2
- author
CHAT_MSG_EMOTE
Fired on sending or revicing 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.
CHAT_MSG_GUILD
Fired when a message is sent or received in the Guild channel.
event: CHAT_MSG_GUILD
arg1: Message that was sent/received.
arg2: Name of the player who sent the message.
arg3: Language the message was spoken in.
(See CHAT_MSG_SAY for example code)
CHAT_MSG_IGNORED
CHAT_MSG_LOOT
Fired when a unit loots an item.
event: CHAT_MSG_LOOT
arg1: Message that was sent/received.
CHAT_MSG_MONSTER_EMOTE
CHAT_MSG_MONSTER_SAY
CHAT_MSG_MONSTER_WHISPER
CHAT_MSG_MONSTER_YELL
arg1: Text of message.
CHAT_MSG_OFFICER
Fired when a message is sent or received in the Guild Officer channel.
event: CHAT_MSG_OFFICER
arg1: Message that was sent/received.
arg2: Name of the player who sent the message.
arg3: Language the message was spoken in.
(See CHAT_MSG_SAY for example code)
CHAT_MSG_PARTY
Fired when a message is sent or received in the Party channel.
event: CHAT_MSG_PARTY
arg1: Message that was sent/received.
arg2: Name of the player who sent the message.
arg3: Language the message was spoken in.
(See CHAT_MSG_SAY for example code)
CHAT_MSG_RAID
CHAT_MSG_SAY
Fired when a message is sent or received in the Say channel.
- arg1
- chat message
- arg2
- author
- arg3
- language
- arg4
- channel name with number
- arg5
- unknown (empty string)
- arg6
- unknown (empty string)
- arg7
- unknown (appears to be channel number)
- arg8
- channel number ("0")
- arg9
- channel name without number
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
CHAT_MSG_SPELL_AURA_GONE_OTHER
Fired whenever a buff or debuff wears off of a mob, npc, or another player. Examples: Thorns, Trueshot Aura, Recently Bandaged. arg1 is the full chat text, i.e. "Thorns fades from Someguy."
CHAT_MSG_SPELL_AURA_GONE_SELF
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."
CHAT_MSG_SPELL_BREAK_AURA
CHAT_MSG_SPELL_CREATURE_VS_CREATURE_BUFF
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.
CHAT_MSG_SPELL_CREATURE_VS_CREATURE_DAMAGE
Fired 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.
CHAT_MSG_SPELL_CREATURE_VS_PARTY_BUFF
CHAT_MSG_SPELL_CREATURE_VS_PARTY_DAMAGE
CHAT_MSG_SPELL_CREATURE_VS_SELF_BUFF
CHAT_MSG_SPELL_CREATURE_VS_SELF_DAMAGE
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 is the 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.
CHAT_MSG_SPELL_DAMAGESHIELDS_ON_OTHERS
CHAT_MSG_SPELL_DAMAGESHIELDS_ON_SELF
Fired when a buff (or possibly item) damages an opponent in response to an action... IE Thorns.
CHAT_MSG_SPELL_FAILED_LOCALPLAYER
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.
CHAT_MSG_SPELL_FRIENDLYPLAYER_BUFF
Fired when a non-hostile player begins casting a spell or using a skill. arg1 is 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.
CHAT_MSG_SPELL_FRIENDLYPLAYER_DAMAGE
CHAT_MSG_SPELL_HOSTILEPLAYER_BUFF
CHAT_MSG_SPELL_HOSTILEPLAYER_DAMAGE
CHAT_MSG_SPELL_ITEM_ENCHANTMENTS
CHAT_MSG_SPELL_PARTY_BUFF
CHAT_MSG_SPELL_PARTY_DAMAGE
CHAT_MSG_SPELL_PERIODIC_CREATURE_BUFFS
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.
CHAT_MSG_SPELL_PERIODIC_CREATURE_DAMAGE
example: "Highland Strider suffers 8 Fire damage from your Fireball."
CHAT_MSG_SPELL_PERIODIC_FRIENDLYPLAYER_BUFFS
Fired when a non-hostile player gains a "buff" effect. arg1 is the full combat chat text. Some examples: Someguy gains Arcane Intellect. Someguy gains Aspect of the Pack. Someguy gains Felsteed.
CHAT_MSG_SPELL_PERIODIC_FRIENDLYPLAYER_DAMAGE
CHAT_MSG_SPELL_PERIODIC_HOSTILEPLAYER_BUFFS
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.
CHAT_MSG_SPELL_PERIODIC_HOSTILEPLAYER_DAMAGE
CHAT_MSG_SPELL_PERIODIC_PARTY_BUFFS
CHAT_MSG_SPELL_PERIODIC_PARTY_DAMAGE
CHAT_MSG_SPELL_PERIODIC_SELF_BUFFS
Fired when a buff is cast on self. (Unknown if external buff triggers this). Arg 1 is "You gain $foo" Where $foo is the name of the buff.
Also called for each "tick" of recurring effects, such as "heal-over-time" spells. Example: You gain 10 health from Rejuvenation. --Syllani
CHAT_MSG_SPELL_PERIODIC_SELF_DAMAGE
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 is the 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
CHAT_MSG_SPELL_PET_BUFF
CHAT_MSG_SPELL_PET_DAMAGE
CHAT_MSG_SPELL_SELF_BUFF
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.
CHAT_MSG_SPELL_SELF_DAMAGE
Fired whenever you cast a damage-dealing spell. arg1 holds the exact same string that is posted to the Battle Log (Something like "SpellXY hits EnemyPQ with 42 damage")
CHAT_MSG_SPELL_TRADESKILLS
CHAT_MSG_SYSTEM
Fired when a system message is received. ie. You're AFK
CHAT_MSG_TEXT_EMOTE
Fired for emotes with an emote token. /dance, /healme, etc
Arg1 = Emote Message
Arg2 = Name of person who emoted
CHAT_MSG_WHISPER
Fired when a whisper is received from another player.
Arg1 = text sent.
Arg2 = player who sent whisper.
CHAT_MSG_WHISPER_INFORM
Fired when a whisper is sent to another player.
Arg1 = text sent.
Arg2 = player whisper sent to.
Arg3 = Language message was sent in (even though the other player, if of the same faction, can read the message regardless, and doesn't even see what language you sent it in).
CHAT_MSG_YELL
Fired when a message is sent or received in the Yell channel.
event: CHAT_MSG_YELL
arg1: Message that was sent/received.
arg2: Name of the player who sent the message.
arg3: Language the message was spoken in.
(See CHAT_MSG_SAY for example code)
CINEMATIC_START
CINEMATIC_STOP
CLEAR_TOOLTIP
Fired when the tooltip needs to be wiped
CLOSE_INBOX_ITEM
CLOSE_TABARD_FRAME
Fired when the guild dress frame is closed
CLOSE_WORLD_MAP
Fired when the world map is hidden.
CONFIRM_BINDER
CONFIRM_LOOT_ROLL
CONFIRM_PET_UNLEARN
CONFIRM_SUMMON
CONFIRM_TALENT_WIPE
CONFIRM_XP_LOSS
loss in exchange for his body back.
CORPSE_IN_INSTANCE
CORPSE_IN_RANGE
Fired when the player is in range of his body.
CORPSE_OUT_OF_RANGE
Fired when the player is out of range of his body.
CRAFT_CLOSE
Fired when a crafting skill window closes. Crafting skills are Enchanting, <craftSkill2>,...
- arg1
- The mouse button used to close the window.
CRAFT_SHOW
Fired when a crafting skill window opens. Crafting skills are Enchanting, <craftSkill2>,...
- arg1
- The mouse button used to open the window.
CRAFT_UPDATE
Fired when a crafting event is updating.
CURRENT_SPELL_CAST_CHANGED
Fired when the spell being cast is changed.
CURSOR_UPDATE
Fired when the player single-clicks terrain. This excludes doodads, NPCs and other PCs.
CVAR_UPDATE
Fired when a CVar is changed
- arg1
- cvarname
- arg2
- value
Events D-G
DELETE_ITEM_CONFIRM
Fired when the player attempts to destroy an item.
- arg1
- item name
DISPLAY_SIZE_CHANGED
DUEL_FINISHED
Fired when a duel is finished.
DUEL_INBOUNDS
Fired when the player is still in the bounds of the duel.
DUEL_OUTOFBOUNDS
Fired when the player leaves the bounds of the duel
DUEL_REQUESTED
Fired when the player is challenged to a duel
- arg1
- opponent name
EQUIP_BIND_CONFIRM
Fired when the player attempts to equip bind on equip loot.
EXECUTE_CHAT_LINE
Fired when the chat line needs to be processed.
- arg1
- Chat line
FRIENDLIST_SHOW
FRIENDLIST_UPDATE
GOSSIP_CLOSED
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_ENTER_CODE
GOSSIP_SHOW
Fired when you talk to an npc
- (Quest dialogue boxes and Vending boxes do not call this event)
- no arguments
GUILD_INVITE_CANCEL
Fired when the guild invitation is declined.
GUILD_INVITE_REQUEST
Fired when you are invited to join a guild.
- arg1
- guild inviter
- arg2
- guild name
GUILD_MOTD
GUILD_REGISTRAR_CLOSED
GUILD_REGISTRAR_SHOW
GUILD_ROSTER_SHOW
GUILD_ROSTER_UPDATE
Fired when the client's guild info cache has been updated after a call to GuildRoster().
Events H-L
IGNORELIST_UPDATE
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
INSTANCE_BOOT_START
Fired when the countdown to boot a player from an instance starts.
INSTANCE_BOOT_STOP
Fired when the countdown to boot a player from an instance stops.
ITEM_LOCK_CHANGED
ITEM_PUSH
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 stack size (i.e. how many copies of this item fit in a single inventory slot)
arg2 - the path to the item's icon
ITEM_TEXT_BEGIN
Fired when an items text begins displaying
ITEM_TEXT_CLOSED
Fired when the items text has completed its viewing and is done.
ITEM_TEXT_READY
Fired when the item's text can continue and is ready to be scrolled.
ITEM_TEXT_TRANSLATION
Fired when an item is in the process of being translated.
LANGUAGE_LIST_CHANGED
LEARNED_SPELL_IN_TAB
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
LOCALPLAYER_PET_RENAMED
LOGOUT_CANCEL
LOOT_BIND_CONFIRM
Fired when the player attempts to take 'bind-on-pickup' loot
LOOT_CLOSED
Fired when a player ceases looting a corpse.
LOOT_OPENED
Fired when a corpse is looted
LOOT_SLOT_CLEARED
Fired when loot is removed from a corpse.
arg1 - Slot number
Events M-O
MAIL_CLOSED
MAIL_FAILED
MAIL_INBOX_UPDATE
Fired when the opened inbox changes in any way. For example when the inbox list is loaded after the frame has been opened, or when a mail item changes from new to read.
MAIL_SEND_INFO_UPDATE
Fired when an item is dragged to or from the Send Item box in an outgoing mail message.
MAIL_SEND_SUCCESS
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
Fired when the mailbox is opened.
MEETINGSTONE_CHANGED
?
MEMORY_EXHAUSTED
Fired when all 32MB allocated to the UI is exhausted.
MEMORY_RECOVERED
Fired when WoW recovers from an out of memory error.
MERCHANT_CLOSED
Fired when a merchant frame closes.
MERCHANT_SHOW
Fired when the merchant frame is shown.
MERCHANT_UPDATE
Fired when a merchant updates
MINIMAP_PING
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
Fired when the minimap zoom is changed.
MINIMAP_ZONE_CHANGED
MIRROR_TIMER_PAUSE
Fired when the mirror timer is paused.
- arg1
- pause duration
MIRROR_TIMER_START
Fired when some sort of timer starts.
- arg1
- timer
- arg2
- value
- arg3
- maxvalue
- arg4
- scale
- arg5
- paused
- arg6
- label