Skip to main content

​
Overview

Boosters get a role of their own — their name, their color, their icon — and manage it without needing staff to touch anything. Server owners keep control through limits, a base position, and a word filter.
Confine needs Manage Roles, and its own role has to sit above where booster roles land.

​
Server setup

​
Base role

Booster roles get positioned just beneath a role you nominate. Everything created afterward slots in under it.
Put the base role above any colored roles in your list. Discord shows whichever color sits highest, so a booster’s custom color gets hidden otherwise.

​
Server limit

Caps how many booster roles can exist at once. Defaults to 50.

​
Award role

Hands a role to members the moment they boost, separate from their custom booster role.
Check it with ,boosterrole award view, clear it with ,boosterrole award unset.

​
Name filter

Block words from appearing in booster role names. The command toggles — running it on a word already filtered removes it.
,boosterrole filter list shows everything currently blocked.
All four of the above require Manage Server.

​
Creating a role

Colors accept a hex code (#ff0000 or ff0000) or one of these names: default · white · aqua · green · blue · yellow · purple · fuchsia · gold · orange · red · grey · navy

​
Gradients

Pass two colors and the role gets a gradient between them.
Gradients need Discord’s Enhanced Role Colors feature on your server. Without it, confine rejects the second color.

​
Customizing

,boosterrole random picks one at random — handy if you can’t decide.
Filtered words apply here too.
Attaching an image to the message works as well.
Role icons require your server to be Level 2. Images must be hosted on Discord’s CDN, and cap out at 1MB.
,boosterrole delete removes your role entirely, along with anyone you’d shared it with. ,boosterrole remove does the same.

​
Sharing your role

Let other members wear your booster role.
Staff can cap how many booster roles a single member accumulates across the server:
share limit requires Manage Server.

​
Staff Tools

Assign an already-made role as someone’s booster role instead of creating a new one.
The member has to be actively boosting.
,boosterrole list pages through all booster roles with their owners.
,boosterrole cleanup clears out roles nobody’s wearing anymore and database entries pointing at roles that no longer exist. Rate limited to once a minute.

​
Automatic behavior

Confine handles two things on its own: when a booster leaves the server, their role is deleted, and when someone starts boosting, your award role is applied.