# Configuration

## Vehicle Shop Configuration

***

### <mark style="color:green;">Framework Selection</mark>

```lua
Config.Framework = "auto" -- Options: "auto", "esx", "qb"
```

Determines which framework will be used. When set to `auto`, it will automatically detect `esx` or `qb-core`.

***

### <mark style="color:green;">Localization</mark>

```lua
Config.Language = "en" -- Available: "en", "de", "fr", "es", "pt"
```

Sets the default language for UI and notifications.

***

### <mark style="color:green;">General Settings</mark>

```lua
Config.maxSpeed = 200 -- Speed limit in test drives (0 to disable limit)
Config.Target = false -- Enable or disable target interaction system
Config.testDriveTime = 60 -- Duration of test drives in seconds
Config.Debug = false -- Enable for debug logging in console
```

***

### <mark style="color:green;">Driving License Requirement</mark>

```lua
Config.DrivingLicense = {
    active = true,
    license = "driver"
}
```

When `active` is true, players must have a license of the specified type to purchase vehicles.

***

### <mark style="color:green;">Custom License Plate</mark>

```lua
Config.Plate = {
    customPlate = true,
    price = 500,
    onlyNumbers = false,
    length = {
        min = 5,
        max = 8,
    }
}
```

Allows players to set a custom license plate during purchase.

***

### <mark style="color:green;">Available Colors</mark>

```lua
Config.Colors = {
    {r = 216, g = 217, b = 215},
    {r = 253, g = 142, b = 39},
    ...
}
```

These are the colors available for selection in the vehicle shop.

***

### <mark style="color:green;">Vehicle Shop Locations</mark>

```lua
Config.VehicleShops = {
    {
        type = "car", -- car, boat, helicopter, plane, police, ambulance
        coord = vec4(...),
        style = "npc", -- or "marker"
        npc = "a_m_y_business_01",
        marker = {...},
        spawn = {
            show = vec4(...),
            testDrive = vec4(...),
            delivery = vec4(...)
        },
        camera = {
            camCoord = vector3(...),
            camRotation = vector3(...)
        },
        blip = {
            active = true,
            label = "Vehicle Shop",
            sprite = 523,
            color = 3,
            scale = 0.7
        },
        job = {
            active = false,
            name = "police" -- Only for job-specific shops
        }
    },
    ...
}
```

You can configure multiple shop types (e.g., police, boats, ambulances).

***

### <mark style="color:green;">Vehicle Categories and Models</mark>

```lua
Config.Categories = {
    car = {
        {
            id = "sports",
            label = "Sports",
            vehicles = {
                {name = "pariah", price = 1420000},
                ...
            }
        },
        ...
    },
    police = {
        {
            id = "police",
            label = "Police",
            vehicles = {
                {name = "police", price = 50000, min_grade = 1},
                ...
            }
        }
    }
    ...
}
```

You can restrict specific vehicles by job grade using `min_grade`.

***

> 💡 **Tip:** You can also change the UI theme and color scheme directly in `config.css`. Avoid modifying `opacity` settings to preserve visual clarity.

> 🛒 **Note:** You can find this script on our Tebex store: [STG Tebex](https://stg.tebex.io/)