# Configuration

### Overview

This part outlines the configuration options available for the **Custom Transmission System** and **Anti-Fail Drive Mechanism**. You can use this config file to customize gear shifting behavior, traction control, and various other gameplay aspects related to vehicle handling.

***

### Gear Transmission Configuration

#### `Config.togglable`

* **Type:** `boolean`
* **Default:** `true`
* **Description:** Enables or disables the ability to toggle the transmission system on or off.

#### `Config.toggleTransmission`

* **Type:** `string`
* **Default:** `"transmission"`
* **Description:** Command or keyword used to toggle the transmission system.

#### `Config.notifications`

```lua
Config.notifications = {
    started = "Custom transmission system engaged. Switching to advanced driving mode.",
    stopped = "Custom transmission system disengaged. Returning to default mode."
}
```

* **Description:** Messages displayed when the transmission system is toggled on or off.

***

#### Key Bindings - `Config.Keys`

```lua
Config.Keys = {
    Clutch      = 61, -- Shift key
    MoveUp      = 172,
    MoveDown    = 173,
    MoveLeft    = 174,
    MoveRight   = 175,
    LeftSignal  = 108,
    RightSignal = 109,
    HazardSignal = 110
}
```

* **Clutch:** Key code for activating the clutch.
* **MoveUp/Down/Left/Right:** Key codes for simulating a gear shifter.
* **Signals:** Key codes for vehicle lights and hazard signals.

***

#### Transmission Override - `Config.transmission`

```lua
Config.transmission = {
    italiGTB = "automatic",
    sultan   = "manual",
    elegy    = "manual",
    t20      = "manual"
}
```

* **Description:** Forces a specific transmission type (`manual` or `automatic`) for certain vehicle models. Vehicles not listed here will use the auto-detection system.

***

#### UI Colors

```lua
Config.color1 = "rgb(0, 225, 255)"     -- Cyan
Config.color2 = "rgb(255, 0, 255)"     -- Magenta
Config.color3 = "rgb(255, 255, 255)"   -- White
Config.color4 = "rgb(34, 34, 34)"      -- Dark Gray
```

* **Description:** UI accent colors used by the custom transmission system.

***

### Anti-Fail Drive Configuration

#### `Config.EnableTerrainTraction`

* **Type:** `boolean`
* **Default:** `false`
* **Description:** Enables adjustments in vehicle traction based on terrain type.

***

#### `Config.TireConfig`

Defines on-road and off-road multipliers for each tire type by ID:

```lua
Config.TireConfig = {
    [0] = { Name = "Sport", OnRoad = { Enabled = true, Multiplier = 1.0 }, OffRoad = { Enabled = true, Multiplier = 0.35 } },
    ...
}
```

* **OnRoad / OffRoad:**
  * `Enabled`: Whether the multiplier is active.
  * `Multiplier`: Grip level on the respective terrain.

***

#### Bike Configuration - `Config.BikeConfig`

```lua
Config.BikeConfig = {
    Dirt = {
        OnRoad  = { Enabled = true,  Multiplier = 0.9 },
        OffRoad = { Enabled = false, Multiplier = 1.0 }
    },
    Street = {
        OnRoad  = { Enabled = true,  Multiplier = 1.0 },
        OffRoad = { Enabled = true,  Multiplier = 0.5 }
    }
}
```

* **Description:** Modifies grip levels for dirt and street bikes based on terrain.

***

#### `Config.DefaultOnRoadMultiplier`

* **Type:** `number`
* **Default:** `1.0`
* **Description:** Fallback grip multiplier for vehicles on-road when specific tire type is not configured.

#### `Config.DefaultOffRoadMultiplier`

* **Type:** `number`
* **Default:** `1.0`
* **Description:** Fallback grip multiplier for vehicles off-road.

***

#### Anti-Stunt Feature

```lua
Config.EnableAntiStunt = false
```

* **Description:** If `true`, this setting disables unrealistic stunt behaviors (e.g., excessive jumping or flipping).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://enyo-scripts.gitbook.io/documentations/fivem-scripts/real-driving-system/configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.