Docs / Community
Role menus
Members pick their own roles from reactions, buttons or a dropdown.
Reaction roles: ,rr add <message link> 🎮 @Gamer gives the role to anyone who reacts with 🎮 on that message.
,rr unique <message link> makes it pick-one, so choosing a new role takes away the other: handy for colour roles.
Button roles: ,buttonrole post #roles <text> posts a message, then ,buttonrole add <link> @role [label] adds a
button. Clicking again removes the role.
Dropdown roles: ,dropdownrole post #roles <text> posts a message, then ,dropdownrole add <link> @role 🔴 Red |
a red name adds an option (the emoji, name and small description are optional). Members open the menu and pick;
unpicking a role takes it away. ,dropdownrole limit <link> 0 1 makes it pick-one, ,dropdownrole placeholder sets
the grey text, and ,dropdownrole remove / clear take options off. Up to 25 roles per menu.
Join roles: ,joinroles add @Member gives a role to everyone who joins.
All of these are also on one slash command: /autorole buttonrole, /autorole reactionrole, /autorole dropdownrole
and /autorole join.
Roles with mod or admin permissions can never be handed out this way. If a role can't be given (Armr's role is too low, it was deleted or it gained admin powers), staff get a note in the mod log saying what to fix.
Commands
,reactionrole | Let members pick roles by reacting to a message. |
,reactionrole add | Link an emoji on a message to a role, e.g. `,rr add <link> 🎮 Gamers`. |
,reactionrole clear | Remove every reaction role from a message. |
,reactionrole list | Show every reaction role in this server. |
,reactionrole remove | Remove one emoji's reaction role from a message. |
,reactionrole unique | Turn pick-one on or off for a message: picking a role takes away the others from it (e.g. colours). |
,buttonrole | Buttons members click to get (or remove) a role. |
,buttonrole add | Add a role button to one of my messages. |
,buttonrole list | Show every message with role buttons. |
,buttonrole post | Post a message to put role buttons on. |
,buttonrole remove | Remove one role button from a message. |
,dropdownrole | A menu members open to pick their roles. Slash: `/autorole dropdownrole`. |
,dropdownrole add | Add a role to the menu on one of my messages (makes the menu if there isn't one), |
,dropdownrole clear | Take the whole menu off a message. |
,dropdownrole limit | How many roles members must and can pick, e.g. `,dropdownrole limit <link> 0 1` for pick-one. |
,dropdownrole list | Show every message with a role menu. |
,dropdownrole placeholder | The grey text in the closed menu (empty: "Pick your roles…"). |
,dropdownrole post | Post a message to put a role menu on, e.g. `,dropdownrole post #roles Pick your pings`. |
,dropdownrole remove | Take one role out of a menu. |