FiveM Installation
Sonoran CAD's Integration Core imports common API method wrappers and functionality. Installing our integration framework is easy! Learn more below.
Last updated
Sonoran CAD's Integration Core imports common API method wrappers and functionality. Installing our integration framework is easy! Learn more below.
Last updated
Sonoran CAD integration submodules require the standard version of Sonoran CAD or higher. For more information, see our pricing page.
Looking for VPS, web, or dedicated hosting? Check out our official server hosting! Sonoran Servers customers receive free submodule activation and 30% off their monthly CAD subscription!
Updating From v2.X.X or earlier? see our recommended update steps below
View our installation tutorial video for help on installing our framework.
Download a pre-configured version of the in-game integration resource from the panel. This download will already have your community ID and API Key in the config.lua
file in addition to file renaming done for you.
Navigate to Admin
-> Advanced
-> In-Game Integration
-> FiveM
Extract the .zip
file into your resources directory. Place the [sonorancad]
folder directly in the resources root directory.
In your server.cfg
file, add the following:
It is very important that the sonoran_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 [sonorancad] folder as that will also start the sonoran_updatehelper which might cause crashing if it is started manually. Example of not what to do ensure [sonorancad]
Modify the /configuration/config.lua
file for any additional configuration values.
The Sonoran CAD FiveM resources has multiple "submodules" for every integration feature. These are easily enabled and configured in the /configuration
folder.
Download the latest zip file from our Github.
Extract the .zip
file into your resources directory. Place the [sonorancad]
folder directly in the resources root directory.
If you already have the wk_wars2x
resource, please remove it from your resources folder and use the Sonoran version included with the framework download.
Open sonorancad\configuration\config.CHANGEME.json
, update the values, then save it as config.json
. Default configuration is below:
Option | Description |
---|---|
communityID | Your SonoranCAD Community ID. |
apiKey | API Key from your In-Game Integration settings. |
postTime | Update locations every x ms. Default 5000. It is recommend to not set this lower than 5000 ms due to rate limiting. |
serverId | If using multiple servers in Sonoran CAD, specify the ID here. |
primaryIdentifier | The identifier type your community uses in the CAD to enter their API IDs.
Valid values are: |
apiSendEnabled | When disabled, the integration will not send any API requests to SonoranCAD. |
debugMode | When set to |
updateBranch | Use this branch when checking for updates.
Keep |
statusLabels | Should match what you have set in your CAD's unit status code settings. |
allowAutoUpdate | When enabled, the resource will update itself. When disabled, it will simply show an update notification every 2 hours. |
autoUpdateUrl | Where to check for updated versions. Don't touch this unless you have a reason. |
allowUpdateWithPlayers | When enabled, it will run the updates even with players on the server. The updater will stop/start all associated resources which could cause client crashes. When disabled, the resource "waits" until there are no players. |
noUnitTimer | When set to |
enableCanary | When enabled, allows the CAD to update to beta (aka canary) releases. |
enablePushEventForwarding | Enables push event forwarding to the specific URL defined in the next option. NOTE: DO NOT ENABLE IF YOU DO NOT KNOW WHAT YOU ARE DOING (Used for custom development only!) |
pushEventForwardUrl | Web server URL to forward push events to. NOTE: DO NOT ENABLE IF YOU DO NOT KNOW WHAT YOU ARE DOING (Used for custom development only!) |
forceSetApiId | When enabled, the tablet resource will show an alert message stating they must set their API ID. |
disableOverride | By default, the framework will try and automatically correct your server's IP, port, and outgoing IP address if it detects something different.
Set this to |
For information regarding the bodycam script config values, please see our Bodycam Submodule Guide.
Add the following to your server.cfg
(if you don't want pNotify or wraith, leave those out):
It is very important that the sonoran_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 [sonorancad] folder as that will also start the sonoran_updatehelper which might cause crashing if it is started manually. Example of not what to do ensure [sonorancad]
Once completed please move to the Additional Configuration section to complete your setup
Starting with framework version 2.6.2, you can override any configuration option in your config.json
file by specifying a convar before the sonorancad resource starts.
This feature does not work with arrays (like statusLabels). Any other configuration option can be set using the sonoran_<configSettingHere>
format.
In the CAD admin panel, navigate to: Advanced > In-Game Integration Expand the "Server Events and Integrated Live Map" section.
Enter your server's public IP address and your game server's port. By default, this is port 30120
.
Set your game server port and IP address in the admin panel of Sonoran CAD. The map port can be left blank, unless you are also installing the integrated live map.
Learn more about configuring multiple servers.
You may wish to also send push events to another external web server, like a Discord bot.
In the framework configuration file, simply set enablePushEventForwarding
to true
and pushEventForwardUrl
to your web server address.
Check out our pre-bundled Submodule Configurationto make the integration useful.
For basic functionality, we recommend at least the locations
, callcommands
, and postals
submodules.
You can also view our standard submodule activation guide.
As of new installations, the configuration file has been renamed to prevent it being overwritten by updates. To use the radar for the first time, you must rename the file config.dist.lua
within the wk_wars2x
folder to config.lua
.
If your framework has the primaryIdentifier
set to steam
in the configuration (used for your API ID type), you'll need to ensure a Steam API key is set in your server.cfg
file.
You can register a new Steam API Key at http://steamcommunity.com/dev/apikey
Then, paste it into your server.cfg
Sonoran CAD's integration framework and submodules will automatically update with the latest features, fixes, and changes!
Or, run sonoran update
to instantly check and apply any updates for the framework core.
The Sonoran CAD integration framework comes with several commands. These commands can be run in your server console to provide information, update submodules , and more.
Command | Description |
---|---|
| Display list of commands |
| Run core/framework updater |
| Toggle debug mode on/off |
| Dump version info and configuration data |
| Dump information for support staff |
1. Check to make sure sonoran_updatehelper
or [sonorancad]
is not being started in your server.cfg.
It is very important that the sonoran_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 [sonorancad] folder as that will also start the sonoran_updatehelper which might cause crashing if it is started manually. Example of not what to do ensure [sonorancad]
2. Try updating your smartsigns submodule manually to the latest version. This is done by copying over the lua files from the latest release found here and overrideing the old files.
We have gotten isolated reports of servers crashing with the following error, this is assumed to be related to having lower end VPS hardware specs and txadmin rebooting the server because the update process is taking too long.
1.) Check that the file in question is actually present in the specified file path. To find the correct path please read the example below:
In this example, you would navigate to the sonorancad
resource, open the html
folder and ensure the file config.js
is present.
This is simply a WARNING, if the resource works AS EXPECTED, you can simply ignore the warning and continue
We recommend a full reinstall of the SonoranCAD Integration. You may copy over the contents of your plugin configuration files to the new submodule's configuration files. Ensure that the file name is not changed as the submodules use the same contents but different file names.
See the Installation steps above to reinstall