Skip to main content

​
Overview

Booster roles allow server boosters to create and customize their own personal roles with custom colors, names, and icons. Boosters can also share their roles with other members, creating a unique reward system for your most dedicated supporters.
Server administrators must set a base role before boosters can create their roles. The bot needs proper role hierarchy permissions to manage booster roles.

​
For Boosters

​
Creating & Managing Your Role

Create your custom booster role with optional colors.
~br create <name>
~br create <color> <name>
~br create <color1> <color2> <name>
Parameters:
  • name — Your role name (100 characters max)
  • color (optional) — Hex code or color name
  • color2 (optional) — Second color for gradient (requires server boost level)
Supported Colors:
  • Hex codes: #FF0000, #00FF00, #0099FF
  • Color names: red, blue, green, purple, pink, orange, yellow, crimson, gold, cyan, magenta, and 50+ more
You must be a server booster or have the configured base role to create a booster role.
Change your booster role’s color.
~br color <hex/color name>
~br colour <hex/color name>
Examples:
  • ~br color #5865F2 — Discord blurple
  • ~br color gold — Gold color
  • ~br color #FF69B4 — Hot pink
Rename your booster role.
~br name <new name>
~br rename <new name>
Cooldown: 60 seconds between renamesLimits: 100 characters maximum
Set a custom icon for your role (requires Level 2 boost).
~br icon <emoji/url>
Supported:
  • Unicode emojis: 🔥 ⭐ 💎
  • Custom Discord emojis
  • Direct image URLs (PNG, JPG, GIF)
Role icons require the server to be boosted to Level 2 or higher.
Delete your booster role.
~br remove
~br delete
This action is permanent and cannot be undone. The role will be completely deleted from the server.

​
Quick Color Options

Set your role color to match your avatar’s dominant color.
~br dominant
What It Does:
  • Analyzes your current avatar
  • Extracts the dominant color
  • Applies it to your booster role
Set a completely random color for your role.
~br random
Perfect For:
  • Quick color changes
  • Experimenting with different looks
  • Surprising yourself with new colors

​
Sharing Your Role

Share your booster role with another member.
~br share <user>
How It Works:
  1. You send a share request
  2. Target user gets an Accept/Decline prompt
  3. If accepted, they receive your role
  4. They can remove it anytime with br share remove
Cooldown: 2 seconds between shares
The target user must accept the request within 30 seconds.
See who has access to your booster role.
~br share list
Shows all members who are currently sharing your booster role.
Remove yourself from a shared booster role.
~br share remove <role>
Use This To:
  • Leave a shared role you no longer want
  • Free up a slot for other shared roles
  • Clean up your role list

​
For Administrators

​
Server Configuration

Set the base role that determines where booster roles are positioned.
~br base <role>
Important:
  • All new booster roles will be placed directly under this role
  • This role must be above where you want booster roles
  • Bot’s role must be above this base role
  • Required before boosters can create roles
Permissions: Administrator
Set maximum number of booster roles each user can create.
~br limit <number>
Typical Settings:
  • 1 — One role per booster (most common)
  • 2-3 — Multiple roles for customization
  • 5+ — Very generous servers
Permissions: Administrator
Set maximum members who can share a single booster role.
~br share max <number>
Purpose:
  • Prevents one role from being shared with too many people
  • Keeps booster roles feeling exclusive
  • Manages server role count
Permissions: Administrator
Set maximum shared roles each member can have.
~br share limit <number>
Purpose:
  • Prevents members from collecting too many shared roles
  • Keeps role lists manageable
  • Balances role distribution
Permissions: Administrator
View all booster roles in the server.
~br list
Shows:
  • All booster roles
  • Role owners
  • Numbered list for easy reference
Useful For:
  • Auditing booster roles
  • Finding specific roles
  • Managing server roles
Permissions: Administrator

​
Color Reference

Color NameHex CodePreview
red#ff0000🔴
blue#0000ff🔵
green#00ff00🟢
yellow#ffff00🟡
purple#800080🟣
pink#ff69b4🩷
orange#ffa500🟠
black#000000⚫
white#ffffff⚪
gray#808080⚪

​
Permission Requirements

For Boosters

Requirements:
  • Server Booster status OR configured base role
  • No special Discord permissions needed
Note: Admins can use all commands regardless of booster status

For Administrators

Requirements:
  • Administrator permission
Commands:
  • br base, br limit, br list
  • br share max, br share limit
  • br link

​
Bot Permissions

The bot needs these permissions to manage booster roles:

Manage Roles

Required to create, edit, and delete booster roles

Role Hierarchy

Bot’s role must be above the base role and all booster roles

View Channels

Required to respond to commands

​
Setup Guide

1

Invite the Bot

Make sure the bot is invited with Manage Roles permission
2

Position Bot Role

Drag the bot’s role above where you want booster roles to appear
3

Create Base Role

Create a role (e.g., “Server Booster”) and position it where booster roles should appear
4

Set Base Role

~br base @Server Booster
5

Configure Limits (Optional)

~br limit 1
~br share max 5
~br share limit 3
6

Test Creation

As a booster, test creating a role:
~br create crimson My Role

​
Usage Examples

# Create role with name only
~br create Awesome Member

# Create with hex color
~br create #5865F2 Discord Blue

# Create with color name
~br create gold Golden Role

​
Troubleshooting

Problem: “Base Role Not Set” errorSolution:
  1. Create a role for the base position
  2. Position it where booster roles should appear
  3. Set it with ~br base @role
  4. Ensure bot’s role is above it
Problem: “You Already Have A Booster Role”Solutions:
  • Remove your current role: ~br remove
  • Check configured limit: ~br limit
  • Admins can increase limit if needed
Problem: “Failed To Create Booster Role” or “Failed To Change Color”Solutions:
  • Verify bot has Manage Roles permission
  • Check bot’s role is above base role
  • Ensure bot’s role is above all booster roles
  • Check role name is under 100 characters
Problem: “This Server Doesn’t Have Role Icons Unlocked”Solution:
  • Server must be boosted to Level 2 (7+ boosts)
  • Cannot be bypassed, it’s a Discord limitation
  • Tell your members to boost the server!
Problem: “Share Request Timed Out”Solutions:
  • Target user must click Accept/Decline within 30 seconds
  • Ask them to be ready before sending the request
  • Cooldown: wait 2 seconds between share attempts
Problem: “Has Reached The Maximum Of X Shared Booster Roles”Solutions:
  • User must remove some shared roles: ~br share remove @role
  • Admin can increase limit: ~br share limit <higher number>
  • Remove unused shared roles to free up slots
Problem: “Please Wait X Seconds Before Renaming Again”Solution:
  • 60-second cooldown between renames
  • Wait for cooldown to expire
  • This prevents spam and API abuse

​
Boost Level Requirements

Level 0

0-1 Boosts
  • ✅ Create booster roles
  • ✅ Customize colors
  • ✅ Set names
  • ❌ Role icons

Level 1

2+ Boosts
  • ✅ All Level 0 features
  • ✅ Animated server icon
  • ✅ Custom invite background
  • ❌ Role icons

Level 2+

7+ Boosts
  • ✅ All Level 1 features
  • ✅ Role icons unlocked
  • ✅ Server banner
  • ✅ 1080p screen share

Booster Messages

Send automatic thank you messages when members boost

Autorole

Automatically assign roles to boosters when they boost