Radar
Step-by-step installation guide, common issues & solutions, code snippets, error codes, config previews, locales previews, SQL previews, and changelogs; all in 1 easily accessible place.
This resource can be purchased as part of a bundle for a discount here.
Translate
INSTALLATION GUIDE
Step 0 - First Steps
1. Download your resource from FiveM’s Keymaster.
2. Unzip the cd_radar.zip folder and place this folder in your server's resource folder.
3. Add the resource to your server start config (server.cfg): ensure cd_radar. If you are using a framework, it must be placed anywhere below your framework resource e.g., es_extended, not above.
ensure es_extended
ensure cd_radarStep 1 - Fxmanifest
Depending on your framework and dependencies, you may need to make some changes inside the [cd_radar/fxmanifest.lua]. We have made this easier by commenting on the lines you possibly need to change.
Step 2 - Configure Resource
You MUST read all configurable options inside the [cd_radar/configs/config.lua] file and configure them to suit your server's needs. Please read the ”commented out help text” at the end of each line so you can understand what each config option does.
The most important sections are the options under the Framework and Important sections at the top of the config.lua. Everything else is optional.
Introducing our new 'auto_detect' feature! It automatically identifies your framework and SQL database resource, and applies the appropriate default settings.
Step 3 - Configure Key Binds
Before starting this resource on your main/live server, we highly advise configuring your key binds because this resource uses Fivem's Key Mapping.
Where can I configure my key binds?
You can configure key binds in the Keys and Commands section near the bottom of the [cd_radar/configs/config.lua].
Why do I need to do this?
Well long story short;- once a player has joined your server with this resource running you can no longer force change their key binds for this resource through the config.lua, only they can change it in the in-game pause menu settings. Although it will change for the players who join after you have changed it.
The benefit of this system is that it's much more optimised and players can easily change their key binds on keyboards or controllers. You can also check out the Default Keybinds for this resource.
OPTIONAL FEATURES
This section is to help you understand how the built-in features of this resource work, and if applicable, how you can make them compatible with other resources. These features are not required, they are optional and can be configured in the [configs/config.lua].
Vehicles Data
What is Vehicles Data used for?
When using ESX or QBCore we take information that most servers will already have stored to get the vehicles to display names of custom vehicles.
On ESX we will grab the vehicle's display names from the "vehicles" database table as this is very common in esx servers.
Multiple "vehicles" database tables
We were informed that some servers use multiple "vehicles" database tables for donator vehicles, emergency vehicles etc. So all you need to do is add the names of these database tables into the Config.VehiclesData.VehicleDatabase_TableNames in the config,lua.
On QBCore we will grab the vehicle's display names from the qb-core/shared.lua/QBShared.Vehicles as this is very common in QBCore servers.
If Config.VehiclesData is disabled, the script will get the vehicle's display names from the vehicle handling files vehicles.meta. Example: <gameName>Adder</gameName>.
If Config.VehiclesData is disabled, the script will get the vehicle's display names from the vehicle handling files vehicles.meta. Example: <gameName>Adder</gameName>.
Adding/Removing BOLOs & Markers from other resources
Why do I need this?
This is optional, but it is possible to add BOLOs and Markers from other resources, such as MDTs or police resources.
TriggerServerEvent('cd_radar:RadarDatabase_ADD', {
plate = CHANGE_ME,
model = CHANGE_ME,
colour = CHANGE_ME,
reason = CHANGE_ME,
type = CHANGE_ME,
name = nil,
notes = nil,
date = nil,
})TriggerServerEvent('cd_radar:RadarDatabase_ADD', {
plate = 'CODESIGN',
model = 'Adder',
colour = 'Blue',
reason = 'Drugs',
type = 'bolo',
name = nil,
notes = 'Pablo Escobar wannabe (selling drugs)',
date = nil,
})TriggerEvent('cd_radar:RadarDatabase_ADD', {
plate = CHANGE_ME,
model = CHANGE_ME,
colour = CHANGE_ME,
reason = CHANGE_ME,
type = CHANGE_ME,
name = nil,
notes = nil,
date = nil,
})TriggerEvent('cd_radar:RadarDatabase_ADD', {
plate = 'CODESIGN',
model = 'Adder',
colour = 'Blue',
reason = 'Drugs',
type = 'bolo',
name = nil,
notes = 'Pablo Escobar wannabe (selling drugs)',
date = nil,
})What does each of the variables above mean?
plate: The vehicle's plate (string).
model: The vehicle's display name (string).
colour: The vehicle's colour (string).
reason: The reason must match one of the reasons in the "
reasonList" in the[configs/config_ui.js](string).type: Choose between "
bolo" or "marker" (string).name: [OPTIONAL] The character's name (string).
If left as
nilthen cd_radar auto-fill this for you.
notes: [OPTIONAL] Notes left by the officer who issued the bolo/marker (string).
date: [OPTIONAL] The time this bolo/marker was issued (string).
If left as
nilthen cd_radar auto-fill this for you.
TriggerServerEvent('cd_radar:RadarDatabase_REMOVE', plate)TriggerEvent('cd_radar:RadarDatabase_REMOVE', plate)INFORMATION
Default Key Binds
These keys can be modified and/or disabled in the Keys and Commands section of the [configs/config.lua].
Please make sure you understand how Key Mapping works.
J
Interact with the radar’s UI.
O
Toggle the radar lock.
Chat Commands
These chat commands can be renamed and/or disabled in the Keys and Commands section of the [configs/config.lua].
The exact usage for each command will be displayed in the chat suggestions when using the commands in-game.
/radarsettings
Interact with the radar’s UI.
/radartoggle
Toggle the radar UI visibility.
/radarlock
Toggle the radar lock.
Events
These events are completely optional; you can use them if needed.
Interact With Radar
TriggerEvent('cd_radar:InteractWithRadar')Toggle Radar
TriggerEvent('cd_radar:ToggleRadar')Show Radar
TriggerEvent('cd_radar:ShowRadar')Hide Radar
TriggerEvent('cd_radar:HideRadar')Toggle Radar Lock
TriggerEvent('cd_radar:ToggleRadarLock')COMMON ISSUES
Please check out our Troubleshooting Guide before contacting our support.
🔔 Folder Name Make sure the name of the folder is cd_radar.
🔔 Encrypted Files Do not edit the encrypted files in any way.
Radar Ignores Emergency Vehicles?
eg., if your radar is ignoring emergency vehicles.
✔️ This is normal; by design we have made it so the radar ignores emergency vehicles; as during police chases this could get really annoying. So please be aware of this if testing the resource out emergency vehicles aren't being seen by the speed limit radar.
Radar Locking Below The Limit I Set?
eg., if you have your radar to lock vehicles at 70mph but they are locking at 30mph.
✔️ This is because you have not set the limit for all 4 cameras. Each camera has its own individual speed limit for locking vehicles. Set them all to the new limit individually.
Radar Not Visible But I Have The Correct Job/perms?
eg., if you are confident you have the correct job/perms, but the radar still isn’t visible when in a vehicle.
✔️ This is because the radar is set to only be visible when you are in an emergancy vehicle. To test this theory, spawn in a default gta police car (/car police), then it should work. If a default gta police car works, but your custom police car does not, then the vehicle class for your custom car is not set as an emergancy vehicle (VC_EMERGENCY) in the vehicles.meta.
I'm Not Able To Add Plates To The Radar's Database?
eg., if you are trying to add plates to the radar's database manually or through another script but it doesn't get added and there are no errors.
✔️ The most common reason for this is because you do not have permission to use the radar (your job is not in the Config.AllowList table in the config.lua). The only way the script will allow you to add a plate to the radar's database is if your job has permission or the event is being triggered from the server side. There will be no visible error if you try to add a plate to the radar's database without proper permissions.
ERROR CODES
If you see an error code not listed below please open a script support ticket in the Codesign Discord.
468454 - You do not have the vehicles database table, so you need to disable Config.VehiclesData by setting the ENABLE option to false.
3364 - You are triggering the cd_radar:RadarDatabase_REMOVE server event to remove bolos/markers, but this vehicle does not have a bolo/marker on it.
8800 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, you need to send a table, but you are not.
8801 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, the plate variable is not a string or is nil.
8802 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, the model variable is not a string or is nil.
8803 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, the colour variable is not a string or is nil.
8804 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, the reason variable is not a string or is nil.
8805 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, the type variable is not a string or is nil.
8806 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, the reason variable is not defined in the config_ui.js's reasonList table. The strings must be an exact match (case sensitive).
8807 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, the plate variable is either more than 8 characters or is an empty string.
8808 - When triggering the cd_radar:RadarDatabase_ADD server event to add bolos/markers, the type variable can only be either bolo or marker, but you are sending something different.
N/A
CHANGELOG
Files Changed
Not every update requires you to replace the whole folder. We do this because we understand it's a pain to redo the configs for every update.
All Files - This means you should make a backup of the
JSON Filesfolder, delete your oldcd_radarfolder, download and add in the latest version, replace the new JSON Files folder with the one you made a backup of, configure the configs folder and restart your server.All Files Except config.lua - This means you should do all of the above (in the All Files section) but additionally make a backup of the
config.luafile and replace the new config.lua file with the one you made a backup of.Specific Files - This means you can copy and paste the SPECIFIC new files over the old ones and restart the server.
PLEASE READ! (JSON files)
When updating a resource that uses JSON files as a database as this one does, DO NOT delete/replace the files/folders inside the JSON files folder, as this will overwrite your saved database.
Skipping Updates
If you are attempting to update to the latest version but have skipped previous updates, you should update all files just to be safe. For example., let's say you are currently on v4.0.1, you did not update when v4.0.2 was released, and now v4.0.3 is released, and you want to update; you should always use the “All Files” update method.
03/05/2023
Files Changed:
Update Type:
Changelog:
Add
Added Turkish locales thanks to Lumisaphy.
Added pre-configured notification events/exports for some notification scripts that are auto-set by the auto_detect.
Added "Config.ClearDatabaseOnRestart" config option to delete the BOLO/marker database on script start.
Fix
Fixed the radar database not sometimes syncing when joining the server off-duty and then going on duty on QBCore.
06/02/2023
Files Changed:
Update Type:
Changelog:
YOUR RADAR DATABASE WILL BE DELETED IF YOU DON'T READ THIS.
Copy all of the data inside the [radar_database.txt] file and paste them inside the [JSON Files/radar_database.json] file.
Add
Added
Config.UseFrameworkDutySystemso you can choose whether you want to use your framework's built-in duty system.
Fix
Fixed the radar database not being synced when switching jobs.
Added an auto fix for the QB-shared vehicle misconfigured files.
Fixed some locales on the UI.
09/02/2023
Files Changed:
Update Type:
Changelog:
Add
Auto Framework Detection - We have added a new feature we are calling 'auto_detect', which will automatically identify your framework resource and framework notifications and apply the appropriate default settings.
Multiple Choice Permissions Access: With this new feature, you are no longer forced to choose 1 way of adding permissions, you can use multiple all at the same time. You can choose from the framework's job, discord roles, ace perms and identifiers all at the same time!
Fix
Fixed the errors when removing a bolo/marker.
Fixed the errors with owner check.
Last updated
Was this helpful?