Driving & Handling

Three handling-focused configurations.

Drift Mode

lua

Config.DriftMode = {
    enabled = true,
    jobs = {},                -- e.g. {"mechanic", "racer"}
    discordRoles = {},        -- e.g. {"123456789012345678"}
}

Field	Type	Default	Description
enabled	boolean	true	Master toggle
jobs	string[]	{}	Job whitelist (empty = everyone)
discordRoles	string[]	{}	Discord role whitelist (empty = no Discord check)

See Permission System for OR-logic.

Speed Limiter

lua

Config.SpeedLimiterPresets = {50, 80, 100, 120, 150, 200}

• Array of speeds in km/h
• Each value becomes a button in the speed limiter row
• Add or remove values to taste

Module flag	Default	Description
Config.Modules.SpeedLimiter	true	Show speed limiter UI

Suspension

The full suspension config:

lua

Config.Suspension = {
    enabled = true,
    nativeMultiplier = 0.1,

    presets = {
        veryHigh = 0.85,
        high     = 0.70,
        standard = 0.50,
        low      = 0.30,
        jack     = 1.0,
    },

    custom = {
        min  = 0.0,
        max  = 1.0,
        step = 0.01,
    },

    autoLowering = {
        enabled      = true,
        defaultSpeed = 65,
        targetPreset = "low",
        speedOptions = {40, 50, 65, 80, 100, 120},
    },
}

Top-Level Fields

Field	Type	Default	Description
enabled	boolean	true	Master toggle
nativeMultiplier	number	0.1	Multiplier applied to all suspension values

Presets

Each preset is a number from 0.0 (lowest) to 1.0 (highest). The actual native value applied is preset × nativeMultiplier.

Preset	Default	Use case
veryHigh	0.85	Off-road / desert running
high	0.70	Slightly raised stance
standard	0.50	Default stock height
low	0.30	Sport / lowered stance
jack	1.0	Maximum lift (e.g. for working on car)

You can rename keys, add new presets, or remove ones — the UI auto-generates buttons from this table.

Custom Slider

lua

custom = {
    min  = 0.0,
    max  = 1.0,
    step = 0.01,
}

Bounds and increment for the fine-tune slider. Players can set any value between min and max in steps of step.

Auto-Lowering

A thread monitors vehicle speed every frame. When speed exceeds defaultSpeed (in km/h), the suspension transitions to targetPreset. When speed drops back below, it returns to whatever the player had set manually.

lua

autoLowering = {
    enabled      = true,
    defaultSpeed = 65,            -- km/h threshold
    targetPreset = "low",         -- one of the keys in presets
    speedOptions = {40, 50, 65, 80, 100, 120},  -- selectable thresholds in UI
}

Field	Type	Default	Description
enabled	boolean	true	Master toggle for auto-lower
defaultSpeed	number	65	Default speed threshold (km/h)
targetPreset	string	"low"	Preset key used when threshold is exceeded
speedOptions	number[]	{40, 50, 65, 80, 100, 120}	Speed values shown as buttons in the UI

Tip

For a noticeable but realistic effect, leave targetPreset = "low" (0.30) and defaultSpeed = 65. Set targetPreset = "standard" if you want only minor auto-adjustment.

Module Toggle Cross-Reference

Module flag	Controls
Config.Modules.Suspension	Whether suspension UI shows at all
Config.Modules.SpeedLimiter	Whether speed limiter UI shows
Config.DriftMode.enabled	Whether drift mode is even toggleable