Customs Menu

📄 Config file: shared/customs_config.lua

This file controls the vehicle customs/modification menu — what categories appear, which mods are available, how they're labelled, and the tuning chip system.

---

Mod Categories

ModCategories = {
    ['performance'] = { label = 'Performance', icon = 'Zap', mods = { 11, 12, 13, 15, 18, 'antilag', 'nitro' } },
    ['tuning']      = { label = 'Tuning',      icon = 'Cpu', mods = { 'tuning_chip' } },
    ['cosmetic']    = { label = 'Cosmetic',     icon = 'Hammer', mods = { 0, 1, 2, 3, 4, 5, ... } },
    ['wheels']      = { label = 'Wheels',       icon = 'CircleDashed', mods = { 23, 24 } },
    ['respray']     = { label = 'Respray',      icon = 'Palette', special = 'color' },
    ['gearbox']     = { label = 'Gearbox',      icon = 'Activity', special = 'gearbox' },
}

Each category groups related mods together in the customs UI.

Property	What it does
label	The name displayed in the menu.
icon	The icon displayed next to the category name (uses Lucide icon names).
mods	A list of mod type IDs (numbers) or custom mod keys (strings) included in this category.
special	For special categories like 'color' (respray) or 'gearbox' (gearbox swap) that have custom UI behavior.

The numbers correspond to GTA V's native mod types:

ID	Mod Type
0	Spoilers
1	Front Bumper
2	Rear Bumper
3	Side Skirt
4	Exhaust
5	Frame
6	Grille
7	Hood
8	Fender
10	Roof
11	Engine
12	Brakes
13	Transmission
14	Horns
15	Suspension
16	Armor
18	Turbo
23	Front Wheels
24	Back Wheels
48	Liveries

Custom string keys are for script-specific mods not in the base game:

Key	What it is
'antilag'	Anti-Lag System toggle
'nitro'	Nitro System install
'tuning_chip'	Tuning Chip install

---

Mod Application & Parts

📄 Config file: shared/mod_items.lua

In Kartik-Mechanic, you cannot simply pay cash to upgrade a vehicle. Every modification requires the mechanic to have the physical part item in their inventory.

• Performance Mods: Require boxes or specific mechanical parts (e.g. engine_box_tier1, brakeparts).

• Cosmetic Mods: Require the corresponding cosmetic part item (e.g. spoiler_part, front_bumper_part).

• Nitro & Tuning: Require the nitrous and tuning_chip items respectively.

When a mod is applied, the item is consumed. If you do not have the item, the option will be locked in the menu.

---

Mod Labels

The ModLabels table provides display names and icons for each mod type. The customs menu uses these labels when showing available modifications.

You can change any label or icon to better fit your server's theme. For example, changing 'Turbo' to 'Forced Induction'.

---

Category-to-Mod Mapping

The CategoryToModType table maps human-readable category names to their mod type IDs. This is used internally to link repair/maintenance parts to their corresponding upgrade category.

---

Tuning Chip

Config.Tuning = {
    Boost      = { min = 0.0, max = 1.0, scale = 0.5 },
    GearShifts = { min = 0.0, max = 1.0, scale = 0.4 },
    RevLimiter = { min = 0.0, max = 1.0, scale = 0.25 },
    Traction   = { min = 0.0, max = 1.0, scale = 0.2 },
}

The tuning chip allows in-vehicle fine-tuning through a tablet UI. Each parameter has a slider the player/mechanic can adjust.

Parameter	Scale	What it does
Boost	Up to +50%	Increases overall engine power output.
GearShifts	Up to +40%	Makes gear shifts faster (less time between gears).
RevLimiter	Up to +25%	Raises the top-end speed/velocity cap.
Traction	Up to +20%	Increases tire grip for better cornering.

How the settings work:

• min / max — The slider range (always 0.0 to 1.0).

• scale — The actual multiplier applied. A scale of 0.5 means at max slider position, the vehicle gets a 50% boost.

The tuning chip must be installed on the vehicle first through the customs menu. Once installed, the driver can use a tuning_tablet item to access the tuning interface while sitting in the vehicle.

---

Gearbox & Sounds

Kartik-Mechanic supports swapping between manual, automatic, and semi-automatic (DCT) gearboxes.

• Transmission Swap: Select the Gearbox category to switch your vehicle's drive type. Requires a gearbox item (trans_manual, trans_auto_race, or trans_semi_dct).

• Custom Sounds: After installing a gearbox, you can apply Gearbox Sound Profiles (e.g. Italian, German, Race Sequential).

• Items: Use items like gear_sound_italian to unlock and select these sounds from the menu. Custom sounds add a realistic audio layer to shifting, especially in manual mode.