Submodule Troubleshooting
View some basic troubleshooting steps when activating Sonoran CAD submodules.
Core Commands
Sonoran CAD's core includes powerful built-in commands. These commands are entered into your server console.
Ex: A support member may ask you to send detailed logging information to them. They will give you the specific ID number to enter. (ex: 123)
Entering sonoran support 123
in your server console will send your plugin configuration directly to our support application.
Command
Description
sonoran debugmode
Enables detailed debug logging
sonoran info
Displays version and config information
sonoran support <NUMBER>
Sends important information for customer support purposes.
The NUMBER parameter will be provided to you by a support team member.
Ex: sonoran support 123
sends us your plugin information for help.
sonoran plugin <NAME>
Displays plugin information
Ex: sonoran plugin callcommands
Quick Checks
1. Ensure your community is on a paid version.
Your community's subscription may have expired and failed to renew. Do a quick check on your community limits to make sure your community version includes the submodule you are trying to install.
2. Ensure your submodule is enabled
Be sure to follow the core installation and submodule activation guides thoroughly, depending on the specific submodule you are trying to activate.
Make sure you have not forgotten to enable the submodule in the plugin config file!
Enter sonoran info
into your server console.

If the submodule you are having trouble with is listed as DISABLED, you may have forgotten to enable it in the submodule configuration.

3. Ensure your API ID is set correctly.
Ensure you have set your API ID in the CAD using the value from the API ID submodule.
Debug Mode
The SonoranCAD core includes a powerful debug mode. Enable this by entering sonoran debugmode
into your server console.
Debug mode will print out additional error information and JSON data for all API calls or push events.
1. Check your API ID:
For plugins that require your individual CAD user account to have the API ID set (live map, unit locations, panic, etc.) you can view this data in the console output.
The image below shows an API Call being made from the server to Sonoran CAD. This API call is type UNIT_LOCATION
and includes all the data necessary.
Ensure the APIID
listed in the API call matches the API ID set in your CAD's user account.

2. Check the Community ID and API Key
Your community ID and API key is also listed in the debug API call information. Be sure that the community ID and API key are correct.
Still Having Trouble?
If you're still having trouble, our dedicated support team is here to help.
Reach out to us and generate a support ticket at any time.
Common Errors
Error: Ensure config.json is present
Your framework or plugin config is not correctly named config.json
. Ensure that is has been spelt correctly, is not config.json.json
, etc.
You may need to open the file in a text editor to more easily see the file extension, and ensure that it is correctly named as config.json
.
Community Has Been API Blacklisted
The CAD backend will temporarily "blacklist" (deny) all API calls if multiple requests are made with an invalid format.
Causes
Third-party or custom integration scripts may not be utilizing our API correctly. Try disabling them to rule out the issue.
A bug with one of our FiveM submodules.
Diagnosis
Enable debug mode on your FiveM server by entering the server command
sonoran debugmode
. All API calls made will have the full JSON payload printed in your server console.Wait for your next API blacklist notice. In your server console, you should see multiple failed/errored API calls at the same time as your blacklist. The JSON will show the full, bad data being sent to Sonoran CAD. Based on the
type
of these API calls, you can narrow down the source to a third-party/custom script or one of our FiveM submodules.If the bad API calls leading to the blacklist appear to be from an official Sonoran CAD submodule, reach out to our support team.
Last updated
Was this helpful?