WoW:API UnitDebuff

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < UnitDebuff

Retrieve info about a certain debuff on a certain unit.

name, rank, texture, count, debuffType, duration, timeLeft  =  UnitDebuff(unitID, debuffIndex [, removable]);

Parameters

Arguments

unitId

String - The unit you want debuff information for.

debuffIndex

Number - The index of the debuff to retrieve info for. Starts at 1, maximum 40.

removable

Boolean - (optional) - If 1, only debuffs removable by player will be returned; debuffIndex still begins at 1.

Returns

name

String - The name of the spell or effect of the debuff. This is the name shown in yellow when you mouse over the icon.

rank

String - The rank of the spell or effect that caused the debuff. Returns "" if there is no rank.

texture

String - The identifier of (path and filename to) the indicated debuff, or nil if no debuff

count

Number - The number of times the debuff has been applied to the target. Returns 0 for any debuff which doesn't stack. ( Changed in 1.11 ).

debuffType

String - The type of the debuff: Magic, Disease, Poison, Curse, or nothing for those with out a type.

duration

Number - The full duration of the debuff in seconds; nil if the debuff was not cast by the player.

timeLeft

Number - Time until the debuff expires, in seconds; nil if the debuff was not cast by the player.

Example

name, rank, texture = UnitDebuff("pet", 1);

Retrieves the name, rank and icon texture of the first debuff on the player's pet.

/run for i=1,40 do local n,_,_,_,_,_,t=UnitDebuff("target",i);if (n=="Polymorph") or (n=="Polymorph: Pig") or (n=="Polymorph: Turtle") then SendChatMessage(t.." seconds left on CC","SAY");end end 

Macro to retrieve target's timeLeft for any of the three Mage Poly spells and announce it via "SAY".

History

• Patch 1.9 introduced the removable argument.
• Patch 2.0 extended the maximum number of debuffs to 40 (from 16).
• Patch 2.0 introduced name and rank return values.
• Patch 2.1 introduced duration and timeLeft return values.

See Also

UnitBuff

FAQ: Why doesn't UnitDebuff accurately report the spell I just cast?

HOWTO: Identify Buffs Using Textures

List of known buff and debuff effects that can be queried