Configuration · origen_vehiclehandling

All settings live in config.lua.

General

Variable	Default	Description
`Config.Debug`	`false`	Print debug messages to the server and client console
`Config.CheckInterval`	`2000`	Milliseconds between each vehicle handling sync check on the client
`Config.Hotkey`	`'F4'`	Default key to open the handling panel while inside a vehicle
`Config.FocusHotkey`	`'LMENU'`	Default key to toggle NUI mouse focus
`Config.Locale`	`'en'`	Active UI language — `'en'` or `'es'` built-in

While inside the NUI, focus can also be toggled with G (hardcoded internal control).

Config.Vehicles

Handling presets loaded at resource start from the config file. These entries are merged with the database; database values take priority for the same model.

lua

Config.Vehicles = {
    ['Police'] = {
        ['hvaleutian'] = {
            maxSpeed  = 220.0,
            driveForce = 0.35,
            gears      = 6,
            shiftSpeed = 1.2,
        },
    },
}

The outer key is the category name; the inner key is the vehicle spawn name. All handling fields are optional — any omitted value uses the database or GTA default.

Supported handling fields:

Field	Native param	Default
`maxSpeed`	`fInitialDriveMaxFlatVel`	`150.0`
`driveForce`	`fInitialDriveForce`	`0.2`
`gears`	`nInitialDriveGears`	`6`
`shiftSpeed`	`fClutchChangeRateScaleUpShift`	`1.0`
`brakeForce`	`fBrakeForce`	`0.5`
`brakeBias`	`fBrakeBiasFront`	`0.5`
`steeringLock`	`fSteeringLock`	`40.0`
`tractionMax`	`fTractionCurveMax`	`2.5`
`tractionMin`	`fTractionCurveMin`	`2.0`
`tractionBias`	`fTractionBiasFront`	`0.5`
`tractionLoss`	`fTractionLossMult`	`1.0`
`suspensionForce`	`fSuspensionForce`	`2.0`
`suspensionHeight`	`fSuspensionUpperLimit`	`0.0`
`suspensionLowerLimit`	`fSuspensionLowerLimit`	`-0.1`
`suspensionComp`	`fSuspensionCompDamp`	`1.0`
`suspensionRebound`	`fSuspensionReboundDamp`	`1.0`
`mass`	`fMass`	`1500.0`
`dragCoeff`	`fInitialDragCoeff`	`10.0`
`driveBias`	`fDriveBiasFront`	`0.5`
`inertia`	`fDriveInertia`	`1.0`
`antiRollBar`	`fAntiRollBarForce`	`0.5`
`rollCentreFront`	`fRollCentreHeightFront`	`0.0`
`rollCentreRear`	`fRollCentreHeightRear`	`0.0`
`collisionMult`	`fCollisionDamageMult`	`1.0`
`engineMult`	`fEngineDamageMult`	`1.0`
`deformationMult`	`fDeformationDamageMult`	`1.0`

Config.Permissions

Controls who can open and use the handling panel.

lua

Config.Permissions = {
    UseOrigenAdmin         = true,
    UseFrameworkFallback   = true,
    UseAceFallback         = true,
    EnableLicenseWhitelist = true,
    AllowedLicenses        = {
        -- 'license:1234567890abcdef1234567890abcdef12345678',
    }
}

Field	Default	Description
`UseOrigenAdmin`	`true`	Check permissions via `origen_admin:HasPermission` when the resource is running
`UseFrameworkFallback`	`true`	Allow QBCore `admin`/`god` groups or ESX `admin`/`superadmin` groups
`UseAceFallback`	`true`	Allow players with `origen.vehiclehandling`, `admin`, or `command` ACE nodes
`EnableLicenseWhitelist`	`true`	Grant access to identifiers listed in `AllowedLicenses`
`AllowedLicenses`	`{}`	List of `license:` or `license2:` identifiers that always have access

The permission chain is evaluated in this order: whitelist → origen_admin → ACE origen.vehiclehandling → framework group → ACE admin/command.

Config.Notify

Configures the in-game notification provider.

lua

Config.Notify = {
    provider = 'origen_notify',
    title    = 'Vehicle Handling',
    duration = 5000
}

Field	Default	Description
`provider`	`'origen_notify'`	Notification backend — `'origen_notify'` \| `'ox_lib'` \| `'qbcore'` \| `'esx'` \| `'chat'` \| `'custom'`
`title`	`'Vehicle Handling'`	Title shown in the notification (where the provider supports it)
`duration`	`5000`	Duration in milliseconds

Config.CustomNotify

Used only when Config.Notify.provider = 'custom'. Define your own function:

lua

Config.CustomNotify = function(message, msgType, duration, title)
    -- message  : string  — notification body
    -- msgType  : string  — 'success' | 'error' | 'info'
    -- duration : number  — milliseconds
    -- title    : string  — notification title
end

Example — ox_lib:

lua

Config.CustomNotify = function(message, msgType, duration, title)
    if lib and lib.notify then
        lib.notify({
            title       = title,
            description = message,
            type        = msgType,
            duration    = duration,
        })
    end
end

Config.Locales

Built-in translations. Two locales ship with the resource (en and es). To add a custom locale, extend the table and set Config.Locale to its key:

lua

Config.Locale = 'pt'
 
Config.Locales = {
    -- ... existing locales ...
    pt = {
        confirm = 'Confirmar',
        -- ... add all keys ...
    }
}

Commands

The following chat/console commands are registered on the client:

Command	Restricted	Description
`/vh`	No	Start Live Handling on the current vehicle (must be the driver)
`/vhnew [model] [category]`	No	Open Live Handling for a specific model — spawns the vehicle if needed
`/vhmenu`	No	Open the main handling panel (categories and vehicle list)
`/vhsave`	No	Save the active live session to the database
`/vhdiscard`	No	Discard the active live session without saving
`openHandlingV2`	Yes (ACE)	Open the handling panel — intended for admin keybinds
`toggleHandlingFocus`	Yes (ACE)	Toggle NUI mouse focus

/vh and /vhnew open the Live Handling editor directly on a vehicle, bypassing the main panel. Both require the player to have live-edit permission (origen.vehiclehandling.liveedit or full management access).