esx_policejob

esx_policejob turns the police job into a playable law-enforcement role: cloakrooms with grade uniforms, an armory where officers buy weapons, a garage for job cars and helicopters, a boss menu, and an F6 menu to search, cuff, drag, fine and impound. Install it when you want the stock ESX police department rather than writing your own.

OverviewCopy Anchor Link

On start the server registers the society with esx_society:registerSociety and, when Config.EnableESXService is on and Config.MaxInService is not -1, activates a service limit through esx_service.

What officers can doCopy Anchor Link

• Cloakroom: switch between civilian clothes and the uniform for their grade, add a bulletproof vest or a high-visibility vest, and (optionally) pick a custom ped.
• Armory: buy the weapons listed for their grade. With armory management enabled they can also deposit and withdraw weapons and items from the shared police storage.
• Garage: buy job cars or helicopters for their grade, take them out, and store them again.
• F6 menu:
  • Citizen interaction: ID card, body search, handcuff, drag, put in vehicle, take out of vehicle, fine, unpaid bills, and license check (when licenses are enabled).
  • Vehicle interaction: vehicle info, lockpick, impound, search the plate database.
  • Object spawner: cones, barriers, spike strips, boxes and a cash crate.
• Boss menu: managed by esx_society at the BossActions marker. Money washing is disabled and the uniform editor is enabled.

InstallationCopy Anchor Link

ensure oxmysql
ensure es_extended
ensure esx_lib
ensure esx_addonaccount
ensure esx_addoninventory
ensure esx_datastore
ensure esx_society
ensure esx_billing
ensure esx_vehicleshop
ensure esx_policejob

ConfigurationCopy Anchor Link

All options are in config.lua.

StationsCopy Anchor Link

Config.PoliceStations is a table of stations (the default one is LSPD). Each station has:

Grade-based tablesCopy Anchor Link

These tables are keyed by grade name (recruit, officer, sergeant, lieutenant, boss). If you rename grades in the database, rename the keys too.

• Config.AuthorizedWeapons[grade]: list of { weapon = 'WEAPON_X', price = n, components = { ... } }. components holds one price per component index of the weapon in ESX's weapon list; nil hides that component.
• Config.AuthorizedVehicles.car[grade] and Config.AuthorizedVehicles.helicopter[grade]: list of { model = 'police3', price = n, props = { ... } }. props is optional and is merged into the stored vehicle properties.
• Config.CustomPeds: shared entries are available to every grade, plus one list per grade. Each entry has label, maleModel, femaleModel.
• Config.Uniforms: one entry per grade plus bullet_wear and gilet_wear, each with male and female skinchanger components.

-- Let recruits buy a basic cruiser
Config.AuthorizedVehicles.car.recruit = {
    { model = 'police', price = 5000 },
}

Server eventsCopy Anchor Link

All of these are network events that the client triggers. Every handler checks that the caller has the police job and is not off duty, and most also check distance. Do not call them from other resources unless you need the same behavior.

Server callbacksCopy Anchor Link

Callbacks are registered with xLib.callback.registerCompat, so they work with both xLib.callback and the classic ESX.TriggerServerCallback.

Client eventsCopy Anchor Link

KeybindsCopy Anchor Link

Both are registered through xLib.addKeybind, so players can rebind them under Settings → Key Bindings → FiveM.

Integration tipsCopy Anchor Link

Check whether someone is cuffed before letting them use your own features:

RegisterNetEvent('myphone:open', function()
    local src = source

    if Player(src).state.isHandcuffed then
        return -- cuffed players cannot use the phone
    end

    TriggerClientEvent('myphone:show', src)
end)

if LocalPlayer.state.isHandcuffed then
    ESX.ShowNotification('You cannot do that while cuffed.')
    return
end

Fines are sent with esx_billing:sendBill to society_police, so paid fines land in the police society account. To pay officers a commission or log fines, hook into esx_billing rather than this resource.

Common issuesCopy Anchor Link

• "Off duty" notification everywhere. The script respects job.onDuty. A player whose duty flag is false cannot use the armory, garage or F6 menu.
• Nothing happens when buying a car. Check that the grade has entries in Config.AuthorizedVehicles, the price is above 0, the player has enough cash, and they stand within 35 units of the garage InsideShop or Spawner.
• ID card shows no name, date of birth or height. Config.EnableESXIdentity is true by default; if you do not run esx_identity, set it to false.
• Impound does nothing. Impounding needs esx_garage to export impoundVehicle. Without it the call silently fails.
• Duplicate SQL errors. See the txAdmin recipe note above.

RelatedCopy Anchor Link

• esx_society
• esx_billing
• esx_service
• esx_license
• Create a job

Frequently asked questions