roles.

use the toggle when the desired result depends on the member’s current state, or use the explicit add and remove forms when a script or staff procedure should always mean one thing. all three require manage roles. havoc records changes as moderation cases and refuses a role it cannot safely manage.

,role add @river "Event Team"
,role @river Announcements
/role remove member: @river role: Announcements

quote a role name containing spaces in prefix commands. role restore skips roles that were deleted, became managed, or moved above havoc; its summary reports restored and skipped counts.

a temporary role has a saved expiry, survives a restart, and follows the member if they leave and return before it expires. durations accept havoc’s normal duration text and are capped at one year. listing the records is useful before extending or replacing a grant.

the same member-role pair cannot be both temporary and sticky. remove the sticky configuration before removing that role manually. adding a normal permanent role also clears an existing temporary expiry for that pair, preventing a later scheduled job from taking the permanent grant away.

bulk jobs cover humans, bots, or everyone who already has a source role. each add form has a matching remove form. these commands require both manage roles and manage server.

::--no-roles

only include accounts whose only role is @everyone.

::--joined-today

only include accounts that joined during the last 24 hours.

created roles start with no permissions. that makes role create suitable for labels and self-assignable groups without silently creating staff access. colors are hexadecimal values such as #5865f2.

gradient colors and role icons depend on server features. icons must be a png, jpeg, or webp from discord’s cdn and no larger than 256 kib. toggles use the role’s current value, so check the role after running them if another administrator may be editing it at the same time.

autoroles apply to every new member. sticky roles are different: they remember a role for one particular member and restore it after removal or rejoin. autoroles reject privileged roles, including roles whose channel overwrites grant moderation powers.

changing autorole configuration affects future joins; it does not backfill existing members. use an appropriate bulk command when existing accounts should receive the same role.

,buttonrole setup
,buttonrole add https://discord.com/channels/123/456/789 Announcements primary none "Announcements"
,buttonrole list
,buttonrole remove https://discord.com/channels/123/456/789 1

one panel supports at most 25 buttons and cannot mix havoc role buttons with unrelated components. buttons return after a bot restart because their configuration is persistent.

reaction roles can use the message made by reactionrole setup or another readable message. adding the reaction grants the role and removing it takes the role away. a message supports at most 20 configured reaction roles.