# tuning config

## Overview

The tuning system configuration is located in `shared/config.tuning.lua`. It defines all available vehicle modifications.

***

## Vehicle Bones

Interactive points on the vehicle for tuning menu.

```lua
Config.Tuning = {
    VehicleBones = {
        {bone = "bonnet", label = "Hood", icon = "fas fa-car-side"},
        {bone = "boot", label = "Trunk", icon = "fas fa-box-open"},
        {bone = "door_dside_f", label = "Driver Door", icon = "fas fa-door-open"},
        {bone = "door_pside_f", label = "Passenger Door", icon = "fas fa-door-closed"},
        {bone = "door_dside_r", label = "Rear Door (L)", icon = "fas fa-door-open"},
        {bone = "door_pside_r", label = "Rear Door (R)", icon = "fas fa-door-closed"},
        {bone = "wheel_lf", label = "Wheels and Tires", icon = "fas fa-compact-disc"},
        {bone = "exhaust", label = "Exhaust", icon = "fas fa-wind"},
        {bone = "bumper_f", label = "Front Bumper", icon = "fas fa-car-crash"},
        {bone = "bumper_r", label = "Rear Bumper", icon = "fas fa-car-burst"},
    },
}
```

| Option | Type   | Description             |
| ------ | ------ | ----------------------- |
| bone   | string | GTA V vehicle bone name |
| label  | string | Display name in menu    |
| icon   | string | FontAwesome icon class  |

***

## Tuning Categories

### Performance Modifications

```lua
Categories = {
    {
        id = "engine",
        name = "Engine",
        description = "Increase engine power",
        modType = 11,
        icon = "engine"
    },
    {
        id = "brakes",
        name = "Brakes",
        description = "Improve braking",
        modType = 12,
        icon = "brake-warning"
    },
    {
        id = "transmission",
        name = "Transmission",
        description = "Upgrade gears",
        modType = 13,
        icon = "cog"
    },
    {
        id = "suspension",
        name = "Suspension",
        description = "Improve handling",
        modType = 15,
        icon = "arrows-alt-v"
    },
    {
        id = "turbo",
        name = "Turbo",
        description = "Add turbocharger",
        modType = 18,
        icon = "fan",
        isToggle = true
    },
}
```

### Visual Modifications

```lua
{
    id = "spoiler",
    name = "Spoiler",
    description = "Add spoiler",
    modType = 0,
    icon = "wind"
},
{
    id = "front_bumper",
    name = "Front Bumper",
    description = "Change front bumper",
    modType = 1,
    icon = "car-crash"
},
{
    id = "rear_bumper",
    name = "Rear Bumper",
    description = "Change rear bumper",
    modType = 2,
    icon = "car-burst"
},
{
    id = "sideskirt",
    name = "Side Skirts",
    description = "Add side skirts",
    modType = 3,
    icon = "car-side"
},
{
    id = "exhaust",
    name = "Exhaust",
    description = "Change exhaust",
    modType = 4,
    icon = "smog"
},
{
    id = "grille",
    name = "Grille",
    description = "Change grille",
    modType = 6,
    icon = "border-all"
},
{
    id = "hood",
    name = "Hood",
    description = "Change hood",
    modType = 7,
    icon = "car"
},
{
    id = "roof",
    name = "Roof",
    description = "Change roof",
    modType = 10,
    icon = "home"
},
```

### Wheels

```lua
{
    id = "wheels",
    name = "Wheels",
    description = "Change wheels",
    modType = 23,
    icon = "circle",
    isWheels = true,
    wheelTypes = {
        {id = 0, name = "Sports"},
        {id = 1, name = "Muscle"},
        {id = 2, name = "Lowrider"},
        {id = 3, name = "SUV"},
        {id = 4, name = "Offroad"},
        {id = 5, name = "Tuner"},
        {id = 6, name = "Bike"},
        {id = 7, name = "High End"},
        {id = 8, name = "Benny's Original"},
        {id = 9, name = "Benny's Bespoke"},
        {id = 10, name = "Open Wheel"},
        {id = 11, name = "Street"},
        {id = 12, name = "Track"},
    }
},
```

### Colors

```lua
{
    id = "colors",
    name = "Colors",
    description = "Change vehicle colors",
    icon = "palette",
    isColors = true
},
{
    id = "window_tint",
    name = "Window Tint",
    description = "Change window tint",
    modType = -1,
    icon = "tint",
    isWindowTint = true,
    options = {
        {id = 0, name = "None"},
        {id = 1, name = "Pure Black"},
        {id = 2, name = "Dark Smoke"},
        {id = 3, name = "Light Smoke"},
        {id = 4, name = "Stock"},
        {id = 5, name = "Limo"},
        {id = 6, name = "Green"},
    }
},
```

### Neon and Lights

```lua
{
    id = "neon",
    name = "Neon",
    description = "Add neon lights",
    icon = "lightbulb",
    isNeon = true
},
{
    id = "xenon",
    name = "Xenon Headlights",
    description = "Add xenon headlights",
    modType = 22,
    icon = "sun",
    isToggle = true
},
{
    id = "xenon_color",
    name = "Xenon Color",
    description = "Change xenon color",
    icon = "palette",
    isXenonColor = true,
    options = {
        {id = 0, name = "Default"},
        {id = 1, name = "White"},
        {id = 2, name = "Blue"},
        {id = 3, name = "Electric Blue"},
        {id = 4, name = "Mint Green"},
        {id = 5, name = "Lime Green"},
        {id = 6, name = "Yellow"},
        {id = 7, name = "Golden Shower"},
        {id = 8, name = "Orange"},
        {id = 9, name = "Red"},
        {id = 10, name = "Pony Pink"},
        {id = 11, name = "Hot Pink"},
        {id = 12, name = "Purple"},
        {id = 13, name = "Blacklight"},
    }
},
```

***

## Category Options Reference

| Option       | Type    | Required | Description                     |
| ------------ | ------- | -------- | ------------------------------- |
| id           | string  | Yes      | Unique identifier               |
| name         | string  | Yes      | Display name                    |
| description  | string  | Yes      | Description text                |
| modType      | number  | Depends  | GTA V mod type index            |
| icon         | string  | Yes      | Icon name                       |
| isToggle     | boolean | No       | Toggle on/off instead of levels |
| isWheels     | boolean | No       | Use wheel system                |
| isColors     | boolean | No       | Use color picker                |
| isWindowTint | boolean | No       | Use window tint system          |
| isNeon       | boolean | No       | Use neon system                 |
| isXenonColor | boolean | No       | Use xenon color picker          |
| wheelTypes   | array   | No       | Available wheel types           |
| options      | array   | No       | Predefined options list         |

***

## GTA V Mod Types Reference

| Mod Type | Description      |
| -------- | ---------------- |
| 0        | Spoiler          |
| 1        | Front Bumper     |
| 2        | Rear Bumper      |
| 3        | Side Skirts      |
| 4        | Exhaust          |
| 5        | Frame            |
| 6        | Grille           |
| 7        | Hood             |
| 8        | Fender           |
| 9        | Right Fender     |
| 10       | Roof             |
| 11       | Engine           |
| 12       | Brakes           |
| 13       | Transmission     |
| 14       | Horns            |
| 15       | Suspension       |
| 16       | Armor            |
| 18       | Turbo            |
| 22       | Xenon Headlights |
| 23       | Front Wheels     |
| 24       | Back Wheels      |
| 25-49    | Various          |

***

## Color Palette

The script includes a full color palette with all GTA V vehicle colors organized by category:

* Metallic Colors
* Matte Colors
* Metal Colors
* Chrome
* Chameleon Colors

Each color has:

* id: GTA V color index
* name: Display name
* hex: Preview color code