$giveRole

The function $giveRole assigns a role to a user on the Discord server. The bot must have the ManageRoles permission.

Syntax

$giveRole[userID;roleID]

Or with a single parameter (targeting the mentioned user):

$giveRole[roleID]

Parameters

Parameter	Description
userID	The ID of the target user. If omitted, targets the mentioned user.
roleID	The ID of the role to assign. Required.

Return Value

None. The role is assigned.

Examples

Simple assignment

$giveRole[$mentioned[1];$roleID[Confirmed]]
$sendMessage[<@$mentioned[1]> has received the Confirmed role!]

Auto-assignment for the author

$giveRole[$roleID[Member]]
$sendMessage[$userName, you now have the Member role.]

Assignment command with verification

$if[$roleExists[$roleID[$message[2]]]==true]
  $giveRole[$mentioned[1];$roleID[$message[2]]]
  $sendMessage[Role assigned successfully.]
$else
  $sendMessage[This role does not exist.]
$endif

Assignment after hierarchy check

$if[$rolePosition[$getRole[$authorID;1]]>$rolePosition[$roleID[Staff]]]
  $giveRole[$mentioned[1];$roleID[Staff]]
  $sendMessage[<@$mentioned[1]> is now Staff!]
$else
  $sendMessage[You do not have permission to promote members.]
$endif

Notes

• The bot must have the ManageRoles permission.
• The bot cannot assign a role higher than its own highest role.
• To assign multiple roles at once, use $giveRoles.
• To replace all roles of a user, use $setUserRoles.
• Functional equivalent to $roleGrant.