$setRoles

Gives a user specific roles, removing all other roles. This is useful for setting a user's roles to a specific configuration, like assigning a "Muted" role and removing all other roles.

Usage:

$setRoles[userID;roleID 1;roleID 2;roleID 3;...]

• userID: The ID of the user you want to modify roles for.
• roleID 1;roleID 2;roleID 3;...: A semicolon-separated list of role IDs that the user should have. All other roles will be removed.

Example:

Sets the command executor's roles to only the "Muted" role.

!!exec $setRoles[$authorID;$roleID[Muted]]

Explanation:

• !!exec: Executes the command. Replace with your bot's command prefix.
• $setRoles: The function being used.
• $authorID: Gets the ID of the user who executed the command (using the $authorID function).
• $roleID[Muted]: Gets the ID of the role named "Muted" (using the $roleID function).

Important Notes

• The bot needs the Manage Roles permission to use this function.
• The bot can only manage roles that are below its highest role in the server's role hierarchy.
• Invalid role IDs or user IDs will cause the function to fail.

Used Functions

• $roleID[roleName]: Returns the ID of a role, given its name. See RoleID Documentation
• $authorID: Returns the ID of the command executor. See AuthorID Documentation

Related Functions

• $giveRoles[userID;roleID 1;roleID 2;...]: Gives roles to a user without removing existing roles. See GiveRoles Documentation
• $takeRoles[userID;roleID 1;roleID 2;...]: Removes roles from a user. See TakeRoles Documentation
• $toggleRoles[userID;roleID 1;roleID 2;...]: Toggles the specified roles on a user. See ToggleRoles Documentation

Function difficulty: Medium

⏱️ Function Cooldown

This function has a built-in cooldown to help prevent excessive usage.

Property	Value
⏱️ Duration	6 seconds
🆔 Tracked By	User ID
🌐 Scope	Userupdate

Functions with the same Scope share cooldowns based on the same Tracked By value.

💎 Tier 3+ servers bypass this cooldown. See Premium Perks.