Pursuit Mode
The Pursuit Mode system allows authorized emergency vehicle drivers to toggle high-performance engine stages (e.g. A, S, S+). Toggling cycles through the configured stages to assist in high-speed pursuits.
⚙️ Features
- Performance Tuning Stages: Modifies the vehicle's engine multipliers and handling floats (
fInitialDriveForce,fDriveInertia,fInitialDriveMaxFlatVel) to boost acceleration and top speed per stage. - Stage Cycling: Pressing the keybind or radial option cycles through:
Disabled ➔ Class A ➔ Class S ➔ Class S+ ➔ Disabled. - Dynamic Keybind / Command: Default keybind (
I) or command (/pursuitmode) registers to allow instant stage shifting. - Radial Menu Toggle: Integrates directly into the Police radial submenu when the driver is inside an emergency vehicle.
- Safety Auto-Deactivation: Deactivates automatically if the player exits the driver's seat, dies, or switches departments.
- Sound Effects: Plays distinct activation and deactivation sound cues.
- Cooldown: Prevents rapid mode-switching spam.
🛠️ Configuration
All settings and stages are configured in shared/config_pursuit.lua.
Config.PursuitMode = {
-- Authorized jobs allowed to use Pursuit Mode
AuthorizedJobs = {
['police'] = true,
['bcso'] = true,
['sasp'] = true,
},
-- Allow all Emergency Class 18 vehicles, or restrict to WhitelistedVehicles list
AllowAllEmergency = true,
-- Specific whitelisted vehicle models
WhitelistedVehicles = {
['police'] = true,
},
-- Keybind & command settings
Command = 'pursuitmode',
Keybind = 'CAPITAL', -- CapsLock
-- Cooldown in milliseconds between toggles
Cooldown = 1500,
-- Audio settings
Sound = {
Enabled = true,
Activate = {
Name = 'Remote_Control_Activate',
Dict = 'DLC_HEISTS_GENERIC_SOUNDS',
},
Deactivate = {
Name = 'Remote_Control_Deactivate',
Dict = 'DLC_HEISTS_GENERIC_SOUNDS',
}
},
-- Configurable Stages
Stages = {
{
name = 'A',
label = 'Pursuit Mode: Class A',
Performance = {
EnginePowerMultiplier = 1.15,
TorqueMultiplier = 1.10,
Handling = {
fInitialDriveForceMultiplier = 1.12,
fDriveInertiaMultiplier = 1.10,
fInitialDriveMaxFlatVelMultiplier = 1.05,
}
}
},
{
name = 'S',
label = 'Pursuit Mode: Class S',
Performance = {
EnginePowerMultiplier = 1.30,
TorqueMultiplier = 1.20,
Handling = {
fInitialDriveForceMultiplier = 1.25,
fDriveInertiaMultiplier = 1.20,
fInitialDriveMaxFlatVelMultiplier = 1.12,
}
}
},
{
name = 'S+',
label = 'Pursuit Mode: Class S+',
Performance = {
EnginePowerMultiplier = 1.50,
TorqueMultiplier = 1.35,
Handling = {
fInitialDriveForceMultiplier = 1.40,
fDriveInertiaMultiplier = 1.35,
fInitialDriveMaxFlatVelMultiplier = 1.20,
}
}
}
}
}🎮 Usage
- Enter an authorized emergency vehicle as the driver.
- Press the configured keybind (
CAPSLOCKby default, can be mapped in settings) or open the radial menu (Police -> Pursuit Mode). - Notifications will inform you of the active stage (e.g.
Class A,Class S,Class S+, orDISABLED). - Toggle again to shift to the next stage or exit the vehicle to automatically disable it.