Self-Assign Roles

Learn more about how to self-assign roles in the traditional way if you aren't using Reaction Roles.

SajuukBot will be ceasing operations on March 31st 2024, due to a variety of factors. For more information, please refer to the announcement provided on the SajuukBot discord server and your options for migrating to a new bot.

Most servers will likely set up SajuukBot to use Reaction Roles, due to its simplicity and efficiency, not requiring the use of complex commands and confusing syntaxes. For some servers, they may not have enough roles to warrant this system, or they may want to configure it as a tool internally for moderators to add and remove roles from themselves without setting up more reaction roles.

For these cases, you can assign and remove roles to yourself using some simple bot commands.

Configuration

This section of configuration is a root key, which means it should not be indented and in line with the basic settings like levels, prefix and the like. Please see the full basic configuration for more details on how it should be formatted.

self roles:
  enabled: false
  roles:
  commands:
    join:
      enabled: false
      level: 50
    leave:
      enabled: false
      level: 50

Settings

Each tab contains more details on each setting described in the configuration above.

For more information relating to the commands key, please go to the Commands section below.

Setting	Description
enabled	Toggles the self roles module on and off. If this is disabled, then none of the self-assign roles functionality, via bot commands, is available.
roles	A list of Role IDs referencing public roles. Users will not be able to assign roles defined here if the role(s) have "elevated" permissions enabled, please refer to Troubleshooting for more information.

Commands

Due to space constraints, the required syntax of commands, and an example of how they work, are given provided after the list of commands and explanations.

Every command follows the exact same formatting:

• A key called enabled determining if the command is enabled or not.

• A key called level, determining the minimum level required to use the command

At the root of the self roles key is an enabled key, which globally controls the commands assigned to this module. If the root key is false, then no command will operate, regardless of whether an individual command is enabled.

Command	Description
!join	Adds one or more roles to your profile. Only roles previously defined as being addable can be added. In addition, if a role has "elevated" permissions, you will not be able to add it. The roles you want to add should be given in comma-separated format.
!leave	Adds one or more roles to your profile. Only roles previously defined as being addable can be added. In addition, if a role has "elevated" permissions, you will not be able to add it. The roles you want to add should be given in comma-separated format.

Syntax and Examples

!join

!join LIST,OF,ROLES,TO,ADD
!join My Role,Another Role

!leave

!leave LIST,OF,ROLES,TO,REMOVE
!leave My Role,Another Role