Vehicle Parts

All vehicle parts are configured in config.lua. Each part has performance values, durability, pricing, and can be restricted to specific vehicle types.

Part Categories

Engines

Swap the entire engine block. From stock to 2JZ, V8, and more.

Transmissions

Manual or auto gearbox with RWD/AWD drivetrain options.

Tires

Grip and durability. From stock rubber to Michelin racing tires.

Brakes

Stopping power. Stock, carbon ceramic, or full race brakes.

Suspension

Handling and ride height. Sport, coilover, and air ride options.

Oil

Engine lubrication. Better oil means slower engine wear.

Sparkplugs

Ignition performance. NGK and Iridium upgrades available.

Turbo

Forced induction. Two levels of turbo boost.

Nitro

NOS boost system. Standard and extreme variants.

Engines

Engines = {
    ['stock_engine'] = {
        label = "Stock Engine",
        type = 'car',
        power = 0.0,
        durability = 100.0,
        price = 0,
        repair = 0
    },
    ['v8engine'] = {
        label = "V8 Engine",
        type = 'car',
        power = 60.0,
        durability = 80.0,
        price = 15000,
        repair = 5000
    },
    ['2jzengine'] = {
        label = "2JZ Engine",
        type = 'car',
        power = 70.0,
        durability = 75.0,
        price = 20000,
        repair = 7000
    },
    -- More engines available in config.lua
}

INFO

power values are relative — they add to the vehicle's base performance. durability determines how fast the part wears out.

Transmissions

Transmissions require a workshop lift for installation.

Transmissions = {
    ['stock_transmission'] = {
        label = "Stock Transmission",
        type = 'car',
        power = 0.0,
        durability = 100.0,
        gearbox = 'auto',
        drivetrain = 'stock',
        price = 0,
        repair = 0
    },
    ['manual_gearbox_rwd'] = {
        label = "Manual Gearbox RWD",
        type = 'car',
        power = 10.0,
        durability = 85.0,
        gearbox = 'manual',
        drivetrain = 'rwd',
        price = 8000,
        repair = 3000
    },
}

Gearbox Types

Type	Description
auto	Automatic shifting
manual	Player-controlled shifting with configurable keys

Drivetrain Types

Type	Description
stock	Keeps the vehicle's default drivetrain
rwd	Rear-wheel drive
awd	All-wheel drive

Tires

Tires = {
    ['stock_tires'] = {
        label = "Stock Tires",
        type = 'car',
        grip = 0.0,
        durability = 100.0,
        price = 0,
        repair = 0
    },
    ['michelin_pilot'] = {
        label = "Michelin Pilot Sport",
        type = 'car',
        grip = 15.0,
        durability = 80.0,
        price = 3000,
        repair = 1000
    },
}

Brakes

Brakes = {
    ['stock_brakes'] = {
        label = "Stock Brakes",
        type = 'car',
        power = 0.0,
        durability = 100.0,
        price = 0,
        repair = 0
    },
    ['carbon_brakes'] = {
        label = "Carbon Ceramic Brakes",
        type = 'car',
        power = 25.0,
        durability = 70.0,
        price = 8000,
        repair = 3000
    },
}

Adding Custom Parts

To add a new part, follow this pattern:

['your_part_name'] = {
    label = "Display Name",
    type = 'car',           -- 'car', 'motorcycle', 'plane', 'boat'
    power = 50.0,           -- Performance boost (relative)
    durability = 80.0,      -- Wear resistance (100 = longest lasting)
    price = 10000,          -- Purchase price
    repair = 3000           -- Repair cost (metalscrap amount)
},

WARNING

Every custom part must be added as an item in your inventory system with the same name as the config key (e.g., your_part_name).