Configuration

Defaults below are copied from the shipped config.lua for version 1.0.0. Settings are described using the Configuration conventions.

⚙️ Core, payment and interaction


Config.Debug = true
Config.OpenCommand = 'trucking'
Config.PayAccount = 'cash' -- cash or bank
Config.PurchaseAccounts = { default = 'cash', allowed = { cash = true, bank = true } }
Config.Interaction = 'target' -- drawtext or target
Config.Target = 'auto' -- auto, qb, ox, none
Config.DrawText = { key = 'E', theme = 'purple' }
Config.ReturnTruckToPort = true
Config.TrailerHookDistance = 7.5

Option	Default	What it does
Config.Debug	true	Ships enabled. Turn off in production.
Config.PayAccount	‘cash’	Where route payouts go: cash or bank.
Config.PurchaseAccounts	cash default, cash and bank allowed	Accounts that can pay for trucks and upgrades.
Config.Interaction	‘target’	target or drawtext.
Config.ReturnTruckToPort	true	Require returning the truck to the port to finish.
Config.TrailerHookDistance	7.5	Distance to attach a trailer.

⚙️ Admin, job ped and blip


Config.Admin = {
    addXpCommand = 'truckingaddxp',
    resetStatsCommand = 'truckingresetstats',
    acePermission = 'orioncore.admin',
    groups = { admin = true, god = true, owner = true }
}
 
Config.UsePed = true
Config.JobPed = { model = 's_m_m_trucker_01', coords = vector4(805.95, -3184.19, 5.96, 169.12), scenario = 'WORLD_HUMAN_CLIPBOARD' }
Config.JobBlip = { enabled = true, sprite = 477, color = 5, scale = 0.85, shortRange = true }

Option	Default	What it does
Config.Admin.acePermission	‘orioncore.admin’	ACE that grants admin commands.
Config.Admin.groups	admin, god, owner	Framework groups allowed to use admin commands.
Config.JobPed	trucker at the port	Model, coordinates and scenario of the job ped.

⚙️ Company and progression


Config.Company = { name = 'Nomad Trucking', createCost = 10000, minLevel = 4, maxMembers = 4, inviteDistance = 12.0, multiplayerBonus = 0.10 }
 
Config.Progression = {
    baseLevel = 1,
    levels = { [1] = 0, [2] = 1000, [3] = 2500, ... [18] = 129000 },
    reputationNames = { [1] = 'New Driver', [3] = 'Reliable Hauler', ... [18] = 'Logistics Legend' }
}

Option	Default	What it does
Company.createCost	10000	Price to create a company.
Company.minLevel	4	Level required to create one.
Company.maxMembers	4	Members per company.
Company.multiplayerBonus	0.10	Pay bonus for multiplayer routes.
Progression.levels	18 levels	XP needed for each level (level 2 at 1000, level 18 at 129000).
Config.Achievements	7 entries	Stat based achievements: routesCompleted, totalEarned or level.

⚙️ Trucks, upgrades and haul types


Config.Trucks = {
    { id = 'phantom', label = 'Phantom Day Cab', model = `phantom`, class = 'starter', price = 0, requiredLevel = 1, profitBonus = 0.0, defaultOwned = true },
    { id = 'packer',  class = 'regional', price = 18000, requiredLevel = 5,  profitBonus = 0.10 },
    { id = 'hauler',  class = 'longhaul', price = 42000, requiredLevel = 10, profitBonus = 0.15 },
    { id = 'phantom3', class = 'elite',   price = 75000, requiredLevel = 15, profitBonus = 0.20 }
}

Option	Default	What it does
Config.Trucks	4 trucks	phantom (free), packer 18000, hauler 42000, phantom3 75000.
Config.CargoUpgrades	4 upgrades	standard (free), secured loads +3%, priority freight +6%, specialized cargo +9%.
Config.HaulTypes	9 types	Each has payMultiplier and xpMultiplier (general 1.0 up to military 1.20 pay).
Config.TruckClassRank	starter 1 to elite 4	Used to gate routes by truck class.

⚙️ Routes

Config.Routes is a list. Each route has an id, label, type (Solo or Multiplayer), difficulty, pay, xp, requiredLevel, requiredTruckClass, cargo, allowed haulTypes, a pickup group, a dropoff and optional variants. Special loading types (vehicle_carrier and forklift_pallets) add a loading table.


{
    id = 'short_docks',
    label = 'Port Supply Run',
    type = 'Solo',
    difficulty = 'Easy',
    pay = 2500,
    xp = 350,
    requiredLevel = 1,
    requiredTruckClass = 'starter',
    cargo = 'Retail Goods',
    haulTypes = { 'general', 'fragile', 'refrigerated' },
    pickupGroup = 'docks',
    dropoff = vector3(953.31, -2187.43, 30.55),
    variants = { { id = 'short_docks_la_mesa', dropoff = vector3(-1087.26, -480.44, 36.69) } }
}

Option	Default	What it does
short_docks	Solo, Easy	Pay 2500, level 1.
sandy_freight	Solo, Medium	Pay 5600, level 5, regional truck.
paleto_longhaul	Multiplayer, Hard	Pay 11200, level 10, longhaul truck.
vehicle_hauler	Solo, Medium	Pay 8500, level 8, car carrier loading.
flatbed_pallets	Solo, Medium	Pay 7600, level 6, forklift pallet loading.