# Test Drive

Buyers can take a listed vehicle for a spin **before** committing to a purchase. The vehicle spawns at a fixed safe spot with a configurable time limit; canceling early teleports the player back to where they were.

***

## Settings

```lua title="shared/config.lua"
Config.TestDrive = {
    Enabled = true,
    coords = vec3(-1015.0851, -3328.7476, 13.9444),
    heading = 59.8811,
    secondslimit = 20,
    price = 0,
    cancelKey = 73,
}
```


| Field          | Default     | Purpose                                       |
| -------------- | ----------- | --------------------------------------------- |
| `Enabled`      | `true`      | Master toggle for the feature                 |
| `coords`       | `vec3(...)` | World position where the test vehicle spawns  |
| `heading`      | `59.88`     | Spawn heading                                 |
| `secondslimit` | `20`        | Duration in seconds (test ends automatically) |
| `price`        | `0`         | Bank fee charged when the test starts         |
| `cancelKey`    | `73` (X)    | Key code to cancel early                      |

***

## Cancel key reference

| Code | Key |
| ---- | --- |
| `73` | X   |
| `47` | G   |
| `38` | E   |

Any FiveM control ID works. See the [FiveM controls reference](https://docs.fivem.net/docs/game-references/controls/).

***

## Per-zone overrides

Add a `testDrive` table to any zone in `Config.Zones` to override the defaults for that zone:

```lua title="shared/config.lua"
{
    id = "zone3",
    -- ... other zone fields ...
    testDrive = {
        coords = vec3(1180.0, 2640.0, 37.8),
        heading = 90.0,
        secondslimit = 30,
        price = 500,
        cancelKey = 47,
    },
},
```


Any field omitted from the override falls back to the global `Config.TestDrive`.

***

## Disabling test drives

```lua
Config.TestDrive = { Enabled = false }
```

The "Test drive" button is hidden from the tablet UI and any direct calls return a `disabled` error.

:::hint{type="warning"}
Test drives are **not** available for auctions that have ended. The server checks this before spawning.
:::

## Related pages

- [Custom Vehicle Images](/free/carmarket/configuration/custom-vehicle-images) — By default the tablet UI fetches vehicle images from https://docs.fivem.net/vehicles/.webp — that covers every stock GTA V vehicle, but not modded cars on your server.
- [Parking](/free/carmarket/configuration/parking) — Players can buy individual market slots within zones, pay weekly rent, and park their listed vehicles there.
- [Overview](/free/carmarket/configuration/overview) — All tunable settings live in shared/config.lua.
- [Exchange](/free/carmarket/configuration/exchange) — The exchange is the player-or-server-owned tier above zones.
- [Configuration](/free/carmarket/configuration) — back to the section overview