shared/config.lua

Edit shared/config.lua only. Framework bridge code lives in client/edit.lua and server/edit.lua.

Job fields, hose, hitching, illegal, and rentals: Jobs & loads. Phone / tablet: Opening the app. Fuel / keys / dispatch / server spawn: Integrations.

Framework and locale

-- auto detects qbx_core → qb-core → es_extended
-- or force "qbcore" | "qbox" | "esx" | "custom"
Config.Framework = "auto"
Config.CustomFrameworkName = false -- renamed core folder. false = defaults
Config.Locale = 'en'               -- en | es | pt | de | fr | pl

"custom" means you fill the edit.lua bridges.

Tablet, phone, and job gate

Config.EnableStandaloneTablet = true
Config.TabletItemName = false      -- false = /truckertablet. or an item name
Config.Phone = "auto"              -- or a resource / alias. false = off
Config.QSphoneAppCategory = "social"
Config.Tablet = "auto"             -- lb-tablet. false = off
Config.UIUpdateInterval = 10000
Config.RequireJob = "trucker"      -- false = anyone, or { 'trucker', 'police' }

Targeting and prompts

Config.Target = 'auto'
Config.TargetName = false
Config.UseTextUI = true
Config.TextUIPosition = "right-center"
Config.OtherKeybind = "E"

CB radio

Config.CBRadioEnable = false
Config.CBRadioChannel = 696.9
Config.CBRadioRestrictClasses = true
Config.CBRadioVehClasses = {
    [10] = true,
    [11] = true,
    [20] = true,
}

Depot blips and ped

Config.Blip = { color = 3, route_color = 3 }

Config.DepotBlip = {
    name = "Trucking Depot",
    coords = vector3(1225.61, -3189.32, 5.53),
    color = 81,
    sprite = 67,
    scale = 0.6,
}

Config.Ped = {
    model = `s_m_m_trucker_01`,
    coords = vector4(1206.1, -3162.83, 4.53, 185.52),
}

Shown for players who pass HasPerm. The ped opens the trucking app.

Locked spawn vehicles

Config.NeverAllowEntry = {
    [`halftrack`] = true,
    [`cargobob`] = true,
}
Config.NeverAllowEntryJobOnly = false -- false = always, even off the job

Police

Config.PoliceRequired = 2
Config.PoliceJobs = { "police", "bcso" }

Job timeout, hitching, heading

Config.Timeout = 60 * 60
Config.AttachAnyTrailer = true
Config.AnyTrailerDistance = 5.0
Config.AttachAnyTrailerKey = "J"
Config.BurstTires = true
Config.AllowedTrucks = {
    [`phantom`] = true,
    [`packer`] = true,
    [`hauler`] = true,
}
Config.ForceLoadingHeading = true
Config.ForceDropoffHeading = false

Server-side spawning

-- When true, networked job vehicles/peds/hose props spawn on the server.
-- Local-only entities (depot ped, dummies, load props, tablet) always stay client.
-- Server edit.lua VehicleSpawned / VehicleDespawned always run for networked vehicles
-- regardless of this flag (spawn mode only chooses who creates the entity).
Config.ServerSideSpawning = true

true (default): trailers, load vehicles/peds, loaders, rentals, and networked hose props are created with server helpers in server/edit.lua. The client still starts each spawn (mission stage / rental UI) and waits for the net id.

false: those entities use client CreateVehicle / CreatePed / networked CreateObject, then register with the server. Server key/lock/fuel hooks still run when the vehicle is registered.

Fuel, keys, and lock state: Integrations.

Rentals

Config.Rentals = {
    Enabled = true,
    Marker = { Type = 39, Size = vector3(1.0, 1.0, 1.0), Color = { 255, 0, 0, 100 } },
    Zone = vector4(1219.46, -3203.99, 4.59, 177.74),
    Trucks = {
        { name = "Los Santos Phantom", model = `phantom`, price = 500 },
        { name = "Los Santos Packer", model = `packer`, price = 500 },
        { name = "Los Santos Hauler", model = `hauler`, price = 500 },
    },
}

Load / drop zones

Config.ZoneDebug = false
Config.ZoneSize = vector3(4.0, 16.0, 7.0)
Config.ZoneColor = { 255, 0, 0, 100 }

Reputation

Config.Reputation = {
    Enable = true,
    MaxReputation = 1000,
    UnFinished = { 3, 6 },
    Finished = 2,
    FinishedIllegal = { 2, 4 },
    BonusPay = { 18, 22 },
    HideJobs = false,
    Leaderboard = 10,
}

Details: Reputation.

Jobs (`Config.Loads`)

Each entry is one listable job. Full commented example: Jobs & loads. Runtime jobs: Custom jobs.

On this page