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 CategoriesCopy Anchor Link

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.

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

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

Mod Application & PartsCopy Anchor Link

📄 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 LabelsCopy Anchor Link

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 MappingCopy Anchor Link

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 ChipCopy Anchor Link

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.

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.

Gearbox & SoundsCopy Anchor Link

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.