API UnitSetRole

From Wowpedia
Jump to: navigation, search

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.)"