FAQ
Here youโll find a quick and easy guide to features, troubleshooting tips, and answers to common questions.
๐บ๏ธ Where Do I Customize the Configuration of My Police Map?
You can customize police map settings and points in the following location:
Inside this folder (
rcore_police/data/maps
), you'll find files for each supported map (e.g.,mrpd.lua
,sandy_pd.lua
, etc.).Open the file that matches your map and edit the points and settings as needed for your server.
Note: If your map isnโt specifically supported (no matching
.lua
file is found), the script will automatically usedefault-mrpd.lua
as a fallback configuration.
Tip:
For unique or custom maps, use
/preset_creator
in-game to define new map. (requires: admin rights)
๐ Where Do I Define Garage Vehicles and Weapon Shop Items for Officers?
All police garage vehicles and shop items are managed inside your
config.lua
file, under theJobGroups
section.
๐ Police Garage Vehicles
To add, remove, or edit available vehicles for each police job (like police or sheriff):
Open your
config.lua
.Find the relevant job group (e.g.,
'police'
or'sheriff'
).Under
VehiclesToGrade
, update:storage
: List all vehicles, their names, models, images, and prices.access
: Set which job grade can access each vehicle.
Example:
VehiclesToGrade = {
storage = {
['police3'] = { label = "Police Cruiser (A)", model = 'police3', price = 300 },
['polmav'] = { label = "Police Maverick", model = 'polmav', price = 300, isAir = true },
-- more vehicles...
},
access = {
[0] = { "police3", "polmav" },
[3] = { "police4" },
[5] = { "*" }, -- "*" means all vehicles for this grade
}
}
๐ Weapon/Equipment Shop
To set what items your officers can buy or take:
Open your
config.lua
.In the same job group, look for the
Store
section.Under
storage
, add or remove items (with their label and price).Under
access
, set which items each job grade can access.
Example:
Store = {
storage = {
[Items.Spikes] = { label = "Spikes", price = 0 },
['WEAPON_NIGHTSTICK'] = { label = "Nightstick", price = 500 },
['radio'] = { label = "Radio", price = 250 },
-- more items...
},
access = {
[0] = { "WEAPON_NIGHTSTICK", "radio", Items.Spikes },
[3] = { "weapon_carbinerifle" },
[5] = { "*" },
}
}
Note: All higher grades automatically inherit access to items and vehicles from lower gradesโno need to define them again! ๐
๐๏ธ Having trouble opening your stashes or searching other players?
This usually happens if youโre using an unsupported inventory system, or if the inventory author has changed how their exports or events work.
Double-check for updates to your inventory, and feel free to reach out to the inventory author if youโre unsure.
If youโre running a modified or out-of-date inventory, support might not be available. For the best experience, always use the official, latest supported versions.
๐ค Escort Feature Not Working Properly? (Strange Behavior When Putting In/Out of Vehicle)
If you notice that escorting a player acts strangely, or you can't re-escort them after putting them in or out of a vehicle, hereโs what to check:
Reason:
This usually happens if youโre running another third-party resource that interferes with player handling or police actions.
We use emulated functions from popular scripts like
qb-police
,qbx
, oresx_policejob
to maximize compatibility.However, if you have another resource doing similar things (like custom escort, drag, or put-in-vehicle code), it can cause weird conflicts.
How to fix:
Disable any other third-party police or escort-related scripts to avoid conflicts.
Make sure youโre only running the police resource you intend to use.
Tip: If you need to use custom features from a third-party script, make sure theyโre not conflicting with rcore_policeโs built-in functionality.
๐ Why can't a player be put in a vehicle without cuffs?
This is working as intended!
A player must be cuffed before they can be placed into a vehicle by police or staff.
Why? Requiring cuffs makes sure the player is properly handled while in the vehicleโso they canโt escape, exploit, or glitch out. It helps prevent unwanted situations where an uncuffed player could exit the car or interfere with the roleplay scenario.
If you want to move a player to a vehicle, make sure to cuff them first using the appropriate command or menu option.
๐ฎโโ๏ธ Can't open the job menu after being downed & revived?
If you canโt open your F2 job menu after being revived, try this:
Check your config:
Open your
config.lua
inrcore_police
.Find this section:
Flags = { SkipDeathCheck = false, -- This allows to skip death check (helpful when issue with accessing menu / not running supported death system) },
Set
SkipDeathCheck
totrue
:Flags = { SkipDeathCheck = true, },
Save your changes and restart your server/resource.
Tip: Setting
SkipDeathCheck
totrue
tells rcore_police to ignore the "dead" state checkโso the F2 menu will work, even if thereโs a death state issue or your server uses a custom death system.
โน๏ธ Why does this happen?
Many servers use custom revive or death systems (for example, a modified ambulance job or custom logic using player death metadata).
These scripts can handle the player's "dead" state in ways rcore_police doesn't recognize, especially if the framework's death metadata is customized.
As a result, rcore_police may still think a player is dead after theyโre revivedโblocking features like the F2 menu.
Important: Setting
SkipDeathCheck
totrue
makes rcore_police ignore the "dead" check so the F2 menu works with your custom death system. However: Some features (like "escort" or picking up a downed player) may not work correctly if rcore_police canโt reliably tell whoโs dead or alive with your custom logic.If your death system and framework metadata arenโt fully compatible, some advanced features may not behave as expected.
๐บ๏ธ How to Define a Non-Supported Map
Want to add your own map that isnโt officially supported yet? Hereโs how:
Enter the game and open the chat.
Type the command:
/preset_creator
.A short form will appear โ fill it out and follow the on-screen instructions until youโre done.
Note:
This command is not for customizing existing mapsโadjust those manually if needed.
You must have admin rights to use this command.
๐ฎโโ๏ธ Can I add more than one department/job to rcore_police?
Yes, you can absolutely have more than one law enforcement job (e.g., police
, sheriff
, ranger
, etc.) in rcore_police.
By default, the configuration might look like this:
Jobs = { 'police', 'sheriff' },
-- To add a third job (e.g., ranger), simply modify it:
Jobs = { 'police', 'sheriff', 'ranger' },
Path: rcore_police/data/maps/default-mrpd.lua
๐ก Tip: If you're adding a job that isn't
police
orsheriff
, you must also register it underJobGroups
in the config. This ensures the new job has access to all job-related menus and features, such as:
๐ Radial menu options
๐ฏ Target interactions
๐งญ Job UI features
๐ Path:
rcore_police/config.lua
๐ฆ Script is throwing an error in F8: ?-1: attempt to index a nil value (field "Config")
?-1: attempt to index a nil value (field "Config")
This error typically occurs when there's a syntax error in your configuration, often when modifying the Database, Clothing, Inventory, Framework, or Prison settings.
โ Common Mistakes:
Incorrect Framework or Inventory names: If you set something like:
Framework = qb-core Framework = QB-Core Inventories = OX
Correct Usage:
๐ง AUTO_DETECT: If you're unsure about the correct configuration, AUTO_DETECT will automatically detect and configure the supported scripts for you. There's no need to manually set the framework or inventory if you use this option.
๐ก Tip: Always double-check your config for typos or incorrect casing. Using AUTO_DETECT is a simple and effective way to avoid this issue.
Ensure you use the proper structure and casing for each framework and inventory:
Framework Settings:
Framework = Framework.QBCore
(forqb-core
)Framework = Framework.ESX
(fores_extended
)Framework = Framework.QBOX
(forqbx_core
)
Inventory Settings:
Inventories = Inventories.OX
(forox_inventory
)
๐ How can I change or remove options from the radial menu?
The radial menu options are located in: modules\bridge\client\interact\cl-interact-radial.lua
.
Where do I set zones to use the target system?
To enable interactions with zones using a target system (such as ox_target
or qb-target
), follow these steps:
Open the file:
rcore_police/config.lua
Find the setting called
UseTargetForZones
and set it totrue
:
UseTargetForZones = true
Restart rcore_police and enjoy!
๐ฆ Why can't I open job stashes or search players?
If you're experiencing issues with searching players or opening job stashes, it's likely related to your inventory system.
๐ Common Causes:
Unsupported or outdated inventory: If you're using an outdated version of the inventory, it may not support the required features for interacting with stashes or searching players.
Changes to required
exports
orevents
: The inventory you're using may have removed, renamed, or altered the exports or events needed for stashes and player search functionality.
โ
What You Should Do:
Ensure you're using the latest version of your inventory system. Updating to the most recent version can resolve compatibility issues.
Confirm the inventory has the required exports/events:
From our side, we rely on the official API (exports/events) provided by the inventory author to open stashes and search players.
If the API has changed recently, let us know! We can look into the issue from our side and help adjust compatibility.
Check for conflicts with modified or custom inventories:
Custom or heavily modified inventories are not officially supported, and they may cause issues with accessing job stashes or searching players.
Always use officially supported versions for proper functionality.
๐ง Testing and Debugging
If your inventory is throwing errors, make sure to update it to the latest version. After updating, if there are no errors but stashes or searches still don't work, itโs possible the API has changed. In that case, let's check it out together!
Weโve added some helper commands specifically for admins to help you verify the functionality of player searches and job stashes:
rcore_police_inventory_test_search_self
rcore_police_inventory_test_stash_self
These commands will test the functionality locally for an admin. However, please note that these may not work with some inventories depending on how they are structured.
โ Note: Custom, heavily modified, or older versions of supported inventories are not officially supported. Please check with the inventory's author or their documentation for compatibility.
๐ Cuffed Player Restrictions โ FAQ
โ Can I disable the need to cuff someone before placing them in a vehicle?
Yes โ you can! This is useful for handling downed or dead players.
๐ File: config.lua
๐ง Setting:
CuffsRequiredForTransport = false
-- When false: You can place players in vehicles even if they're not cuffed.
-- When true: Only cuffed players can be placed into vehicles.
โ Where can I disable sprint for cuffed players?
๐ File: config.lua
๐ง Setting:
DisableSprintForCuffedPlayers = true
-- When true: Cuffed players cannot sprint.
-- When false: Sprinting is still allowed while cuffed.
โ Where can I disable walking for cuffed players?
๐ File: config.lua
๐ง Setting:
DisableWalkForCuffedPlayers = true
-- When true: Cuffed players cannot walk at all (they will be frozen or fully restricted).
-- When false: Cuffed players can still walk normally.
โ Where can I disable inventory access for cuffed players?
๐ File: config.lua
๐ง Setting:
DisableInventoryWhileCuffed = true
-- When true: Cuffed players cannot open their inventory.
-- When false: Cuffed players can still access their inventory.
Last updated
Was this helpful?