SYS.SETUP
> CHROMA5 — Installation & Configuration Guide
Follow these steps to get Chroma5 fully operational in your Discord server. Setting up the permissions system correctly is critical — it controls everything.
Invite Chroma5 to Your Server
Use the official invite link to add the bot to your Discord server. Chroma5 requires the following permissions to operate correctly:
- Manage Roles (required for all role operations)
- Kick Members (required for /kick command)
- Ban Members (required for /ban and /unban commands)
- Moderate Members (required for /mute command)
- Send Messages & Embed Links (required for responses and logging)
- View Channels (required to operate in channels)
- Read Message History (required for embed editing)
> IMPORTANT
Chroma5's role must be positioned above any role it needs to assign or remove. Drag the Chroma5 role to the top of your role list in Server Settings → Roles.
Set Up the Permissions System
Chroma5 uses its own permission engine on top of Discord. By default, only the server owner has access to all triggers. You must grant permissions to your staff roles.
Use /permission to delegate access:
/permission Add <trigger> <role_or_user>
Example: Grant your moderator role the ability to kick
/permission Add [Kick Permissions] [@Moderator]
Available triggers:
Configure Role Assignment Permissions
To let staff assign specific roles via /assignrole, configure the role permission matrix using /role permissions.
/role permissions Add <assignablerole> <roleoruser>
Example: Allow your staff role to assign the @Member role
/role permissions Add [@Member] [@Staff]
You can also grant Role Admin status, allowing a user or role to manage permissions for a specific assignable role — not full bot admin.
/role permissions Add <assignablerole> <roleoruser> roleadmin:True
Use /listroleperms to audit the entire permission matrix for your server at any time.
Enable Premium (Stripe Subscription)
Some features in Chroma5 (such as Mass TempRole and Embed Creator) require an active premium subscription. Subscribe directly through Discord:
/subscribe
Starts a $7.99/month Stripe subscription linked to your server
After a successful payment, premium features are automatically unlocked for your server. The subscription is tied to the Discord user who ran /subscribe.
To cancel:
/unsubscribe
Must be run by the original subscriber
IMPORTANT
Only one active subscription is allowed per server. If a subscription exists, other users will not be able to subscribe until the owner unsubscribes.
Set Up Role Requests (Optional)
Chroma5 supports a role request channel where members can request specific roles that are then approved by staff.
- Create a dedicated channel (e.g. #role-requests)
- Use /setrequestchannel to configure it
- Members can then use /rolerequest to submit a role request
- Staff with the Manage Role Permissions trigger can approve or deny
> SETUP_COMPLETE
Bot is configured — now what?
Browse the full command reference to explore every available command, its parameters, and required permissions.
View Command Reference