Custom Booster Roles

The second tab of Boost Messages & Roles, with its own switch. A booster claims one role, names it, colors it and gives it an icon from the chat; the role sits right above the server's Booster role, so its color is the one their name shows. Staff set the rules on the dashboard and see every role in one list.

1Setting it up

1. 1

   Switch it on

   Community → Boost Messages & Roles → the Custom Booster Roles tab.

2. 2

   Check the server

   The Server check card at the top says what is missing. Arclo needs Manage Roles, and its own role has to sit above the role booster roles are placed over (the Booster role, unless you pick another). Icons need boost level 2 and gradient and holographic colors need Discord's Enhanced Role Styles perk; both are extras, shown as locked until the server has them, and booster roles work without them.

3. 3

   Set the rules

   What members may change, the longest name, blocked words, the staff colors nobody may copy, how many friends a role can be shared with, and how long a role stays after the boost ends.

4. 4

   Tell your boosters

   /booster-role claim is all they need. With no name or color given, the role takes the default name (their display name, unless you changed it) and the default color. The Preview under New roles shows how that looks, with your own name.

Commands

Rules

Place new roles aboveThe Booster role by default

Every new booster role goes directly above this role. Its color then beats the Booster role's, which is the point of having one.

Also allowed to claim one

Members holding any of these roles may claim a booster role without boosting, for example a supporters or patrons role. They keep it for as long as they hold the role, with the same grace period when they lose it.

Names

Checked on the claim and on every rename. A name can't be longer than the server allows, can't hold a link or an invite, can't contain a blocked word, and (on by default) can't be the name of another role in the server, however it is spaced or spelled. Blocked words are matched as whole words with look-alike letters folded (Ädm1n reads as admin), and words of four letters or more are also caught hidden inside a longer name. Try a name on the page runs the same rules.

Protected colors

Pick your staff roles, and a booster role can't take their color or one that looks the same in the member list.

SharingOff by default

Switch it on and set Friends per role, how many members one booster can offer their role to (three to start, ten at most). The friend gets a message with Accept and No thanks and has the role only once they accept; the invite runs out after fifteen minutes. A role that carries any permission can never be shared.

Most booster roles

A cap of the server's own; leave it empty for none. Discord's limit of 250 roles applies whatever you set.

Blocked members

They can't claim or change a booster role, even while they boost. Pick a member to block them before they claim; picking someone who already has a role asks to remove it first, the same as Remove and block in the list.

When a boost ends

The role stays for the grace period you pick (a day by default, up to thirty), so a boost that lapses for a moment costs nobody their role. Boosting again inside it keeps the role as it is. Leaving the server ends a boost too. When the grace period runs out the role is deleted, and with Bring it back when they boost again on (the default) its name, colors and icon are kept, so the next boost makes the same role again. Arclo also checks every few minutes that each role's member is still boosting, which catches boosts that ended while Arclo was offline.

While Custom Booster Roles is switched off nothing is removed: roles that were due to go wait until it is back on.

Managing roles

The Booster roles card lists every role with its owner, colors and status (active, or when it goes). Remove role deletes it in Discord; Remove and block also stops that member claiming another until you unblock them under Who can claim. Deleting a booster role by hand in Discord does the same as Remove.

Logging

The Custom Booster Roles logger records roles claimed, changed, shared, unshared and deleted, boosts that ended (with when the role goes), boosts that came back in time, roles removed and restored, removals by staff, and anything Arclo could not do. Switch it on from the tab or from Logging.

Troubleshooting