WoW:Events/Combat: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (automated upload)
m (Move page script moved page Events/Combat to Events/Combat without leaving a redirect)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
__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}}

Latest revision as of 04:48, 15 August 2023

Event API


"I" iconNote 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

"CHAT_MSG_COMBAT_FACTION_CHANGE"
Category: Combat
 

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

arg1
chat message
arg11
Chat lineID


"CHAT_MSG_COMBAT_HONOR_GAIN"
Category: Honor,Combat
 

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

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


"COMBAT_LOG_EVENT"
Category: Combat
 

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


"COMBAT_LOG_EVENT_UNFILTERED"
Category: Combat
 

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

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


"COMBAT_TEXT_UPDATE"
Category: Combat
 

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

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

arg3 does NOT return amount absorbed since at least patch 2.4


"DUEL_FINISHED"
Category: Combat
 

Fired when a duel is finished.


"DUEL_INBOUNDS"
Category: Combat
 

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


"DUEL_OUTOFBOUNDS"
Category: Combat
 

Fired when the player leaves the bounds of the duel


"DUEL_REQUESTED"
Category: Combat
 

Fired when the player is challenged to a duel

arg1
opponent name


"PET_ATTACK_START"
Category: Combat,Pet
 

Fired when the player's pet begins attacking.


"PET_ATTACK_STOP"
Category: Combat,Pet
 

Fired when the player's pet ceases attack


"PLAYER_CONTROL_GAINED"
Category: Player,Combat
 

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


"PLAYER_CONTROL_LOST"
Category: Player,Combat
 

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


"PLAYER_ENTER_COMBAT"
Category: Combat
 

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

From a post by Dhrago on the WoW forums:

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


"PLAYER_FOCUS_CHANGED"
Category: Combat,Unit Info
 

This event is fired whenever the player's focus target (/focus) is changed, including when the focus target is lost or cleared.


"PLAYER_LEAVE_COMBAT"
Category: Combat
 

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


"PLAYER_REGEN_DISABLED"
Category: Player,Combat
 

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


"PLAYER_REGEN_ENABLED"
Category: Player,Combat
 

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


"PLAYER_TARGET_CHANGED"
Category: Combat,Unit Info
 

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

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


"UNIT_COMBAT"
Category: Unit Info,Combat
 

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

arg1
the UnitID of the entity
arg2
Action,Damage,etc (e.g. HEAL, DODGE, BLOCK, WOUND, MISS, PARRY, RESIST, ...)
arg3
Critical/Glancing indicator (e.g. CRITICAL, CRUSHING, GLANCING)
arg4
The numeric damage
arg5
Damage type in numeric value (1 - physical; 2 - holy; 4 - fire; 8 - nature; 16 - frost; 32 - shadow; 64 - arcane)


"UNIT_COMBO_POINTS"
Category: Unit Info,Combat