Ace Permission Sync
Manage in-game player permissions right from the CMS!
This resource utilizes API endpoints that require the standard version of Sonoran CMS or higher. For more information, view our pricing page.
You must have the Plus version of Sonoran CMS or higher to utilize the push event functionality for live in-game syncing.
This resource manages player's in-game permissions right from the CMS!
Sonoran CMS - ACE Permission Sync
Add the following to your
server.cfg (if you don't permissions won't be able to be granted)add_ace resource.cms_ace_perms command allow
Config Option | Description |
|---|---|
primary_identifier | Default: license2
Controls which type of API ID is used by the script.
Options: fivem, discord, steam, license2, license |
offline_cache | Default: true
Whether the server should cache permissions in case of CMS backend failure. |
rank_mapping | A table of rank UUIDs that equal different Ace Permission groups. |
apiUrl | Default: https://api.sonorancms.com Change to https://cmsapi.dev.sonoransoftware.com if using the development environment of Sonoran CMS |
When a player joins the server, the resource will ask the CMS for the players ranks. ACE permissions will be assigned based on the configuration.
Due to restrictions in the way that some resources like vMenu are programmed, you must relog for the CMS permissions to take effect if they are altered for a user while they are online.
For communities on the Plus plan or higher, permissions can be synced instantly in-game when ranks are updated.
Simply add your FiveM server's public IP address and port under Admin > Advanced > API Integration > Servers.
Due to restrictions in the way that some resources like vMenu are programmed, you must relog for the CMS permissions to take effect if they are altered for a user while they are online.
Individual players can run the
/refreshpermissionscommand in-game to force a permissions update.
Config = {}
-- General Configuration Section --
Config.configuration_version = 1.0
Config.primary_identifier = "license2" -- The primary identifier to use, options are: license, fivem, steam, discord
Config.rank_mapping = {
["9dd1fea1-2360-4be2-923b-71b0c87944d0"] = "group.admin", -- Admins
["93d1aea6-2340-6b32-923b-71b7c857eaf0"] = "group.mod", -- Moderators
["94f3faef-2340-6b41-931f-73fca343fbe0"] = "group.policesup", -- Police Department Supervisors
["45334fae-4532-4f42-feab-71bffea43450"] = "group.police", -- Police Department Officers
}
Config.offline_cache = true -- If set to true role permissions will be cached on the server in-case CMS goes down, the
-- cache will be updated everytime the player rejoins, the rank refresh command is run, or has a rank change in CMS
Config.apiUrl = "https://api.sonorancms.com"
d
This example is just an example of how you may setup ace permissions and it is unlikely to work just copy and pasted.
### Ace Permissions
## Inheritance
add_principal group.admin group.mod
add_principal group.policesup group.police
## Permissions
add_ace group.admin command allow
add_ace group.mod admin.kick allow
add_ace group.policesup police.supcar allow
add_ace group.police police.car allow
In the event that the CMS API is temporarily unavailable, this resource utilizes a local backup cache. The resource will automatically fall back to the latest saved version of the permissions list, allowing members to access permissions as normal.
Last modified 2mo ago