Configuration — ns-carthief

Every option lives in config.lua. It stays readable and editable in the escrowed release, like the files in locales/. Restart the resource after a change.

General

Features

Config.Features = {
    Lockpick = true,      -- open locked vehicles with the lockpick minigame
    Hotwire = true,       -- start vehicles without keys with the hotwire minigame
    Progression = true,   -- thief XP / level
    OwnerAlert = true,    -- the online owner of a player vehicle is told when its alarm goes off
}

Who may steal

Items

Tiers

Each vehicle gets a tier: Config.Vehicles.tierByModel[model] → tierByClass[class] → defaultTier.

normal = {
    lockpick = { pins = 2, toleranceDeg = 7, falloffDeg = 45, pickHealth = 100, timeMs = 50000 },
    hotwire = { screws = 3, wires = 6, stripWindow = 0.22, stripSpeed = 1.0, twistTurns = 3, crankWindowMs = 520 },
    xp = 15,
},

The defaults go from easy (1 pin, 9°) to expert (4 pins, 4.5°).

Vehicles

Config.Vehicles.tierByModel = {
    adder = 'expert',   -- example
}

blacklistModels is checked with the model the server reads and cannot be faked. The class has no server native: it is reported by the client and only chooses the tier and the class blacklist. Put every vehicle that must never be stolen in blacklistModels.

Lockpick

Hotwire

Alarm

Dispatch

The built-in alert (used when no dispatch resource is started) sends a notification and a timed area blip to police on duty. A custom hook:

Config.Dispatch.provider = 'custom'
Config.Dispatch.custom = function(src, coords, kind, message)   -- server; kind = 'alarm' | 'hotwire'
    exports.my_dispatch:Send(coords, message)
    return true          -- anything else (or an error) falls back to the built-in alert
end

Custom keys

Config.VehicleKeys.provider: 'auto', 'qbx_vehiclekeys', 'qb-vehiclekeys', 'none' or 'custom'.

Config.VehicleKeys = {
    provider = 'custom',
    custom = {
        give = function(src, vehicle, plate) exports.my_keys:Give(src, plate) end,
        has = function(src, vehicle, plate) return exports.my_keys:Has(src, plate) end,
        hasClient = function(vehicle, plate) return exports.my_keys:HasClient(plate) end,
    },
}

With 'none' the script remembers hotwired vehicles itself.

Progression

Interface

Admin and security

Admin commands:

• /carthiefreset <id>: reset a player's progression and cancel their attempt.
• /carthieftest <pick|wire> [tier]: open a minigame without a vehicle. Needs Config.Debug = true. A test never unlocks, gives keys, removes items, sets an alarm or gives XP.