UnitAffectingCombat

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Flavors
war within  mainline  cata  wrath  vanilla
Links
Blizzard Docs  Townlong Yak  Offline /api  Wowprogramming  GitHub Search
Info
Added in 1.3.0 / 1.13.2

Returns true if the unit is in combat.

affectingCombat = UnitAffectingCombat(unit)

Arguments

unit

string : UnitToken - The unit to check.

Returns

affectingCombat

boolean - Returns true if the unit is in combat or has aggro, false otherwise.

Details

• Returns true when initiating combat.
• Returns true if aggroed, even if enemy doesn't land a blow.
• For hunters, it returns true shortly after pet enters combat.
• If using timed spell such as aimed shot, returns true when spell fires (not during charge up).
• Returns to false on death.
• Returns false if the unit being checked for aggro is out of range, or in another zone.
• Returns false if a unit is proximity-aggroed. It wont return true until it either attacks or is attacked.