Configuration Reference

Complete reference for every key in shared/config.lua. Defaults below match the shipped file.

Config File: shared/config.lua

Global

Permissions

Config.AllowedJobs = {
    police = { minGrade = 0 },
    LSPD = { minGrade = 0 },
}
Config.MaxDeploymentsPerOfficer = 3

Items

Config.ChipItem = 'baitcar_chip'
Config.RemovalToolItem = 'screwdriver'
Config.UseRemoteController = true
Config.RemoteControllerItem = 'baitcar_remote'

Civilian Removal

Config.RemovalDurationMs = 12000
Config.RemovalSuccessChance = 0.5

Drive-Off Trigger

Config.TriggerSpeedMps = 8.0
Config.TriggerDurationMs = 1500
Config.FakeWantedLevel = 3

Remote Actions

Config.SpeedLimitMph = 30
Config.HornDurationMs = 1500
Config.StrobeIntervalMs = 150
Config.SteeringBias = 1.0

Install

Config.InstallDurationMs = 4000

Entry Dispatch

A dispatch alert fires the first time a non-LEO sits in a bait car, before they drive off and trip the trigger threshold. The alert routes through the same olink.dispatch.CreateAlert adapter as the trigger alert (and respects Config.DispatchJobs), so every responder in the recipient job list sees it — not just the deploying officer.

Config.NotifyOfficerOnEntry = true
Config.EntryDispatch = {
    code = '10-66',
    title = 'Bait Car Entry',
    icon = 'fas fa-car-side',
    priority = 3,
    blip = { sprite = 225, color = 5, scale = 0.9 },
}

Dispatch

Config.Dispatch is the payload forwarded to olink.dispatch.CreateAlert when a bait car is triggered. The exact in-game presentation depends on your dispatch adapter (ps-dispatch, cd_dispatch, oxide-dispatch, etc.).

The alert also receives the bait car's plate, model, and coords automatically. Recipient jobs default to the keys of Config.AllowedJobs and can be overridden via Config.DispatchJobs below.

Config.Dispatch = {
    code = '10-16',
    title = 'Bait Car Triggered',
    icon = 'fas fa-car-burst',
    priority = 2,
    blip = { sprite = 225, color = 1, scale = 1.1 },
}

-- Example: broadcast to sheriff and state troopers too, without letting them deploy.
Config.DispatchJobs = { 'police', 'LSPD', 'sheriff', 'sast' }

Officer Blip

Config.OfficerBlip controls the map blip drawn on each active deployment for authorized officers.

Config.OfficerBlip = {
    sprite = 225,
    color = 5,
    scale = 0.9,
    label = 'Bait Car',
}

Recording

Config.Recording governs the dashcam clip recorder. The entire pipeline is gated on oxide-police being started; without it every value here is moot.

Config.Recording = {
    enabled = true,
    hotkey = 'F8',
    maxDurationS = 45,
    provider = 'fivemanage',
    videoBitrate = 600000,
    discordMaxBytes = 25 * 1024 * 1024,
    thumbnail = { enabled = true, captureSeconds = 1.0, quality = 0.7 },
}

Dashcam

Config.Dashcam defines the scripted camera attached to a bait car during dashcam playback. Profile resolution is layered: for each field (fov, offset, rotation), the value is taken from ByModel[modelName], falling through to ByClass[className], then to Default.

Universal keys

Default profile

Per-class profiles

Config.Dashcam.ByClass is keyed by GTA vehicle class name. The shipped defaults cover every standard vanilla class (compact, sedan, suv, coupe, muscle, sportsclassic, sports, super, offroad, industrial, utility, van, service, emergency, military, commercial, openwheel). Each profile is a table with the same shape as Default. Fields you omit fall through to Default.

Per-model overrides

Config.Dashcam.ByModel is keyed by lowercase spawn name. Use it for add-on models or for stock models whose class profile doesn't sit well. The shipped file includes a single example:

Config.Dashcam.ByModel = {
    ['sultan'] = { offset = vec3(0.0, 0.45, 0.65) },
}

Tune in-game with /baitcardashcamtune. The tuner copies a paste-ready Config.Dashcam.ByModel.<name> = { ... } or Config.Dashcam.ByClass.<class> = { ... } snippet to your clipboard. See Admin for the full tuner workflow.

Next Steps