Configuration

c3r's settings live in plain Lua files in c3r/config/, read by both the server and every player's game. Edit a file and restart c3r, or change values live in game with /c3rconfig (admins). Every option is listed below with its default.

#The basics

main.lua

Config.Debug boolean (default: false)
Extra logging in the server console and F8. Leave it off on a live server.

Config.DutyCommand string (default: 'duty')
The chat command that toggles your shift.

Config.DutyKey string (default: 'F11')
Opens the service screen.

Config.DutyAce string | nil (default: nil)
nil lets anyone go on duty. Set an ace (e.g. 'c3r.police') and grant it to restrict it:

add_ace group.police c3r.police allow

Config.TargetKey string (default: 'LSHIFT')
In a police vehicle: the red circle ahead. Press again to cancel.

Config.ModeKey string (default: 'U')
During a stop: what the driver does.

Config.InteractKey string (default: 'E')
The contact wheel.

Config.RadialKey string (default: 'G')
Held: the vehicle wheel at a car, the dispatch wheel elsewhere.

Config.RespondKey string (default: 'Y')
Respond to a callout offer.

Config.ObjectiveKey string (default: 'BACK')
On a callout: hide or show the objective card.

Config.LeaveCallKey string (default: 'X')
Decline a callout offer; on a call, leave it.

Config.WeaponWheelHold number (default: 500)
Milliseconds Tab must be held to open the weapon wheel while an ID is showing. A shorter tap hides or shows the ID.

Config.Voice table (default: { range = 20.0, volume = 1.0 })
The officer's spoken lines (asking for ID, Miranda rights, a search, the breathalyzer). range in metres, quieter further off; volume 0-1, 0 turns them off.

#Picking the car and pulling over

stops.lua

Config.Target table

Config.Pullover table
Tuning knobs for how the AI pulls over. GTA's driving AI behaves differently on different roads; adjust these if drivers stop too far, too short, or in the lane.

Config.CancelDistance number (default: 150.0)
Drive this many metres from the stop and it's cancelled.

Config.Modes table
The U menu's driving modes.

#Stops, orders and running

stops.lua

Config.Tests table (default: { bac_limit = 0.08 })
The breathalyzer's legal limit.

Config.Flee table
Not everyone goes quietly. Chances are 0-1, per hidden truth; a truth that isn't listed never does it.

Config.PaRange number (default: 40.0)
Metres shouted orders reach (the PA, a felony stop). Talking still needs you beside them.

Config.Felony table
Felony stop chances (0-1).

#Who you stop

people.lua

Config.Secrets table
How often each hidden truth comes up, as relative weights (any numbers; 0 turns one off).

Config.Demeanors table (default: polite 50, nervous 20, rude 15, chatty 15)
How people come across, as relative weights.

Config.PassengerSecrets table (default: clean 55, nervous 15, warrant 10, drugs 10, drunk 10)
Passengers' own truths. They aren't driving, so no licence or papers truths.

Config.FlagChance number (default: 0.06)
Chance anyone has a record flag (PROBATION, GANG AFFILIATION...).

Config.BorrowedChance number (default: 0.15)
Chance the car belongs to a relative.

Config.OwnerDrivesChance number (default: 0.8)
A car you've stopped before: chance its owner is at the wheel again.

#Patrol and booking

patrol.lua

Config.Staged table
Staged violators: a car near you starts driving to match its story.

Config.BookingRadius number (default: 5.0)
Metres: stop this close to a station with someone in custody and they're booked.

Config.Stations table
Where you can book prisoners. Each entry is { name, x, y, z }. Defaults: Mission Row, Vespucci, Davis, La Mesa, Vinewood, Rockford Hills, Sandy Shores, Paleto Bay, Bolingbroke. Positions are approximate: move them to match your MLOs.

{ name = 'Mission Row', x = 441.0, y = -985.0, z = 30.7 },

#Backup and the tow truck

backup.lua

Config.Backup table

Config.Backup.units table
One entry per unit: car (spawn name), crew (ped models), and optionally lights and muted. Model names are from FiveM's game references.

Any unit (and the tow truck) can also set how it looks:

Config.Backup.units.cover.livery = 2                 -- the vehicle's livery
Config.Backup.units.cover.colours = { 111, 0 }       -- primary, secondary paint (GTA colour ids)
Config.Backup.units.cover.extras = { [1] = true }    -- vehicle extras on / off
Config.Backup.units.cover.outfit = { [11] = { 0, 0 } } -- crew clothing: component = { drawable, texture }
Config.Backup.units.cover.props = { [0] = { 1, 0 } } -- hats (0) and glasses (1)

Outfit components: 3 arms, 4 legs, 6 shoes, 8 undershirt, 9 vest, 11 jacket.

Config.Tow table

#First aid

medical.lua

Config.Medical table

#Callouts

callouts.lua. The calls themselves are files in c3r/callouts/ (see the Callouts SDK).

Config.Callouts table