💎 Bleed Booster Configuration

Bleed’s Booster Role system lets Server Boosters create personalized cosmetic roles while allowing the Owner to control where those roles sit, what names they may use, how many can exist, and what additional rewards boosting provides.

Administrative configuration requires Manage Guild and/or Manage Roles and should remain Owner-only. Booster-facing customization commands can remain available to eligible Boosters.

🏛️ Base Role Position

,boosterrole base [role]

Sets the base role that custom Booster roles will appear beneath.

This is one of the most important settings.

🔐 Keep Booster roles beneath all staff, moderation, access-control, and administrative roles.

🔢 Booster Role Limits

,boosterrole limit [limit]

Sets the maximum number of Booster roles allowed.

,boosterrole list

Displays all existing Booster roles.

,boosterrole cleanup

Removes unused Booster roles.

Use cleanup periodically to prevent abandoned cosmetic roles from cluttering the server.

🎁 Booster Reward Role

,boosterrole award [role]

Sets a specific role automatically rewarded for boosting.

,boosterrole award view

Shows the current reward role.

,boosterrole award unset

Removes the configured Booster reward.

Keep reward roles cosmetic or community-oriented rather than giving moderation authority.

🚫 Role Name Filtering

,boosterrole filter [word]

Blacklists a word from being used in custom Booster role names.

,boosterrole filter list

Displays currently blacklisted words.

Use this to prevent:

• staff impersonation
• administrative titles
• offensive names
• misleading authority claims
• inappropriate role names

Consider blocking terms such as Owner, Admin, Moderator, and official staff titles.

🤝 Shared Booster Roles

Bleed allows Boosters to share their custom roles with other members.

,boosterrole share max [number]

Limits how many people may share one Booster role.

,boosterrole share limit [number]

Limits how many shared Booster roles a member may join.

,boosterrole share list

Displays members currently sharing a Booster role.

,boosterrole link [member] [role]

Links an existing role to a member as their Booster role.

These settings should prevent excessive role clutter while still allowing cosmetic sharing.

💎 Booster-Facing Commands

Eligible Boosters may use commands such as:

,boosterrole — Create a custom role
,boosterrole color — Set role colors
,boosterrole random — Generate a random color
,boosterrole dominant — Match avatar color
,boosterrole rename — Rename their role
,boosterrole icon — Set an icon
,boosterrole remove — Remove their custom role
,boosterrole share — Share it with another member

🔐 Owner Principle

Booster roles are rewards, not authority.

They should never:

• outrank Custodians
• grant moderation permissions
• bypass verification or access controls
• imitate official positions
• create confusion about server authority

💎 Let Boosters personalize their place in Holme without altering who governs it.