Booster Roles
Give your boosters the ability to create and manage their own personalized roles.
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).
- Bot Permission: greed requires the Manage Roles permission in your server.
- Role Hierarchy: greed's role must be above any booster roles it creates for the feature to work.
Limits
- Default limit: 50 booster roles per server.
- Premium Tier 2: 150 booster roles per server.
- Premium Tier 3: 250 booster roles per server.
- Share limit: By default, users can share their role with up to 5 people.
Enable the system
Run the boosterrole setup command to enable the system in your server.
,boosterrole setup
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. You can customize the color, icon, and other properties after creation.
,boosterrole create (name)
Management Commands
Role Customization
Once your role is created, you can fine-tune it with these commands:
Social Features
Administrative Commands
Commands for server staff to manage the booster role system globally.
System Management
Role Limits
Control how many booster roles can exist in your server.
,boosterrole limit (max)
Booster Awards
Automatically grant roles to users when they start boosting and remove them when they stop.
Use ,boosterrole setup for the initial configuration. Remember that greed requires Manage Roles permissions to manage booster roles.
Deleting booster roles
To delete your own booster role:
,boosterrole delete
To disable the entire booster role system:
,boosterrole disable
Advanced Sharing Features
Members can share their booster role with others and manage those shares.
Advanced Role Assignment
Associate an existing role as a member's booster role (bypass creation):
,boosterrole include (role) (member)
If a booster loses their active boost status, their booster role is automatically deleted. Make sure boosters understand this before they invest time customizing their role.
Use ,boosterrole filter add and ,boosterrole filter remove to manage a list of prohibited words for booster role names. Filters are case-insensitive and match any role name containing the filtered word.