Koja Scripts
FREE

Test Drive

Buyers can take a listed vehicle for a spin before committing to a purchase.

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

shared/config.lua
Config.TestDrive = {
    Enabled = true,
    coords = vec3(-1015.0851, -3328.7476, 13.9444),
    heading = 59.8811,
    secondslimit = 20,
    price = 0,
    cancelKey = 73,
}
FieldDefaultPurpose
EnabledtrueMaster toggle for the feature
coordsvec3(...)World position where the test vehicle spawns
heading59.88Spawn heading
secondslimit20Duration in seconds (test ends automatically)
price0Bank fee charged when the test starts
cancelKey73 (X)Key code to cancel early

Cancel key reference

CodeKey
73X
47G
38E

Any FiveM control ID works. See the FiveM controls reference.

Per-zone overrides

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

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

Config.TestDrive = { Enabled = false }

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

  • 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 — Players can buy individual market slots within zones, pay weekly rent, and park their listed vehicles there.
  • Overview — All tunable settings live in shared/config.lua.
  • Exchange — The exchange is the player-or-server-owned tier above zones.
  • Configuration — back to the section overview