Documentation / Roles
Give and take roles, register custom roles and set up reaction roles.
Give a member, bots, everyone in the server, or all members in a role, a role through the bot, can also be used to remove a role as well. To specify whether to add or remove a role prefix it with + or -, otherwise the role will be removed if the target has it, and added if they do not.
!role bots/all [+/-]role !role role/member [+/-]role
!role bots +Rolename !role @Role -@role
“The epitome of laziness. Look, I understand some of these tasks you give me but this? Really?”
Register a role as a 'custom' role for the bot. This can be an existing role, or a non-existing role. Roles created by this command will have no permissions.
!addrole rolename/roleid
!addrole NewRole !addrole ExistingRole
“Did you know, if you add enough roles, I'll simply stop caring?”
Unregister a custom role. This will only remove it from the bot's list, however you may also tell the bot to delete the discord role as well.
Members with the Discord Manage Roles permission can also use this command.
!delrole rolename/roleid
!delrole Role !delrole 1234567890
“This is me caring.”
Edit a role. You can edit the name, the color, or whether the role is mentionable by everyone.
Members with the Discord Manage Roles permission can also use this command.
!editrole Role name new name !editrole Role color color code or hex !editrole Role mention [on/off/toggle]
!editrole @Role name New Name !editrole Role color #ffffff !editrole Role mention toggle
“More busy work for me, fairly sure discord already did it themselves, do I qualify for vacation?”
Get a list of all custom roles saved. This will display the options as well
!rolelist
!rolelist
“All of you should have 0, count'm 0 custom roles. I deserve a vacation!”
Edit the role options for custom roles registered. You may use one of three modifiers when setting options. Add adds the options you list, rem removes the options, and set overwrites the current options with the ones you put.
Valid options are:
Unique: Group up roles into 'unique' sets so that obtaining a role in one set removes roles from other that same set
Timed: Have a role that is removed after x amount of minutes of being added you may also have a role be added after a member has been in the server for X amount of minutes. To set 'remove' use negative numbers, positive numbers is 'add'.
Voice: Give this role when a member joins any voice channel, or specify channels to limit it.
Pair: Pair this role with another. The role does not need to be registered as a custom role. When that role is added, so is the 'paired' role. (not vice versa)
Lock: Lock this role so that nobody can self assign it via commands
Perma: Make this role permanent so it can not be removed via commands
Auto: Make this role be automatically given when a member joins the server (not to be confused with Addtimer)
Reset: Allow this role to be 'reset' via the reset command
Age: Only give this role to members with an account age above X days
Nitroonly: This role will be deleted if a member loses the server booster role.
Members with the Discord Manage Roles permission can also use this command.
!roleopt role view !roleopt role add/rem/set option [option] [option]
!roleopt @Role view !roleopt @Role add voice #Channel:12345612 !roleopt @Role set unique 1 age 3 !roleopt @Role add pair Role:@Role !roleopt rem reset auto perma lock
“Yes yes, put all the pretty little bells and whistles on, it aint winning no beauty pagent.”
Create, delete and manage role reaction systems. These are messages that have reactions attached to them, by clicking a reaction a member can get a role. This command is a setup, not individual commands. There are sub commands for modification, listed below.
Current: Get current reaction systems, provide a message ID for more details
Delete: Delete a reaction system
Restart: If a collector does not seem to be working, this can be used to manually start it.
Move: Move reactions from one system to another, or to a new message. Does not delete the old system
Addreact: Add a reaction to a currently running system
Deletereact: Delete a reaction from a currently running system.
!setrolereact !setrolereact current [message id] !setrolereact delete/restart messageid !setrolereact move messageid messageid !setrolereact addreact messageid reaction role !setrolereact deletereact messageid reaction/role
!setrolereact !setrolereact current !setrolereact current 1234567890 !setrolereact delete 1234567890 !setrolereact move 1234567890 0987654321 !setrolereact addreact 1234567890 ✅ @Role !setrolereact deletereact 1234567890 @Role
“You want my reaction? Click the title”