WoW API: UnitDebuff
← 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.