WoW API: CancelPlayerBuff

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 < CancelPlayerBuff

Removes a specific buff from the player.

CancelPlayerBuff(buffIndex);

Arguments

buffIndex

The index of the buff to remove. Can be obtained with GetPlayerBuff. Can also use buff name since the 2.3 patch.

Example

CancelPlayerBuff(GetPlayerBuff(0,"HELPFUL"))

Result

Removes the first (right-most in the default UI) buff from the player.

Notes

• This function is not protected nor limited in any way to hardware event restriction Blizzard used so far. This function can be called freely from an AddOn to auto-remove a given buff.

(tested on live servers 2.0)

• This function uses a zero-based index, while UnitBuff() does not.
• The Burning Crusade: GetPlayerBuff() returns 0 if the buff doesn't exist. It stands to reason that this function would then be 1-based in TBC.