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 use default-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 the JobGroups section.

๐Ÿš™ Police Garage Vehicles

  • To add, remove, or edit available vehicles for each police job (like police or sheriff):

  1. Open your config.lua.

  2. Find the relevant job group (e.g., 'police' or 'sheriff').

  3. 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:

  1. Open your config.lua.

  2. In the same job group, look for the Store section.

  3. Under storage, add or remove items (with their label and price).

  4. 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, or esx_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:

  1. Check your config:

    • Open your config.lua in rcore_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 to true:

      Flags = {
          SkipDeathCheck = true,
      },
  2. Save your changes and restart your server/resource.


Tip: Setting SkipDeathCheck to true 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 to true 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:

  1. Enter the game and open the chat.

  2. Type the command: /preset_creator.

  3. 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 or sheriff, you must also register it under JobGroups 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")

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 (for qb-core)

  • Framework = Framework.ESX (for es_extended)

  • Framework = Framework.QBOX (for qbx_core)

Inventory Settings:

  • Inventories = Inventories.OX (for ox_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:

  1. Open the file: rcore_police/config.lua

  2. Find the setting called UseTargetForZones and set it to true:

UseTargetForZones = true
  1. 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 or events: 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:

  1. Ensure you're using the latest version of your inventory system. Updating to the most recent version can resolve compatibility issues.

  2. 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.

  3. 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?