Editing WoW:Events/Combat

__NOTOC____NOEDITSECTION__{{eventlistheader}}
<!-- DO NOT EDIT. THIS IS AN AUTOMATICALLY GENERATED PAGE. -->
<!-- DO NOT EDIT. THIS IS AN AUTOMATICALLY GENERATED PAGE. -->
<!-- DO NOT EDIT. THIS IS AN AUTOMATICALLY GENERATED PAGE. -->


:{{icon-information}}Note that this page is automatically generated; editing it is pointless. To edit event descriptions, edit the entries in the alphabetical pages, e.g. [[Events/A]], [[Events/B]], etc. Changes there will be copied over to here within a few hours.


== Combat related events ==

{{evt|CHAT_MSG_COMBAT_FACTION_CHANGE|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


{{evt|CHAT_MSG_COMBAT_HONOR_GAIN|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.")


{{evt|COMBAT_LOG_EVENT|Combat}}

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


{{evt|COMBAT_LOG_EVENT_UNFILTERED|Combat}}

<Added in Patch '''2.4.0'''> See [[API COMBAT LOG EVENT]].
<br>AddOns wanting to parse all events the moment they happen should register for this event.
(See this [http://forums.worldofwarcraft.com/thread.html?topicId=2968233433&sid=1&pageNo=9#177 blue posting] for more info)
; arg1: timestamp
; arg2: [http://www.wowwiki.com/API_COMBAT_LOG_EVENT#Events event]
; arg3: source[http://www.wowwiki.com/API_UnitGUID GUID]
; arg4: source[http://www.wowwiki.com/API_UnitName Name]
; arg5: source[http://www.wowwiki.com/UnitFlag Flags]
; arg6: destGUID
; arg7: destName
; arg8: destFlags
; arg9: spellID
;arg10: spellName
;arg11: [http://www.wowwiki.com/API_COMBAT_LOG_EVENT#Spell_School spellSchool]
;arg12: SuffixParam1
;arg13: SuffixParam2
;arg14: SuffixParam3
;arg15: SuffixParam4
;arg16: SuffixParam5
;arg17: SuffixParam6
;arg18: SuffixParam7
;arg19: SuffixParam8
;arg20: SuffixParam9


{{evt|COMBAT_TEXT_UPDATE|Combat}}

<Added in Patch '''1.12'''>
<br>Fired when the currently watched entity (as set by the {{api|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


{{evt|DUEL_FINISHED|Combat}}

Fired when a duel is finished.


{{evt|DUEL_INBOUNDS|Combat}}

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


{{evt|DUEL_OUTOFBOUNDS|Combat}}

Fired when the player leaves the bounds of the duel


{{evt|DUEL_REQUESTED|Combat}}

Fired when the player is challenged to a duel

; arg1 : opponent name


{{evt|PET_ATTACK_START|Combat,Pet}}

Fired when the player's pet begins attacking.


{{evt|PET_ATTACK_STOP|Combat,Pet}}

Fired when the player's pet ceases attack


{{evt|PLAYER_CONTROL_GAINED|Player,Combat}}

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


{{evt|PLAYER_CONTROL_LOST|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.


{{evt|PLAYER_ENTER_COMBAT|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:<br>
: PLAYER_ENTER_COMBAT and [[#PLAYER_LEAVE_COMBAT|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|PLAYER_REGEN_DISABLED]] (happens when you get aggro) and [[#PLAYER_REGEN_ENABLED|PLAYER_REGEN_ENABLED]] (happens when you lose aggro).''


{{evt|PLAYER_FOCUS_CHANGED|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.


{{evt|PLAYER_LEAVE_COMBAT|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.


{{evt|PLAYER_REGEN_DISABLED|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).


{{evt|PLAYER_REGEN_ENABLED|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.


{{evt|PLAYER_TARGET_CHANGED|Combat,Unit Info}}

This event is fired whenever the player's target is changed, including when the target is lost.

;arg1 : <tt>up</tt> if you click the target directly, <tt>down</tt> if you press Escape to clear the target selection, <tt>LeftButton</tt> if you select the target using static frames in the UI, <tt>nil</tt> if the target moves out of range and is lost.


{{evt|UNIT_COMBAT|Unit Info,Combat}}

Fired when an npc or player participates in combat and takes damage

; arg1 : the [[API_TYPE_UnitId|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)


{{evt|UNIT_COMBO_POINTS|Unit Info,Combat}}