Gearbox Options

📄 Config file: shared/gearbox_options.lua

This file controls which gearbox types (automatic, manual, semi-automatic) are available for each vehicle model or vehicle class. When a mechanic opens the gearbox category in the customs menu, only the supported types for that specific vehicle will appear.

---

Per-Vehicle Configuration

Config.VehicleGearboxSupport = {
    ['futo']     = { 'manual' },
    ['zentorno'] = { 'auto', 'manual', 'semi' },
    ['adder']    = { 'auto', 'semi' },
    ['panto']    = { 'auto' },
}

Each entry maps a vehicle model name (spawn name) to a list of gearbox types it supports.

Gearbox Type	What it does
'auto'	Automatic transmission — gears shift by themselves. Standard GTA behaviour.
'manual'	Full manual — player must use shift up/down keys and hold the clutch.
'semi'	Semi-automatic (paddle shift) — player uses shift keys but no clutch is needed.

Examples from the defaults:

• futo (drift car) — manual only, because it's a car built for enthusiasts.

• zentorno — supports all three types, giving the owner choice.

• adder — supports auto and semi (supercars often have paddle shifters but not manual).

• panto — auto only (a small city car).

---

Per-Class Configuration

You can also define gearbox support for entire vehicle classes instead of individual models:

Config.VehicleGearboxSupport = {
    ['class_4'] = { 'auto', 'manual' },       -- Muscle
    ['class_6'] = { 'auto', 'manual', 'semi' }, -- Sports
    ['class_7'] = { 'auto', 'manual', 'semi' }, -- Super
}

Use class_ followed by the GTA V vehicle class number. This applies to every vehicle in that class that doesn't have a specific per-model entry.

Class ID	Name
0	Compacts
1	Sedans
2	SUVs
3	Coupes
4	Muscle
5	Sports Classics
6	Sports
7	Super
8	Motorcycles
9	Off-road

---

Default Fallback

Config.DefaultGearboxSupport = { 'auto' }

If a vehicle is not listed in VehicleGearboxSupport (neither by model name nor by class), it falls back to this default. By default, all unlisted vehicles only get the 'auto' gearbox.

Priority order: Specific model name > Class-based entry > Default fallback. If you define both ['zentorno'] and ['class_7'], the zentorno entry wins for that vehicle.