All settings are in config.lua.
General#
Config.TestMode = false -- Show 3D debug rays and speed text
Config.EnableCommands = true -- Enable /fixVehicle and /fv
Config.EnableCompatible = true -- Mechanic script compatibility bridge
Config.OldVersion = false -- Legacy wheel damage (NOT recommended)
Crash damage#
Config.Damage = 100.0 -- Body damage per impact tick
Config.DamageTime = 1 -- Number of damage ticks
Config.DamageRadius = 15.1 -- Visual damage radius
Config.DetectionTimeForNextCrash = 1000 -- Cooldown between crashes (ms)
Config.EnableMinCrashSpeed = true
Config.MinCrashSpeed = 5.0 -- Minimum speed for damage (m/s)
Damage levels#
Config.DamageLevels = {
{ min = 10.0, max = 20.0 }, -- Tire burst
{ min = 21.0, max = 300.0 }, -- Wheel breakage
}
Hit ignore#
Skip damage when the raycast hits certain entity types:
Config.HitIgnore = {
[0] = false, -- No entity
[1] = true, -- Ped (ignore)
[2] = false, -- Vehicle
[3] = false, -- Object
}
Post-crash behavior#
Config.StopVehicleWhenCrash = true -- Stall engine after wheel crash
Config.StopTimeout = 2000 -- Stall duration (ms)
Config.ForceStopAfterCrash = true -- Force engine off instantly
Config.TimeoutWheeelRemove = 60000 -- Remove spawned wheel props (ms)
Vehicle ignore list#
Exclude certain vehicles or classes from damage:
Config.Ignore = {
Enable = true,
VehicleTypes = {
[8] = true, -- Motorcycles
[10] = true, -- Industrial
-- ...
},
Vehicles = {
["JACKAL"] = true, -- Specific model (uppercase)
},
}
Part damage#
Config.PartSettings = {
enableEngineDamage = true,
enableRadiatorDamage = false,
enableFuelTankDamage = true,
Radiator = { minSpeed = 5.0, damage = 10.0 },
Engine = { minSpeed = 5.0, damage = 20.0 },
FuelTank = { minSpeed = 5.0, damage = 15.0 },
}
Toolbox#
Config.ToolBoxItem = "repair_toolbox"
Config.ToolBoxProps = {
["open"] = "ch_prop_toolbox_01b",
["closed"] = "ch_prop_toolbox_01a",
}
Wheel repair props#
Config.EnableWheelRepairWith3D = true
Config.DefaultWheelModel = `prop_wheel_03`
Config.DefaultWheelBoltsModel = `gr_prop_gr_wheel_bolt_01a`
Config.DefaultWrenchModel = `xs_prop_x18_torque_wrench_01a`
Wheel spawn models (on crash)#
Config.WheelModels = {
wheel = `prop_tornado_wheel`,
rim = `prop_wheel_rim_03`,
}
Land restriction#
Config.EnableLandRestriction = true
Surface materials and vehicle classes are defined in Config.SurfaceMaterials and Config.VehicleClasses. Per-class settings are stored in landData.json (auto-generated on first start).
Customize handling per surface in Config.HandlingSets:
slippery,soft,rough,reset,normal
For fully custom logic, edit Config.CustomHandlingThread(vehicle).
Damage indicators#
Raycast points that detect crash impact zones:
Config.DamageIndicators = {
{ name = "front_center", offset = vector3(0.0, 3.5, 0.0) },
{ name = "front_right", offset = vector3(1.5, 2.5, 0.3), index = 1, bone = "wheel_rf" },
{ name = "front_left", offset = vector3(-1.5, 2.5, 0.3), index = 0, bone = "wheel_lf" },
{ name = "rear_right", offset = vector3(2.5, -3.5, -0.0), index = 5, bone = "wheel_rr" },
{ name = "rear_left", offset = vector3(-2.5, -3.5, -0.0), index = 4, bone = "wheel_lr" },
-- ...
}
Add new indicators to create additional damage zones.
Language#
Customize notification messages:
Config.Lang = {
["toolbox_in_use"] = "You are already using the toolbox.",
["engine_repaired_success"] = "Engine repaired successfully!",
["fueltank_damaged"] = "Fuel Tank Damaged!",
-- ...
}
UI button labels#
Each repair workflow has configurable on-screen button hints:
Config.Toolbox_ui_buttonsConfig.TireItem_ui_buttonsConfig.TireRepair_ui_buttonsConfig.EngineRepairKit_ui_buttonsConfig.Radiator_ui_buttonsConfig.RepairRadiator_ui_buttons
Target options#
Vehicle and toolbox target menus are fully configurable:
Config.ToolboxTargetOptions— Hood, trunk, engine, radiator, fuel tankConfig.ToolboxTireOptions— Toolbox tool selection