$giveRoles

The function $giveRoles assigns multiple roles at once to a user. It is the multi-role version of $giveRole. The bot must have the ManageRoles permission.

Syntax

$giveRoles[userID;role1;role2;...]

Parameters

Parameter	Description
userID	The ID of the target user. Required.
role1;role2;...	The IDs of the roles to assign, separated by ;. Required.

Return Value

None. All specified roles are assigned.

Examples

Simple multiple assignment

$giveRoles[$mentioned[1];$roleID[Member];$roleID[Notifications]]
$sendMessage[<@$mentioned[1]> has received the Member and Notifications roles.]

Grouped assignment with a condition

$if[$isAdmin==true]
  $giveRoles[$mentioned[1];$roleID[Modo];$roleID[Staff];$roleID[VIP]]
  $sendMessage[All staff roles assigned to <@$mentioned[1]>.]
$else
  $sendMessage[Permission denied.]
$endif

Welcome command

$giveRoles[$authorID;$roleID[Member];$roleID[New];$roleID[Auto]]
$sendMessage[Welcome $userName! Default roles assigned.]

Notes

• The bot must have the ManageRoles permission.
• The roles are separated by ; in the syntax.
• To assign a single role, $giveRole is simpler.
• To replace all existing roles, use $setUserRoles.
• Roles already possessed by the user are ignored.