Handling Editor

📄 Config file: shared/handling/handling_cfg.lua

The handling editor is an in-game tool that allows admins/mechanics to modify a vehicle's handling data in real time. Changes can be saved per-vehicle and persist in the database. It has two modes: Detailed (individual handling values) and Simplified (one-click presets).

Enhanced UI

The editor features a horizontal scrolling category bar for easy navigation and a real-time dyno data overlay that shows HP, Torque, and RPM during live preview mode.

---

Command & Access

Config.HandlingEditor = {
    Command           = "hdl-editor",
    AdminOnly         = true,
    JobRestrictions   = {},
    PersistenceTable  = "handling_vehicle_data",
}

Setting	What it does
Command	The chat command to open the handling editor. Default is /hdl-editor.
AdminOnly	When true, only admins can use the command. Set to false to allow regular players/mechanics.
JobRestrictions	A list of job names that can use the editor. Leave empty {} for no job restriction (uses AdminOnly instead).
PersistenceTable	Database table name where handling modifications are saved per vehicle.

---

Detailed Mode — Categories

The detailed editor groups handling properties into categories. Each property has a slider with min/max/step values.

Chassis

Property	Label	Range	What it does
fMass	Vehicle Weight (kg)	1–10,000	The weight of the vehicle. Heavier = slower acceleration, harder to push.
vecCentreOfMassOffset	Centre of Mass Offset	Vector	Where the center of gravity sits. Affects rollover tendency.
vecInertiaMultiplier	Inertia Multiplier	Vector	How mass is distributed. Affects how "floaty" the car feels in turns.

Aerodynamics

Property	Label	Range	What it does
fInitialDragCoeff	Air Resistance	0–20	How much air slows the car at high speed. Higher = more drag.
fDownforceModifier	Downforce	0–100	Artificial grip added at high speeds. Higher = more grip in fast corners.

Drive Train

Property	Label	Range	What it does
fInitialDriveForce	Acceleration	0.01–2.0	Raw engine power. This is the most impactful performance value.
fDriveBiasFront	Drive Bias	0–1	Power split: 0.0 = RWD (rear-wheel drive), 0.5 = AWD, 1.0 = FWD (front-wheel drive).
fDriveInertia	Drive Inertia	0.01–2.0	How quickly the engine revs up. Recommended to keep near 1.0.
nInitialDriveGears	Gears	1–10	Number of forward gears in the transmission.
fInitialDriveMaxFlatVel	Top Speed (MPH)	1–500	The theoretical maximum speed on flat ground.

Brakes

Property	Label	Range	What it does
fBrakeForce	Brake Strength	0.01–4.0	Overall braking power.
fBrakeBiasFront	Front Brake Bias	0–1	How braking is distributed between front and rear. 0.65 is realistic for most cars.
fHandBrakeForce	Handbrake Strength	0–2	Power of the handbrake/emergency brake.

Traction

Property	Label	Range	What it does
fTractionCurveMin	Traction Curve Min	0.1–10	Minimum cornering grip.
fTractionCurveMax	Traction Curve Max	0.1–10	Maximum cornering grip.
fTractionCurveLateral	Traction Curve Lateral	0.1–30	Sideways grip (affects sliding behaviour).
fTractionBiasFront	Traction Bias Front	0.01–0.99	Grip distribution between front and rear wheels.
fLowSpeedTractionLossMult	Low Speed Traction Loss	0–2	How much grip is lost at low speeds (burnouts, donuts).

Suspension

Property	Label	Range	What it does
fSuspensionForce	Suspension Force	0.1–10	Stiffness of the springs. Higher = stiffer ride.
fSuspensionCompDamp	Comp Damp	0–1	How fast the suspension compresses.
fSuspensionReboundDamp	Rebound Damp	0–1	How fast the suspension bounces back after compression.
fSuspensionUpperLimit	Upper Limit	-1 to 1	Maximum upward travel.
fSuspensionLowerLimit	Lower Limit	-1 to 1	Maximum downward travel.
fSuspensionRaise	Suspension Raise	-0.5 to 0.5	General ride height. Positive = higher, negative = lower.
fSuspensionBiasFront	Suspension Bias Front	0.01–0.99	Distribution between front and rear.
fAntiRollBarForce	Antiroll Strength	0–2	How strongly the car resists body roll in corners.

Damage

Property	Label	Range	What it does
fCollisionDamageMult	Collision Damage	0–10	How much damage crashes cause.
fWeaponDamageMult	Weapon Damage	0–10	How much damage bullets/explosives cause.
fDeformationDamageMult	Deformation Damage	0–10	How easily the body panels deform on impact.
fEngineDamageMult	Engine Damage	0–10	How vulnerable the engine is to damage.

---

Simplified Mode — Presets

The simplified mode offers one-click presets for common handling setups. Each preset applies multiple handling values at once.

Acceleration Presets

Preset	Description
Stock	Resets to the vehicle's original drive force.
Sportscar	Moderate power (0.35 force, 160 MPH).
Supercar	High power (0.45 force, 180 MPH).
Truck	Low power, heavy vehicle (0.25 force, 110 MPH, 3000kg).
Hypercar	Maximum power (0.55 force, 220 MPH).

Traction Presets

Preset	Description
Normal Traction	Average grip for everyday vehicles.
Sport Traction	Higher grip for sportier cars.
Track Traction	Maximum grip for race track setups.
Offroad Traction	Tuned for off-road driving.
Drift Traction	Low grip with extended steering lock for drift builds.

Brake Presets

Preset	Description
Stock Brakes	Original braking force.
Street Brakes	Moderate braking (0.8 force).
Sport Brakes	Strong braking (1.2 force).
Racing Brakes	Maximum braking (2.0 force).

Drivetrain Presets

Preset	Description
Default	Vehicle's original drivetrain.
RWD Bias	Rear-wheel drive (0.0 bias).
FWD Bias	Front-wheel drive (1.0 bias).
AWD (50/50)	All-wheel drive, evenly split (0.5 bias).

You can add more presets by extending the Simplified tables. Each preset is a label and a set of handling values to apply. Use "base" as a value to reset that property to the vehicle's stock handling.