API UnitBuff

Retrieve info about a certain buff on a certain unit.

buffTexture, buffApplications = UnitBuff(unit, buffIndex, showCastable);

---

Arguments

(String unit)

unit

String - The UnitId to select as a target.

BuffIndex

Number - The index num of the buff to retrieve info on. Starts at 1 and goes up to (and possibly beyond) a certain number. The maximum numbers used by turtle code are 32 for party/pet and 8(?) for target buffs.

ShowCastable

Boolean - Flag (optional) - Can be 0, 1, or nil. If present and 1, then only buffs will be returned which are castable by the player. Index is still starting with 1 and counting up.

Returns

BuffTexture

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

BuffApplications

String - The number of times the buff has been applied to the target.

Example 1

Retrieve the buff texture of the pets buff with the index of "i".

buff = UnitBuff("pet", i);

Example 2

Uses BUFF if the main buff is active, or else uses SPELL

/run local i,x=1,0 while UnitBuff("player",i) do if UnitBuff("player",i)=="Interface\\Icons\\Spell_Texture_Name" then x=1 end i=i+1 end if x==0 then CastSpellByName("BUFF") else CastSpellByName("SPELL") end

You need to replace "BUFF_TEXTURE" with the TEXTURE of a particular buff and NOT it's name. For example A Rogue's Stealth skill and a Druid's Prowl skill both use the little icon texture called "Ability_Ambush". Use this site to lookup your buff's texture: Queriable_buff_effects

Example 3

This prints the texture names of any buffs and debuffs on the target

/run function m(s) DEFAULT_CHAT_FRAME:AddMessage(s); end for i=1,16 do s=UnitBuff("target", i); if(s) then m("B "..i..": "..s); end s=UnitDebuff("target", i); if(s) then m("D "..i..": "..s); end end