arg1

the mouse button used to click the button. Known values: "LeftButton", "RightButton"

arg2

true or false for unknown reason.

arg1

the mouse button used to click the button. Known values: "LeftButton", "RightButton"

arg2

true or false for unknown reason.

no arguments

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.

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

arg1

the mouse button used to click the button. Known values: "LeftButton", "RightButton"

can also be nil

no arguments

arg1

Name of the AddOn that was last involved in the execution path.

arg2

The protected function that was called.

arg1

Name of the AddOn that was last involved in the execution path.

arg2

The protected function that was called.

arg1

name of the AddOn that was just loaded

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

arg1

container ID

arg1

container ID

arg1

container ID

arg1

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

arg1?: rollID

arg1

indicates number of talent points changed: -1 indicates one used (learning a talent), 1 indicates one gained (leveling)

Fired when the client receives a message from?SendAddonMessage

arg1

prefix

arg2

message

arg3

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

arg4

sender

arg1

AFK response message

arg2

author

Fired when a message is received through the battleground group channel

arg1

chat message

arg2

author

arg3

language

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

arg1

chat message

arg2

author

arg3

language

arg1

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

arg1

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

arg1

Battleground Message (eg. "Let the battle for Warsong Gulch begin.")

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 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 (this is _sometimes_ in lowercase)

• zone is always current zone even if not the same as the channel name

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

Window title

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

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"

arg1

type ( "YOU_JOINED" if you joined a channel, or "YOU_LEFT" if you left )

arg4

Channel name with number (e.g. "6. TestChannel")

arg8

Channel Number

arg9

Channel name without number

CHAT_*_NOTICE in GlobalStrings.lua has a full list of available types.

arg1

type ("ANNOUNCEMENTS_OFF", "ANNOUNCEMENTS_ON", "BANNED", "CHANNEL_OWNER", "INVALID_NAME", "INVITE", "MODERATION_OFF", "MODERATION_ON", "MUTED", "NOT_MEMBER", "NOT_MODERATED" )

arg2

If arg5 has a value then this is the user effected ( 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" )

arg1

chat message

arg1

chat message

arg1

chat message

arg1

chat message

arg1

chat message

arg1

chat message

arg1

chat message (format: "%s dies")

arg1

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

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

arg1

chat message

arg1

chat message

arg1

chat message

arg1

DND response message

arg2

author

arg1

Message that was sent/received

arg2

Name of the player who sent the message

arg1

Message that was sent

arg2

Author

arg3

Language that the message was sent in

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

arg1

Chat message

arg1

Chat message

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)

arg1

Message

arg2

NPC name

arg3

Language used

arg1

Message

arg2

NPC Name (eg:?Onyxia)

arg1

Message that was received

arg2

Author

arg3

Language used

arg1

Message that was received

arg2

Author

arg3

Language used

arg1

chat message

arg2

author

arg3

language

arg1

emote message

arg2

Name of the boss

arg1

chat message

arg2

author

arg3

language

arg1

chat message

arg2

author

arg3

language

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.

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

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

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.

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.

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.

arg1

the full combat chat text.

Examples:

Someguy gains Arcane Intellect.

Someguy gains Aspect of the Pack.

Someguy gains Felsteed.

Haven't tested any other conditions as of yet.

Awauna gains Power Word: Shield.

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

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

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

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

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

arg1

Emote Message

arg2

Name of person who emoted

The rest of the arguments appear to be nil

arg1

Message received

arg2

Author

arg3

Language (or nil if universal, like messages from GM)

arg6

status (like "DND" or "GM")

arg1

Message sent

arg2

Player who was sent the whisper

arg3

Language

arg1

Message that was received

arg2

Author

arg3

Language used

Fired when the player 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.

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

arg1

The mouse button used to close the window.

arg1

The mouse button used to open the window.

arg1

cvarname

arg2

value

arg1

item name

arg1

opponent name

arg1

Chat line

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.

(Seems to be called twice)

arg1

The mouse button used to close the window (nil if closed when you go out of range)

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

arg1

guild inviter

arg2

guild name

arg1

guild message of the day

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

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

arg1

the bag that has received the new item

arg2

the path to the item's icon

arg1

Number of the tab which the spell/ability is added to

arg1

Slot number

arg1

Current memory limit (in MB).

arg1

button used to close the window)

arg1

UnitId of the one that created the ping (ie "player" or any of the group members)

arg2

x

arg3

y

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

arg1

pause duration

arg1

timer

arg2

value

arg3

maxvalue

arg4

scale

arg5

paused

arg6

label

arg1

team leader name

Referred to as?buggy.

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 whenever someone rejects an invite and your in a group, also generated obviously when someone joins or leaves the 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.

arg1

Player Name

arg1

Player Name

arg1

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

Does?not?fire when an item is added to or removed from a bank bag, only when a bag is added or removed from the bag slots.

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

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

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.

arg1

always "player",?not?the number of combo points you have.

Use the?GetComboPoints() API to get the exact number of combo points you have.

To check if the player is entering an instance, check?GetPlayerMapPosition?to see if both X and Y are zero.

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

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

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.

Reference handler in?FriendsFrame.lua.

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

Note: There seems to be little useful you can do after this event is fired. Changes to saved variables do not seem to have any effect, at least some API functions no longer return valid values, and client crashes may also occur in some cases. Perhaps worst of all, the error handling in Lua is no longer functional; so you will get no error messages if your code fails.

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.

The arg1--arg9 values are?undefined; they will be whatever they were in the previous event, i.e. if you click a unit portrait to change target, arg1 will be "LeftButton" - if you click a macro button, it will be the macro script, etc.

There used to be an old notice here about UnitName() et al not returning correct info immediately after a target change, but as even FrameXML itself depends on it doing so, I assume that's outdated and/or inaccurate information.

UnitName("target") returns the correct name, but UnitName("targettarget") does not.

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

arg1

npc name?

arg2

quest name?

(this doesnt seem like it works)-Noraj

(could it be only when the message pops up when a quest (such as an escort) is started by another player? I'll test it when I get the chance)

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

arg1

mousebutton (LeftButton)

arg1

questIndex (not watch index)

• As of 1.12.0, this event no longer fires when entering the world as a raid member. It did previously. Bug?

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)

arg1

enchantmentname

arg2

item name

arg1

player name

arg1

Duration (in milliseconds)

arg2

Spell Name

On version 1.2.1, this event doesnt seem to work.

arg1

remaining Duration (in milliseconds)

arg1

Disruption time

arg1

Spell Name

arg2

Duration (arg2 seems to be in milliseconds ex. 1.5 second cast time shows as 1500)

• Called twice when the spell is channelled. Once at start, once at completion.

• The only SURE way to determine if a non-instant, non-damaging spell is cast successfully (such as Warlock Banish) is to do the following:

1. Observe the spell start with UseAction or by trapping CastSpellByName() or one of the other methods of trapping spellcasts.
2. Wait for SPELLCAST_STOP to arrive.
3. When it arrives, you know the spell has stopped, but you don't know the reason!! It could be that the spell was cast successfully, or it was resisted, or the target was immune, or you moved. Schedule a success check 1/10th of a second in the future by using GetTime() and the OnUpdate() event callback.
4. If you get to a 1/10th of a second in the future without recieving SPELLCAST_INTERRUPTED or SPELLCAST_FAILURE, then the spell landed successfully. If one of those other events occured, you can kill your scheduled success check because the spell failed.

You could also check for the Banish debuff on the target, but that's a can of worms because the player can switch targets mid cast (which does happen in nutty endgame instances).

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

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.

arg1

if the spell is triggered by keypress, returns the?GetTime() output in string format. Otherwise, it will return "LeftButton" or "RightButton"

arg1

The rollID of the item being rolled on.

arg2

The roll time.

arg1

message

arg2

red

arg3

green

arg4

blue

arg1

Total time

arg2

Current time at this level

Fired when a tooltip has money added to it.

arg1

tooltip name

arg2

money amount

arg1

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

arg2

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

arg1

index of the trade slot changed

arg1

enchantment

arg2

item name

Fired when another player wishes to trade with you.

arg1

player name

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

arg1

index of the trade slot changed

arg1

message

arg1

message

arg1

the?UnitID?of the entity

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

arg1

the?UnitID?of the entity

arg2

Action,Damage,etc (e.g. 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 (0 - physical; 1 - holy; 2 - fire; 3 - nature; 4 - frost; 5 - shadow; 6 - arcane)

arg1

unit name

arg1

the name of the unit whose energy is affected

Seen unit names:

• player

arg1

the name of the unit whose faction changed

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

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.

If multiple slots are equipped/unequipped at once it only fires once now. However it still fires many times (potentially hundreds) while zoning or logging in.

arg1

the?UnitID?of the entity

arg1

the?UnitID?of the entity whose level is submitted

arg1

the?UnitID?of the entity

arg1

the?UnitID?of the entity whose name changed

arg1

The?UnitID?of the entity whose pet changed

arg1

Unit name

Fired when the UI is loaded, and when player PVP status is changed or updated.

arg1

the unit whose pvp status has changed (ie. "player")

arg1

unit name

Seen unit names:

• player
• party1

arg1

the name of the unit whose rage is affected

Seen unit names:

• player

arg1

Unit casting the spell

arg1

Unit casting the spell

arg1

Unit casting the spell

arg1

Unit casting the spell

arg1

Unit casting the spell

arg1

Unit casting the spell

arg1

Unit casting the spell

arg2

Spell name

arg3

Spell rank

arg4

Spell target

arg1

Unit casting the spell

arg1

Unit casting the spell

arg1

Unit casting the spell

arg2

Spell name

arg3

Spell rank

arg1

Unit Name - can be 'target' 'mouseover' 'player' or 'party1..4' possibly also 'raid1..40'

arg2

Action - can be 'RESISTED' 'DODGED' 'PARRIED' or 'BLOCKED'

arg1

Unit Name

arg1

unitId?of the unit which changed targets.

arg1

Chat type

arg2

red

arg3

green

arg4

blue

Fired when the target of the?UnitID?'mouseover' has changed.

No Arguments.

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

Note that using this event means that your addon can not be loaded on demand properly. It is better to use ADDON_LOADED and test for arg1 being the name of your addon.

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

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)