// hunnaG / bots / rolereactionbot

RoleReactionBot

Let members pick their own roles by reacting with an emoji, on a tidy post you build with a form, and give every newcomer a starting role.

Released · Updating (Slowly)Discord botDiscord

Roles are how a Discord server sorts its members: they can give a name a colour, open up channels, or decide who gets pinged. RoleReactionBot lets members choose their own, such as the games they play, their region, or which announcements they want, by reacting to a post.

  • React with an emoji to get a role, and react again to drop it.
  • The bot removes each reaction straight away, so the post never fills up and the list stays easy to read.
  • Build the post through a form and a role picker, and change it any time.
  • Optionally, give everyone who joins a starting role, such as Member. Turn on that role’s “Display role members separately” setting and your members show under it in the member list, apart from the bots.
First five minutes
  1. Add it. It needs Manage Roles, and in your server settings its own role must sit above every role it hands out.
  2. Optionally, as an administrator, let a role manage posts with /rolereactionbot admins add role:@Mods. The owner and administrators already can.
  3. Run /rolereaction createpost channel:#roles and fill in the form: title, description, color.
  4. Add each emoji and role pair with the 'Add a role' button under the confirmation, or /rolereaction addrole.
  5. Members react to get the role and react again to drop it; the bot clears their reaction each time.
  6. Optionally, give every new member a role with /rolereaction autorole set role:@Member. Add current_members:True to give it to everyone already here too.
Good to know

It uses one of Discord’s privileged intents, the extra access to message text, member lists and online status that a bot has to ask Discord for: Members, for the auto-role alone. That is how it hears that someone joined, and it stores nothing about them. A role with moderation permissions can’t be the auto-role, since everyone who joins would get it. Posts can be changed later with /rolereaction editpost and /rolereaction addrole. A post’s ID comes from “Copy Message ID” in Discord’s message menu, with Developer Mode on.

Need help? Ask in the hunnaG Discord.

Commands

Anyone can use the first group. The second is for the people who run the server.

For everyone

  • /rolereactionbot admins list

    Who may manage reaction posts here.

    you/rolereactionbot admins listRoleReactionBotRoleReactionBot admin roles The server owner, administrators, and @Mods How it works: Admins run the admin commands. The owner and administrators always can, and they change this list with /rolereactionbot admins add and /rolereactionbot admins remove. Made by @hunnaGOnly you can see this · Dismiss message
  • /rolereactionbot info

    The build, the links, a check of the permissions it has here (including whether its role sits above the roles on its posts), and this server's setup. Same on every hunnaG bot.

    you/rolereactionbot infoRoleReactionBotRoleReactionBot React to an emoji, get a role. Build the post with a form and edit it any time. Hub page · Terms · Privacy · Invite · Invite with every feature Build: 3f2a1c9 · 2026-10-08 · up 2d 4h · in 3 servers Permissions here: ✅ View Channels · ✅ Send Messages · ✅ Embed Links · ✅ Add Reactions · ✅ Read Message History · ✅ Manage Roles · ✅ Manage Messages (optional) · ✅ The bot's role sits above every role on its posts here. · Privileged intents: Server Members This server: Admins: the server owner, administrators, and @Mods · Reaction posts here: 2, with 7 emoji and role pairs · Auto-role for new members: @Member Made by @hunnaGOnly you can see this · Dismiss message
  • /rolereactionbot help

    Every command, grouped by who can use it.

    you/rolereactionbot helpRoleReactionBotRoleReactionBot help For admins · Setup, owner and administrators · For everyone: one line per command For members: react to a post to get the role, react again to drop it. The bot clears your reaction each time. Made by @hunnaGOnly you can see this · Dismiss message

For admins

  • /rolereaction autorole setadmin

    Give a role to every member who joins. In a server with rules screening they get it once they accept the rules, so it never lets anyone skip them. Bots never get it. Set current_members to give it to everyone already here too.

    you/rolereaction autorole set role:@Member current_members:TrueRoleReactionBot✅ Everyone who joins now gets @Member; anyone still in rules screening gets it once they accept the rules. Bots never do. Turn it off with /rolereaction autorole off. Giving @Member to the members already here; I'll say when it's done. Done: 41 member(s) got @Member.Only you can see this · Dismiss message
  • /rolereaction autorole offadmin

    Stop giving the role to new members. Members who have it keep it.

    you/rolereaction autorole offRoleReactionBot✅ New members no longer get a role from me. Members who have it keep it.Only you can see this · Dismiss message
  • /rolereaction createpostadmin

    Pick 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.

    you/rolereaction createpost channel:#rolesRoleReactionBot(a form: Title, Description, Color) Post created in #roles. Its message ID is 1398035064557801522. Add emoji/role pairs with /rolereaction addrole 1398035064557801522 <emoji> <role>, or use the button below. [ ➕ Add a role ]Only you can see this · Dismiss message
  • /rolereaction addroleadmin

    Add an emoji and role pair to an existing post.

    you/rolereaction addrole message_id:1398035064557801522 emoji:🎮 role:@GamerRoleReactionBotAdded 🎮 for role @Gamer to the post.Only you can see this · Dismiss message
  • /rolereaction removeroleadmin

    Remove a role from a post, along with its reaction.

    you/rolereaction removerole message_id:1398035064557801522 role:@GamerRoleReactionBotRemoved role @Gamer from the post.Only you can see this · Dismiss message
  • /rolereaction editpostadmin

    Open a form, pre-filled with the current values, to change a post's title, description, or color.

    you/rolereaction editpost message_id:1398035064557801522RoleReactionBot(the same form, filled in with the post's current title, description and color) Post updated successfully.Only you can see this · Dismiss message
  • /rolereaction deletepostadmin

    Delete a post and everything stored about it.

    you/rolereaction deletepost message_id:1398035064557801522RoleReactionBotSuccessfully deleted the post and its data.Only you can see this · Dismiss message
  • /rolereactionbot admins addadmin

    Let a role manage reaction posts. The owner and administrators always can, and only they can change this. Same on every hunnaG bot.

    you/rolereactionbot admins add role:@ModsRoleReactionBot✅ @Mods can now run RoleReactionBot's admin commands here.Only you can see this · Dismiss message
  • /rolereactionbot admins removeadmin

    Revoke that.

    you/rolereactionbot admins remove role:@ModsRoleReactionBot✅ @Mods no longer runs RoleReactionBot's admin commands here.Only you can see this · Dismiss message
Try a command

Type a command the way you would in Discord. The replies are the bot's own; nothing is sent anywhere.

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: Server Members intent, the auto-role. It is how the bot hears that someone joined or accepted the rules, and how it finds the members already there when you ask. Nothing about members is stored. These are Discord's privileged intents, already switched on for this bot.

Log

What changed in RoleReactionBot, newest first. Every entry · RSS

  1. botsRoleReactionBot can give every new member a role as they join, with /rolereaction autorole.
    • /rolereaction autorole set picks the role. In a server with rules screening, members get it once they accept the rules, so it never lets anyone skip them. Bots never get it.
    • Give it to everyone already here too, with current_members:True.
    • /rolereaction autorole off stops it; members who have it keep it.
    • It now uses Discord’s Members intent, for this alone, and stores nothing about members.

// keys

Keyboard

jd
next entry
ka
previous entry
enterspace
open or close the focused entry
esc
close the focused entry, or this panel
/
find a project, a command, or a page
?
this panel

    ↑ ↓ to move · enter to open · esc to close