SAFScriptsDocs

Installation

SAF Pursuit is coming soon. These docs describe the build that will ship.

On this page

SAF Pursuit needs no database. ox_lib is optional: without it, notifications use your framework's own, then the game feed.

Steps

  1. Put the saf-pursuit folder in your resources folder.
  2. Add it to server.cfg, after your framework:
    server.cfg
    ensure saf-pursuit
  3. Set your police jobs in Config.PoliceJobs. On Qbox and QBCore, any job of type leo counts on its own.
  4. Optional, for staff or servers without jobs:
    server.cfg
    add_ace group.police pursuit.use allow
  5. Start the server. The console prints the framework it found.

Who counts as police

A player can use pursuit modes when either is true:

  • They have the pursuit.use ACE.
  • Their job is in Config.PoliceJobs, or their job type is in Config.PoliceJobTypes, and they are on duty (when Config.RequireOnDuty is on).

The default job list is police, sheriff, bcso, sasp, state, trooper, ranger and fib.

FrameworkJob and duty from
Qbox, QBCorePlayer job name, type and onduty
ESXJob name. ESX has no duty flag, so a listed job always counts as on duty
ND CoreJob name, always on duty
ox_coreAny group named in Config.PoliceJobs
StandaloneThe ACE only

Which vehicles

The driver must be in an Emergency class vehicle (class 18) or a spawn code listed in Config.Vehicles.Models. Unmarked cars are often a different class, so add them there:

Lua
Config.Vehicles.Models = { 'police4', 'fbi', 'fbi2' }

Set Config.Vehicles.EmergencyOnly = false to allow modes in any vehicle a police player drives.

Updating

Replace every file except your custom/ folder. Keep config changes in custom/shared/ so they survive. See Custom servers.

SAF Scripts by San Andreas' Finest StoreDiscordsupprot@safrp.org

Not affiliated with or endorsed by Rockstar Games, Take-Two Interactive or Cfx.re.