Core

The CMS Core maintains common utility functions and push event handling.

Looking for VPS, web, or dedicated hosting? Check out our official server hosting!

This resource does nothing on its own and is simply a dependency for other resources.

Installation

1. Download the Resource

Click here to download the core resource.

2. Install the Resource

Extract the [sonorancms] folder into your server's resources folder.

3. Configure and Rename

Open sonorancms\config.CHANGEME.lua, update the values, then save it as config.lua.

Default configuration is below:

Configuration Details

Config Option Description

Config Option	Description
APIKey	API Key found in the API Integration section of the Administrative Panel
CommID	Community ID found in the API Integration section of the Administrative Panel
allowAutoUpdate	When enabled, the resource will update itself. When disabled, it will simply show an update notification every 2 hours.
debug_mode	When set to `true`, useful debugging information it outputted to the console. Keep disabled in production due to console spam.
apiUrl	Default: `https://api.sonorancms.com/`
apiIdType	Type of api ID the core script should be searching for: `discord`, `steam`, `license`, etc.
serverId	Default: `1` - ID of the Sonoran CMS server that this core resource should be tied to.
framework	`none`, `qb-core`, or `esx`
MaxInventorySlots	If using framework: `qb-core` you can specify the max inventory slots your inventory resource supports, this is for inventory management via the Game Panel's within Sonoran CMS.
restartWithPlayers	When set to `true`, it will auto-update the resource and restart it even if players are present on the server.

APIKey

API Key found in the API Integration section of the Administrative Panel

CommID

Community ID found in the API Integration section of the Administrative Panel

allowAutoUpdate

When enabled, the resource will update itself. When disabled, it will simply show an update notification every 2 hours.

debug_mode

When set to true, useful debugging information it outputted to the console. Keep disabled in production due to console spam.

apiUrl

Default: https://api.sonorancms.com/

apiIdType

Type of api ID the core script should be searching for: discord, steam, license, etc.

serverId

Default: 1 - ID of the Sonoran CMS server that this core resource should be tied to.

framework

none, qb-core, or esx

MaxInventorySlots

If using framework: qb-core you can specify the max inventory slots your inventory resource supports, this is for inventory management via the Game Panel's within Sonoran CMS.

restartWithPlayers

When set to true, it will auto-update the resource and restart it even if players are present on the server.

4. Server Config

Add the following to your server.cfg

It is very important that the sonorancms_updatehelper resource is not started manually. Doing so may cause a server crash if updates are available due to a race condition.

DO NOT start the whole [sonorancms] folder as that will also start the sonorancms_updatehelper which might cause crashing if it is started manually.

Example of what not to do: ensure [sonorancms]

ensure sonorancms

# permissions for SonoranCMS auto-updater (REQUIRED)
add_ace resource.sonorancms command allow
add_ace resource.sonorancms_updatehelper command allow

Submodules

The CMS Core resource comes with a variety of submodules included by default. These handle a variety of features such as whitelisting, permission synchronization, and more.

You can view the submodules and our guides for configuring them here.

Updates

Sonoran CMS's core will automatically update with the latest features, fixes, and changes!

Troubleshooting

Server Crashes

Check to make sure sonorancms_updatehelper is not being started in your server.cfg.

It is very important that the sonorancms_updatehelper resource is not started manually. Doing so may cause a server crash if updates are available due to a race condition.

Ensure your resource is up-to-date and download the latest release.

CMS updates are released often. Make sure your server is running on the latest release.

Ensure your API ID is set correctly.

If your community is using recommended Discord integration, ensure your Discord account is linked.

For other methods (Steam, FiveM License, etc.) ensure you have set your API ID in the CMS using the API ID that your community is looking for.

Yarn Error

Some users will see this in their server console:

[ script:yarn] Error: [yarn] error @discordjs/collection@1.5.3: The engine "node" is incompatible with this module. Expected version ">=16.11.0". Got "16.9.1"
[ script:yarn] Error: [yarn] error Found incompatible module.
[ script:yarn] [yarn] info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command.
[ citizen-server-impl] Building resource sonorancms failed.
[ citizen-server-impl] Error data: yarn failed!

In the case of this error, please locate the file named .yarn.installed, open it in any editor, then save it (without modifying anything).

This updates the "date modified" value for that file, which should then allow it to build correctly.

If you are having trouble with this, feel free to reach out to us, our support team will be happy to help you!

PreviousAvailable Resources NextCore Submodules

Last updated 7 days ago