$modifyUserRoles

This function allows you to modify a user's roles by adding, removing, or toggling them. You can perform multiple operations in a single function call.

Operations (op):

• +: Add the specified role.
• -: Remove the specified role.
• ~: Toggle the role (add if the user doesn't have it, remove if they do).

Usage

$modifyUserRoles[User ID;[op]Role 1;[op]Role 2;...]

Parameters:

• User ID: The ID of the user whose roles you want to modify.
• [op]Role N: A series of role modifications. Each modification consists of an operation (+, -, or ~) followed by the role name or ID. Separate each role modification with a semicolon (;).

Example

Let's say you want to add the "VIP" role and remove the "Newbie" role from a user. Here's how you would do it:

$modifyUserRoles[$authorID;+VIP;-Newbie]

In this example:

• $authorID represents the ID of the message author (the user whose roles you want to modify).
• +VIP adds the "VIP" role to the user.
• -Newbie removes the "Newbie" role from the user.

Function Cooldown

This function has built-in cooldown. Why? Read more about cooldowns here.

• Cooldown: 6 seconds
• Tracked By: User ID
• Type: userupdate

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