WoW API: UnitSetRole

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

Synopsis

Sets the player role in the group as Tank, Dps, Healer or None.

UnitSetRole(target,role)

Arguments

target

String - The affected group member. i.e. "player" or player name

role

String - The role for the player. (known values "TANK", "HEALER", "DAMAGER", "NONE")

Returns

Unknown

Example

local name="Imtarr";           
if ( playerInfo[name].tank == 1 ) then
   UnitSetRole(name,"TANK");
elseif ( playerInfo[name].heals == 1 ) then
   UnitSetRole(name,"HEALER");
elseif ( playerInfo[name].mDps == 1 ) then
   UnitSetRole(name,"DAMAGER");
elseif ( playerInfo[name].rDps == 1 ) then
   UnitSetRole(name,"DAMAGER");
end

Results

Sets the player role to the value specified. Note that the command will not allow roles to be assigned to classes that are not considered to be capable of fulfilling that role. i.e. It will not allow a Hunter to be given the role of TANK.

A system message will be sent to the members of the group.

"Healdude is now <<healTexture>> Healer. (Changed by Imtarr.)"