/connectedroles¶
Tip
This command requires the administrator permission by default.
To learn how to change this, please check the faq command.
/connectedroles add¶
Adds role(s) to the list of roles that should trigger the assignment of other roles.
A connected role is a role that will cause other roles to be assigned automatically. So when a user is assigned the connected role, they will be assigned the role(s) that connected role is configured to assign. Multiple roles can also be set as requirements for one or more roles to be added, all of these roles will be required before the additional role(s) are assigned.
Example
One of the administrators ran the command: /connectedroles add role: @Donator roles_to_add: @Cool Role @Awesome Role
A user is assigned the connected role, in this case @Donator, which would cause @Cool Role and @Awesome Role to be assigned to them automatically.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
roles |
Transform[str, RoleTransformer]
|
Role(s) that should trigger the assignment of other roles |
required |
roles_to_add |
Transform[str, RoleTransformer]
|
Roles to be added when the user receives the role(s). |
required |
/connectedroles remove¶
Removes role(s) from the list of roles that should be assigned when a connected role is assigned to a user.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
roles |
Transform[str, RoleTransformer]
|
Role(s) that should trigger the assignment of other roles |
required |
roles_to_remove |
Transform[str, RoleTransformer]
|
The roles that should no longer be added when the user is assigned the connected role. |
required |