Config

Settings

General resource settings that affect development and diagnostics.

debug

Enables debug behavior for the resource. Only enable this in development environments because it exposes dangerous commands. Example:

debug = false

DamageSystem

Configures the realistic vehicle damage system. The selected preset is loaded from shared/presets.lua, then any values in overrides are applied on top of that preset.

enabled

Master toggle for the entire damage system. When set to false, all damage-related logic is disabled and the resource skips damage processing entirely. Visual deformation syncing continues to work independently regardless of this setting. Example:

enabled = true

preset

Selects the preset level that defines the default values for all damage-related settings. Valid levels are 1 for Arcade, 2 for Casual, 3 for Balanced, 4 for Realistic, and 5 for Hardcore. Balanced is the recommended default. If an invalid level is configured, the resource falls back to Balanced. Example:

preset = 3

overrides

A table of key-value pairs that override individual damage settings after the preset is applied. Each key must match a valid damage system key from shared/presets.lua; for example, { limpMode = true, damageFactorEngine = 5.0 } changes only those values while keeping the rest of the selected preset. Example:

overrides = {}

Choosing Between Presets And Overrides

Use preset when you want a complete difficulty profile. Use overrides when you like a preset overall but want to tune one or more values.

The resource resolves the damage system in this order:

1. Reads Config.DamageSystem.preset.

2. Loads that preset from shared/presets.lua.

3. Falls back to preset 3 if the selected preset does not exist.

4. Copies every value from the preset into Config.DamageSystem.

5. Applies every value from Config.DamageSystem.overrides on top.

You normally should not edit shared/presets.lua. Edit it only if you want to permanently change the built-in preset definitions for the whole resource. If you only want to customize your server, keep using shared/config.lua and place changed values inside overrides. After changing preset definitions and restarting the resource, players should re-enter their vehicle so the new handling values are applied.

Config.DamageSystem = {
    enabled = true,
    preset = 3,
    overrides = {
        limpMode = true,
        damageFactorEngine = 5.0,
    },
}

Preset Values

Key	Arcade	Casual	Balanced	Realistic	Hardcore
damageFactorEngine	0.4	0.8	1.2	1.6	3.2
damageFactorBody	0.5	1.5	2.0	3.0	5.0
damageFactorPetrolTank	10.0	30.0	48.0	64.0	100.0
deformationExponent	0.6	0.5	0.45	0.4	0.3
collisionDamageExponent	0.8	0.7	0.65	0.6	0.5
engineDamageExponent	0.8	0.7	0.65	0.6	0.5
deformationMultiplier	4.2	5.6	7.0	8.4	11.2
weaponsDamageMultiplier	0.5	1.0	1.5	2.0	3.0
degradingFailureThreshold	240.0	360.0	420.0	480.0	540.0
cascadingFailureThreshold	150.0	250.0	300.0	360.0	450.0
engineSafeGuard	200.0	150.0	120.0	100.0	80.0
degradingHealthSpeedFactor	0.4	1.0	1.6	2.0	3.0
cascadingFailureSpeedFactor	0.4	0.8	1.2	1.6	2.4
torqueMultiplierEnabled	false	true	true	true	true
torqueDegradationThreshold	200	400	500	600	700
limpMode	true	true	false	false	false
limpModeMultiplier	0.4	0.25	0.19	0.19	0.15
preventVehicleFlip	false	false	true	true	true
classDamageMultiplier	default table	default table	default table	default table	default table

Override Keys

Key	What It Controls	Notes / Range
damageFactorEngine	Multiplies engine health damage.	Higher values make engine damage harsher.
damageFactorBody	Multiplies body health damage.	Higher values make body damage harsher. Also affects weapon damage handling normalization.
damageFactorPetrolTank	Multiplies petrol tank health damage.	Higher values make petrol tank damage harsher.
weaponsDamageMultiplier	Sets weapon damage handling for vehicles.	Use 0.0-10.0, or -1 to leave weapon damage handling untouched.
deformationExponent	Compresses each vehicle's original deformation handling before applying deformationMultiplier.	Lower preset values make deformation tuning more aggressive.
collisionDamageExponent	Compresses each vehicle's original collision damage handling toward 1.0.	Used when applying fCollisionDamageMult.
engineDamageExponent	Compresses each vehicle's original engine damage handling toward 1.0.	Used when applying fEngineDamageMult.
deformationMultiplier	Multiplies visual deformation handling.	For manual overrides, use 0.0-10.0, or -1 to leave deformation handling untouched. The Hardcore preset uses 11.2.
degradingFailureThreshold	Engine health threshold where slow passive degradation starts.	Higher values make degradation start earlier.
cascadingFailureThreshold	Engine health threshold where rapid cascading failure starts.	Higher values make severe failure start earlier.
engineSafeGuard	Minimum engine health floor while not in fire mode.	Lower values allow the engine to degrade further. If limp mode is disabled, vehicles below this point become undriveable.
degradingHealthSpeedFactor	Speed of slow passive engine degradation.	Higher values drain engine health faster between the degrading and cascading thresholds.
cascadingFailureSpeedFactor	Speed of rapid engine degradation.	Higher values drain engine health faster below the cascading threshold.
torqueMultiplierEnabled	Enables torque loss as engine health drops.	Boolean. Uses torqueDegradationThreshold.
torqueDegradationThreshold	Engine health below which torque starts degrading.	Higher values make torque loss begin earlier.
limpMode	Allows a damaged vehicle to keep moving at reduced power near the safeguard threshold.	Boolean. Uses limpModeMultiplier.
limpModeMultiplier	Torque multiplier used during limp mode.	The override guidance in presets.lua recommends 0.05-0.25; higher values make limp mode less restrictive. The Arcade preset uses 0.4.
preventVehicleFlip	Helps prevent upside-down vehicles from being flipped back over by throttle input.	Boolean.
classDamageMultiplier	Per-class damage multiplier table for vehicle classes 0-21.	Higher values make that class take more damage. Classes not listed use 1.0.

Default Class Multipliers

classDamageMultiplier lets you tune damage by GTA vehicle class. For example, the default table makes motorcycles weaker than most cars and makes industrial vehicles tougher.

Class	Vehicle Type	Default
0	Compacts	1.0
1	Sedans	1.0
2	SUVs	1.0
3	Coupes	1.0
4	Muscle	1.0
5	Sports Classics	1.0
6	Sports	1.0
7	Super	1.0
8	Motorcycles	1.25
9	Off-road	0.7
10	Industrial	0.25
11	Utility	1.0
12	Vans	1.0
13	Cycles	1.0
14	Boats	0.5
15	Helicopters	1.0
16	Planes	1.0
17	Service	0.75
18	Emergency	0.75
19	Military	0.75
20	Commercial	1.0
21	Trains	1.0

Cycles, helicopters, planes, and trains are excluded from the damage loop, so their default multipliers are listed for completeness but are not used by normal damage processing.

overrides = {
    classDamageMultiplier = {
        [0] = 1.0,  -- Compacts
        1.0,        -- Sedans
        1.0,        -- SUVs
        1.0,        -- Coupes
        1.0,        -- Muscle
        1.0,        -- Sports Classics
        1.0,        -- Sports
        1.0,        -- Super
        1.25,       -- Motorcycles
        0.7,        -- Off-road
        0.25,       -- Industrial
        1.0,        -- Utility
        1.0,        -- Vans
        1.0,        -- Cycles
        0.5,        -- Boats
        1.0,        -- Helicopters
        1.0,        -- Planes
        0.75,       -- Service
        0.75,       -- Emergency
        0.75,       -- Military
        1.0,        -- Commercial
        1.0,        -- Trains
    },
}