Exports and events

Everything another resource may rely on. The MDT and voice dispatch use only what's listed here, so it's safe to build on.

#Records

Events and exports pass these tables. They're the public record: what a plate or name check shows.

#Person

{
    id = 12, first = 'John', last = 'Smith', dob = '01/02/1990', gender = 'Male', address = '12 Grove St',
    dl = 'Valid', -- 'Valid' | 'Suspended' | 'Revoked' | 'Expired' | 'None'
    dl_valid = true,
    flags = { 'ARMED AND DANGEROUS' },
    warrant = 'Failure to appear', -- or nil
}

A name a driver made up comes as { first, last, dob, gender, unverified = true } with no id: nobody by that name is on file.

#Vehicle

{
    id = 7, plate = '4ABC123', make = 'Bravado', model = 'Buffalo S', color = 'Black', year = '2015',
    owner = 'John Smith', owner_id = 12, reg_valid = true, ins_valid = false,
    stolen = false, bolo = true, bolo_reason = 'Armed robbery suspect',
}

model is the display name ("Buffalo S"), not the spawn name.

#Callout

{ id = 'domestic_01', name = 'Domestic disturbance', street = 'Grove Street', coords = vector3(...),
  priority = 2, description = 'Neighbours report shouting.' }

#Truth

Only c3r knows it, and it only comes out through the server export getPedSubject.

{
    secret = 'drunk',   -- 'clean' | 'nervous' | 'unlicensed' | 'suspended' | 'expired' | 'drunk' | 'drugs' | 'warrant' | 'stolen'
    demeanor = 'polite', -- 'polite' | 'nervous' | 'rude' | 'chatty'
    id = 'hands',        -- asked for a licence: 'hands' it over, 'forgot' it, or gives an 'alias'
    alias = nil,         -- { first, last, dob }: the false name (id = 'alias')
    bac = 0.12,          -- secret = 'drunk' only
}

#Server events

Fired with TriggerEvent on the server. Listen with AddEventHandler. The first argument is always the officer's server id. These are never net events, so a client can't fake them.

AddEventHandler('c3r:stopEnded', function(src, outcome)
    print(('%s ended a stop: %s'):format(GetPlayerName(src), outcome))
end)

#Server exports

The SQL-backed exports answer through a callback, because a call from another resource can't wait on SQL inside c3r.

exports.c3r:lookupPlate(src, '4ABC123', function(vehicle)
    if vehicle and vehicle.stolen then print('Stolen!') end
end)

#Client exports

Service kinds: ambulance, police (prisoner transport), tow, coroner, fire, mechanic, roadservice, animalrescue, taxi, cover.

PA commands: pull_over, felony, driver_out, passenger_out, everyone_out, walk_back, kneel, hands_up, back_in, engine_off. On a felony stop only the first runs.

Reasons (the second value when the first is false): off_duty, not_available (unknown kind or its models missing), already_en_route, no_route, no_prisoner, no_vehicle, nobody_to_collect, too_far, no_pursuit, enough_units, not_en_route, already_dispatched, no_backup.

local ok, why = exports.c3r:requestService('ambulance')
if not ok then print('No ambulance: ' .. why) end

#State bags

if LocalPlayer.state.c3rDuty then --[[ on duty ]] end