Discord bots · Discord bot
RoleReactionBot
React to an emoji, get a role. Build the post with a form and edit it any time.
A reaction-role bot that keeps the post tidy. Members react with an emoji to get a role and react again to drop it. The bot removes their reaction each time, so the post never fills up with reactions and the role list stays readable.
Setup
- Invite the bot. It needs Manage Roles, and in your server settings its own role must sit above every role it hands out.
- Optionally, as an administrator, let a role manage posts with
/rolereactionbot addadminrole. The server owner can skip this. - Run
/rolereaction createpost, pick the channel, fill in the form, then add each emoji and role pair with the “Add a role” button or/rolereaction addrole.
Good to know
No privileged intents are needed. Posts can be edited later with /rolereaction editpost and
/rolereaction addrole. Post IDs come from Discord’s “Copy Message ID” in the message menu, with
Developer Mode on.
Commands
Anyone can use the first group. The second is for the people who run the server.
For everyone
/rolereactionbot helpList every command.
e.g.
/rolereactionbot help
For admins
/rolereaction createpostadminPick a channel and fill in a form with the title, description, and color. Then add emoji and role pairs with the "Add a role" button or /rolereaction addrole.
e.g.
/rolereaction createpost channel:#roles/rolereaction addroleadminAdd an emoji and role pair to an existing post.
e.g.
/rolereaction addrole message_id:1398035064557801522 emoji:🎮 role:@Gamer/rolereaction removeroleadminRemove a role from a post, along with its reaction.
e.g.
/rolereaction removerole message_id:1398035064557801522 role:@Gamer/rolereaction editpostadminOpen a form, pre-filled with the current values, to change a post's title, description, or color.
e.g.
/rolereaction editpost message_id:1398035064557801522/rolereaction deletepostadminDelete a post and everything stored about it.
e.g.
/rolereaction deletepost message_id:1398035064557801522/rolereactionbot addadminroleadminLet a role manage reaction posts. Administrators only.
e.g.
/rolereactionbot addadminrole role:@Mods/rolereactionbot removeadminroleadminRevoke that.
e.g.
/rolereactionbot removeadminrole role:@Mods/rolereactionbot listadminrolesadminShow who can manage posts.
What it needs
Requiredwithout these the bot cannot do its job
- View ChannelsSees the channel the post lives in.
- Send MessagesPosts and confirms.
- Embed LinksThe role post is an embed.
- Add ReactionsPuts each emoji on the post so members have something to tap.
- Read Message HistoryFinds and updates the post by its ID.
- Manage RolesHands out and removes the roles. Its own role must sit above every role it manages.
Optionaleach one switches on an extra part
- Manage MessagesRemoves each member's reaction after toggling their role, so the post stays tidy. Without it the reactions pile up, but roles still work.
Reads: nothing privileged. It never sees message content or your member list.