Skip to content

Reaction Roles

Info

Deleted messages are also cleared from the database. A good tip is to pin the reaction role message to make it immune to purging.

Management

Name Example Usage
rr make -- Starts the interactive setup to get you started with reaction roles
rr [list|show] [msg_id] -- Shows the emoji-role pairs and their associated message id, useful for rr add. If a message id is specified, it will show additional information about that particular reaction role.
rr add [channel] <msg_id> <emoji> <role> !rr add 1238901239812 :angel: pure Adds the emoji-role pair to the message and the database. NOTE: This message id can belong to other people than carlbot, and the same emoji can be used for different messages for different roles (useful for regional roles)
rr addmany [channel] <msg_id> <emoji role...> !rr addmany 1238901239812 :angel: pure :poop: fortnite :grin: league of legends SEPARATE EACH EMOJI-ROLE PAIR WITH A NEWLINE Works like !rr add except it adds more than one role at a time
rr remove <msg_id> <role> !rr remove 493018654405951488 fortnite Removes an emoji-reaction pair from the specified bot message.
rr clear [msg_id] !rr clear 12343323615155 If you specify a message id, it removes all the roles from the message, if you don't, it will remove all reaction roles from the server.
rr bl <msg_id> <roles...> !rr bl 2389742349827 Staff Prevents members with this role from picking up roles from the message.
rr wl <msg_id> <roles...> !rr wl 2389742349827 Staff Only members with one of these roles can pick up roles from the message.
rr unbl <msg_id><roles...> !rr unbl 2389742349827 Staff Removes a blacklisted role from the indicated reaction role message allowing for the role to pick up new roles from the message.
rr unwl <msg_id><roles...> !rr unwl 2389742349827 Staff Removes a whitelisted role from the indicated reaction role message preventing the role from picking up new roles from the message.
rr clearbl <msg_id> !rr clearbl 2389742349827 Removes all roles from your blacklist for that set of reaction roles.
rr clearwl <msg_id> !rr clearwl 2389742349827 Removes all roles from your whitelist for that set of reaction roles.
rr selfdestruct <msg_id> <time> !rr selfdestruct 2389742349827 7d Deletes the message and all of its reaction roles after the time is up.
rr edit <msg_id> <title | description> !rr edit 23094823094823490 Games | Click on the games you want to be notified by Edits the title and description, works like it does in the make command

Modes

Info

Modes are per message and change their behavior. Every message has a mode which defaults to normal.

Name Example Usage
rr unique <msg_id> !rr unique 123817349589 Marks a message as 'unique' meaning a member can only claim one role from this message at a time, this works per message. Automatically removes the old reactions for you
rr binding <msg_id> !rr binding 123817349589 A combination of rr verify and rr unique. Allowing for members to limit people to one choice ever.
rr link <base_id> <target_id> !rr link 2389742349827 1239179273791283 By linking two or more messages together, only one role from either message can be self-assigned. If you have 30 color roles for instance, linking the two messages together (since the limit is 20/message) allows a smooth, user-friendly experience when picking up roles.
rr unlink <msg_id> !rr unlink 2389742349827 This breaks apart the entire group created by !rr link This means if you had three messages linked together, none of them will be after using this command.
rr verify <msg_id> !rr verify 123123123123 With this enabled, reactions can only assign roles, not take them away. Additionally the bot automatically removes the reaction after the user reacts. This is useful for servers that want a verification reaction
rr drop <msg_id> !rr drop 123123123123 Works sort of like rr verify, except it can only remove roles (and roles are removed when the emoji is added). This can be used for servers that automatically assign a role that you wish to remove.
rr normal <msg_id> !rr normal 123123123123 This returns the reaction role message back to a normal reaction role message. Meaning any commands applied to it such as verify or unique will be removed.
rr temp <msg_id> <time> !rr temp 2389742349827 24h Patreon only: This allows for roles to be temporarily be assigned to a member and then removed after the designated amount of time.
rr reversed <msg_id> !rr reversed 2389742349827 Reacting removes roles, unreacting adds roles.
rr lock <msg_id> !rr lock 2389742349827 Locks the message preventing any roles from being handed out.
rr limit <msg_id> <limit> !rr limit 2389742349827 5 Limits members to picking up x amount of roles from a message.

Advanced/niche

Warning

These commands come in very handy in certain situations, but may cause confusion to people unfamiliar with how Carl-bot's reaction roles work.

Name Example Usage
rr move <base_id> <target_id> !rr move 493018654405951488 351050906189692938 Moves the reaction roles from one message to another. This works even if the message was purged (using the message id found in !rr show).
rr aio <channel> <color> <title | description> <emoji> <role> !rr aio #reaction eeaaee "hello there | this is a description" :red: hello :purple: there SEPARATE EACH EMOJI-ROLE PAIR WITH A NEWLINE This is meant for power users who wish to create everything with just one command. The title and description have to be enclosed in double quotes.
rr aiou <channel> <color> <title | description> <emoji> <role> -- Works like !rr aio but also marks the message as unique
rr aiov <channel> <color> <title | description> <emoji> <role> -- All in one command to create a verification reaction role.
rr aioi <channel> <color> <title | description> <emoji> <role> -- All in one command to create an inverse verification reaction role, i.e. one that only removes roles.
!rr fixforeign <msg_id> !rr fixforeign 351050906189692938 Super niche command which can be used to have the bot react to emojis the bot doesn't have access to. One reason you might want to use this is because you want to use google's blob emojis. This command isn't required for these emojis to work, it only makes it so that the bot has its reactions added to the message. YOU HAVE TO REACT TO THE MESSAGE WITH THE EMOJIS YOURSELF BEFORE USING THIS COMMAND
rr maxroles <msg_id> [<role> <number>...] !rr maxroles 2389742349827 DPS 10 Want to limit the number of x role? With this, you can. NOTE This checks for how many people have the role, not how many reactions there are.
rr [colour|color] <msg_id> <color> !rr color 507068806800211969 #00ee28 Changes the accent color of the specified bot message

The fastest and most reliable unique reaction roles of any bot.

Me setting up reaction roles in my support server.