Reaction Roles
Give members a role when they react to a message - either have Pixie build and post the message, or turn one you already have into reaction roles.
Permission
Every command on this page needs Manage Roles. Bare $reactionrole (also $rr, $reactionroles) lists the subcommands below.
1. Let Pixie make the message
$reactionrole create [#channel]Opens a builder - Title, Color, Set Body/Raw Body, and Set Image shape the embed. Nothing posts yet at this point, so style it however long you need.
Use Add to start attaching emoji→role bindings right away, in the same flow - each one you add shows up as a staged list on the builder ("Bindings (staged, N)") but nothing is posted or reacted on until you actually hit Post. That's the moment the message goes out, gets reacted with everything you staged, and starts being tracked.
Nothing is live until you press Post - you can set the title, add bindings, change your mind on the color, whatever, in any order, before that.
2. Use your own message
$reactionrole add
(reply to your message with:)
😀 @Role
🎨 @OtherRole
Also $reactionrole import (same command, just an alias). One emoji + role per line - a
- between them is optional. Reply to the same message again to add more bindings later.
Max 20 bindings per message (Discord's own cap on distinct reactions), and 50 tracked messages per
server.
Editing title/description/color only works for messages Pixie itself posted via create
- an imported message's original content can't be touched, only its emoji→role bindings.
Managing bindings
$reactionrole list (reply, or a message id)
$reactionrole remove <emoji> (reply, or a message id)
$reactionrole edit (reply, or a message id)
$reactionrole delete (reply, or a message id)
edit reopens the builder (only for Pixie-posted messages, same restriction as above).
delete stops managing the message and clears its reactions if Pixie has Manage Messages
there - the message itself isn't deleted.
Recovering a deleted message
If a reaction-role message gets deleted - by a mod, a purge, or its channel being deleted - its title/description/bindings are kept for 14 days.
$reactionrole trash
$reactionrole restore <id> [#channel]Also /reactionrole trash/restore. Restoring reposts it (into the original channel, or a different one if given) with all its bindings intact.