Chroma FiveM API
FiveM / RedM ACE permission sync, driven by Discord roles
Chroma FiveM API connects Discord role state to your FiveM or RedM server. The Discord bot stores role records, ACE mappings, license state, and role recovery history, allowing your server to pull permissions from a stable API layer instead of live Discord requests.
Role Sync Engine
The bot keeps a live API-side record of each member's Discord roles, then your FiveM resource can consume those records without hammering Discord's API.
- Automatic role updates when a member's Discord roles change
- Initial guild import when the bot joins a server
- /syncmembertoapi for targeted member refreshes
- /syncallmemberstoapi for full server refreshes
- Members are archived when they leave or are banned
ACE Permission Mapping
Map Discord roles to FiveM ACE groups and individual ACE permissions from Discord. Server staff can update role mappings without directly editing server files.
- /ace set opens a modal for group and ACE values
- /ace list audits every role mapping configured for the guild
- Groups are entered as comma-separated values such as admin,mod
- ACE entries are stored per Discord role and guild
- Run chromaapireload in the server console after changes
Server Keys & Licensing
Each active guild receives a license-backed server key that the FiveM or RedM resource uses to authenticate against the API.
- /generate_server_key creates a 64-character secure server key
- Server keys are shown once and should be stored immediately
- Parent guilds can share a key with linked slave guilds
- /link_slave_guild links another Discord guild to the parent license
- License state is refreshed from the database every 5 minutes
- Guild owner and guild_admin access protect key generation
Role Recovery
When a member leaves, their last saved role set is archived. Staff can review the old record and restore roles with an approval button.
- /userroles checks the API record for current or archived members
- /reassignroles restores roles from a member's most recent archived record
- /reassignrolesfrom transfers an old member record to a new Discord member
- Buttons require explicit confirmation before roles are applied
- Archived role records include the time the member left
- Recovery actions are logged to the configured webhook
Permission Delegation
Chroma FiveM API uses a database-backed permission trigger system, letting owners delegate API operations without granting blanket Discord administrator access.
- /permission grants or removes access for a role or member
- /list_permissions shows the guild's configured trigger matrix
- Guild owner is appended to protected command access checks
- guild_admin grants elevated API management access
- Global admin and global trigger rows are supported in the backend
- Every permission update is logged for audit visibility
Subscription Billing
Guild subscriptions are handled through Stripe, then delivered back into the API database so licenses activate automatically.
- /subscribe starts the Chroma Discord Perms API subscription
- Checkout metadata ties the subscription to bot, guild, and subscriber
- /unsubscribe cancels the Stripe subscription and clears guild subscription fields
- /about shows license expiration, subscriber, support links, and resource purchase link
- Billing manager link is available after subscription setup
Ready to connect your FiveM server?
Install the Discord bot, subscribe the guild, generate your server key, then configure ACE mappings for the FiveM resource.