MDA docs

Join & reaction roles

#Join roles

Setting What it does
Roles What everyone gets on join
Bot roles A separate set for bots
User specific A role for one account when they next join

/joinroles sync applies them to everyone already here, which is the fix for setting join roles up after the fact.

#Reaction roles

The bot posts a message, or you point it at one you wrote, then pair each emoji or button with a role.

Mode Behaviour
Toggle React to add, unreact to remove
Add only Once taken, the role stays
Unique Taking one removes the others in that group

Unique is what colour roles want: picking blue takes red away.

Buttons and reactions work the same underneath. Buttons avoid the reaction pile-up.

#Role connections

Gain role A, get role B. Lose A, lose B.

#Role persistence

Roles applied by a restrict or by automod come back if the member leaves and rejoins, so leaving cannot shed a mute. Ordinary roles are not persisted.