RO

Discord bots · Discord bot

RoleReactionBot

React to an emoji, get a role. Build the post with a form and edit it any time.

LiveDiscord

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

  1. Invite the bot. 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 addadminrole. The server owner can skip this.
  3. 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 help

    List every command.

    e.g./rolereactionbot help

For admins

  • /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.

    e.g./rolereaction createpost channel:#roles

  • /rolereaction addroleadmin

    Add an emoji and role pair to an existing post.

    e.g./rolereaction addrole message_id:1398035064557801522 emoji:🎮 role:@Gamer

  • /rolereaction removeroleadmin

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

    e.g./rolereaction removerole message_id:1398035064557801522 role:@Gamer

  • /rolereaction editpostadmin

    Open 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 deletepostadmin

    Delete a post and everything stored about it.

    e.g./rolereaction deletepost message_id:1398035064557801522

  • /rolereactionbot addadminroleadmin

    Let a role manage reaction posts. Administrators only.

    e.g./rolereactionbot addadminrole role:@Mods

  • /rolereactionbot removeadminroleadmin

    Revoke that.

    e.g./rolereactionbot removeadminrole role:@Mods

  • /rolereactionbot listadminrolesadmin

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