---
description: Check the instructions below.
---

# Configuration

The primary configuration file is `config.lua`. Below is a breakdown of the settings.

***

#### General Settings

| Setting            | Description                                                  | Default Value                                       |
| ------------------ | ------------------------------------------------------------ | --------------------------------------------------- |
| `Locales`          | Language for the script (`EN`, `FR`, `PT`, `TR`).            | `"EN"`                                              |
| `SQLScript`        | Database library (`oxmysql`, `ghmattimysql`, `mysql-async`). | `"oxmysql"`                                         |
| `EditPlate`        | Allow players to edit license plates.                        | `true`                                              |
| `OfflineSelling`   | Allow offline vehicle sales.                                 | `true`                                              |
| `EditPlateCost`    | Cost for editing license plates.                             | `5000`                                              |
| `BuyType`          | Currency type for transactions (`bank`, `cash`).             | `"bank"`                                            |
| `TestDriveTime`    | Duration for test drives (in seconds).                       | `60`                                                |
| `TestDriveVector4` | Spawn location for test drives.                              | `vector4(-1007.3341, -3015.9114, 13.3133, 61.0055)` |
| `Collisions`       | Enable/disable vehicle collisions.                           | `true`                                              |

***

#### Parking Lots

Define the available parking lots for vehicle showcases. Each parking lot has a name and a list of coordinates.

```lua
Config.ParkingLot = {
    ["Franklin's"] = {
        [1] = vector4(221.4148, -806.7344, 30.0414, 247.9251),
        [2] = vector4(222.4204, -804.3123, 30.0363, 246.9260),
        ...
    },
    ["Winston's"] = {
        [1] = vector4(-1716.6907, -898.9792, 7.0463, 139.1251)
    },
}
```

***

#### Job Restrictions

If specific jobs are required to manage parking lots or vehicles, define them in the `Config.Jobs` table.

```lua
Config.Jobs = {
    ["Franklin's"] = "police"
}
```

***

#### Interaction Settings

Choose the interaction method players will use to access features:

| Interaction Type | Description                 | Default |
| ---------------- | --------------------------- | ------- |
| `textui`         | Text-based UI interactions. | `false` |
| `drawtext`       | On-screen text interaction. | `true`  |
| `target`         | Target-based interaction.   | `false` |

***

#### Notifications

Customizable notifications for various events.

| Function              | Description                     |
| --------------------- | ------------------------------- |
| `Config.Notification` | Sends notifications to players. |
| `Config.Hud`          | Toggles HUD visibility.         |

Example usage for server-side notifications:

```lua
Config.Notification("Vehicle purchased successfully!", true, source)
```

***

#### Test Drive and Purchase Functions

| Function             | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| `Config.TestVehicle` | Grants temporary ownership of a test vehicle during a test drive. |
| `Config.BuyVehicle`  | Handles the purchase of a vehicle, transferring ownership.        |

***

#### Advanced Features

**Editable License Plates**

* Enable/Disable via `Config.EditPlate`.
* Define the cost using `Config.EditPlateCost`.

**Offline Vehicle Selling**

* Enable/Disable via `Config.OfflineSelling`.

**Vehicle Collisions**

* Enable/Disable via `Config.Collisions`.

***
