Skip to content

/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

/connectedroles list

Lists all of your connected roles.