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.

debuffTexture, debuffApplications, debuffDispelType = UnitDebuff(unitID, debuffIndex, showDispellable);

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.

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

showDispellable

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

debuffTexture

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

debuffApplications

Number (docs said String?!) - The number of times the debuff has been applied to the target. Usualy returns 0 for single debuffs(Changed in 1.11).

debuffDispelType

String - The debuff dispel type. Can be "Magic", "Curse", "Poison", "Disease" or nil if not dispellable. These strings are constant across localizations. (Added in 1.11)

Example

debuff = UnitDebuff("pet", i);

Retrieves the debuff texture of the player's pet's 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