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.

debuffName, debuffRank, debuffTexture, debuffApplications, debuffType =
UnitDebuff( unitID, debuffIndex [, raidFilter] );

Parameters

Arguments

unitName

The unit id you want debuff information for

debuffIndex

Number - The index of the debuff to retrieve info for. Starts at 1, maximum 40 (new in 2.0, old was 16).

The maximum numbers used by the Blizzard code are 16 for party/pet/target debuffs.

raidFilter

Boolean - (optional) - Can be 0, 1, or nil. If present and 1, then only debuffs will be returned which are dispellable by the player. Index is still starting with 1 and counting up. (new in 1.9, works in 1.9.3)

Returns

debuffName

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

debuffRank

String - The rank of the spell or effect that caused the debuff. Returns "" if there is no rank. (Added in 2.0)

debuffTexture

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

debuffApplications

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.

Example

debuff, debuffR, debuffT = UnitDebuff("pet", i);

Retrieves the texture of the player's pet's debuff along with the name and rank of the spell that caused the debuff with the index i.

See Also

UnitBuff

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

Sample Code Check Hunter's Mark Aspect

List of known buff and debuff effects that can be queried