Skip to main content

​
Getting Started

Personalized booster roles allow your server’s boosters to create a custom role with their own name, color, and icon. This feature is a great way to reward your most loyal community members.

​
Requirements

  • Boost Tier 2: Your server must be at least Boost Tier 2 for this feature to be available.
  • Boosting: The user must be actively boosting the server (or be the server owner).
1

Enable the system

Run the boosterrole setup command to enable the system in your server.
,boosterrole setup
2

Set a base role (Optional)

Use the boosterrole base command to set a role that booster roles will be positioned under. This ensures boosters don’t accidentally get permissions higher than intended.
,boosterrole base @Member

​
Managing your role

Once enabled, boosters can use the following commands to manage their custom role.

​
Creating a role

Create your personalized role with a name and optional hex colors. greed supports up to 3 colors for gradient roles on servers with enhanced color support. 
,boosterrole create (name) [color1] [color2] [color3]

,boosterrole create greed-fan #BCBCE3
,boosterrole create "Super Booster" #ff0000 #00ff00 #0000ff

​
Management Commands

​
Role Customization

Once your role is created, you can fine-tune it with these commands:
Change your role’s color. Support for single hex codes or dual-color gradients.
,br color #ff0000
,br color #ff0000 #0000ff
Update your role’s name at any time.
,br rename new name
Set a custom emoji or image as your role icon.
,br icon :emoji:
Run without an argument to reset the icon.
Choose whether your role is displayed separately from other members in the sidebar.
,br hoist on/off

​
Social Features

You can grant your personalized booster role to friends!
,br share @user
By default, users can share their role with up to 5 people.

​
Administrative Commands

Commands for server staff to manage the booster role system globally.

​
System Management

Set a “base” role that all booster roles will be positioned below in the hierarchy.
  • Set base: ,br base @Role
  • Sync positions: ,br sync (Ensures all booster roles are correctly ordered below the base)
Prevent users from using specific words in their role names.
,br filter add (word)
  • ,br list: Check how many booster roles exist and who owns them.

​
Advanced Settings

Fine-tune the system behavior with these administrative subcommands.
Set a “base” role that all booster roles will be positioned below in the hierarchy.
  • ,settings baserole @Role
Automatically grant specific roles to users when they start boosting and remove them when they stop.
  • Add award: ,settings award add @Role
  • View awards: ,settings award list
  • Remove award: ,settings award remove @Role
Use ,br setup for the initial configuration. Remember that greed requires Manage Roles permissions to manage booster roles.
  • ,boosterrole delete [user]: Delete your own booster role or a specific user’s booster role.
  • ,boosterrole disable: Turn off the booster role system entirely.
Use ,boosterrole filter to manage a list of prohibited words for booster role names.