> For the complete documentation index, see [llms.txt](https://crimvex-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crimvex-studio.gitbook.io/docs/scripts/crimvex-rental/rental-locations/adding-rental-vehicles.md).

# Adding Rental Vehicles

The `vehicles` table inside each rental location determines which vehicles players can rent.

Each rental location can have its own unique vehicle list, allowing you to offer different vehicles in different areas of the map.

Example:

```lua
vehicles = {
    {
        displayName = "Asbo",
        model = "asbo",
        money = 150,
        img = "asbo.webp",
        seats = 2,
        category = "car",
        vip = false
    }
}
```

***

## Vehicle Structure

Every rental vehicle contains the following properties.

| Property      | Description                         |
| ------------- | ----------------------------------- |
| `displayName` | Vehicle name shown in the UI        |
| `model`       | GTA vehicle spawn name              |
| `money`       | Rental price                        |
| `img`         | Vehicle image shown in the UI       |
| `seats`       | Number of seats displayed           |
| `category`    | Vehicle category                    |
| `vip`         | Restrict the vehicle to VIP players |

***

## Display Name

```lua
displayName = "Blista"
```

The friendly name shown inside the rental menu.

Example:

```
Blista
Police Cruiser
Sultan RS
```

***

## Vehicle Model

```lua
model = "blista"
```

The GTA V spawn name of the vehicle.

Examples:

```lua
model = "blista"
model = "sultan"
model = "bati"
model = "baller"
```

> The model name must exist on your server.

***

## Rental Price

```lua
money = 250
```

The amount a player must pay to rent the vehicle.

Example:

```lua
money = 150
money = 500
money = 1500
```

***

## Vehicle Image

```lua
img = "blista.webp"
```

This image is displayed inside the rental UI.

### Image Location

All vehicle images must be placed inside:

```
web/images/
```

Example:

```
web/
└── images/
    ├── asbo.webp
    ├── blista.webp
    ├── astron.webp
    ├── sultan.webp
    └── bati.webp
```

The filename must exactly match the value used in the configuration.

Example:

```lua
img = "sultan.webp"
```

Required file:

```
web/images/sultan.webp
```

> **Supported format:** `.webp`

***

## Seats

```lua
seats = 4
```

Displays the number of available seats in the rental menu.

Example:

```lua
seats = 2
seats = 4
seats = 6
```

***

## Category

```lua
category = "car"
```

Used to organize vehicles inside the UI.

### Supported Categories

```lua
category = "car"
category = "bike"
```

> Future updates may introduce additional categories.

***

## VIP Vehicles

```lua
vip = true
```

Restricts the vehicle to VIP players only.

| Value   | Description                             |
| ------- | --------------------------------------- |
| `true`  | Only VIP players can rent this vehicle. |
| `false` | Available for everyone.                 |

VIP permissions are configured separately inside the Discord integration.

***

## Example Vehicle

```lua
{
    displayName = "Sultan RS",
    model = "sultan",
    money = 1200,
    img = "sultan.webp",
    seats = 4,
    category = "car",
    vip = false
}
```

***

## Adding Multiple Vehicles

Add more entries inside the `vehicles` table.

```lua
vehicles = {

    {
        displayName = "Blista",
        model = "blista",
        money = 250,
        img = "blista.webp",
        seats = 4,
        category = "car",
        vip = false
    },

    {
        displayName = "Sanchez",
        model = "sanchez",
        money = 500,
        img = "sanchez.webp",
        seats = 2,
        category = "bike",
        vip = false
    },

    {
        displayName = "Windsor Drop",
        model = "windsor2",
        money = 1500,
        img = "windsor2.webp",
        seats = 4,
        category = "car",
        vip = true
    }

}
```

***

## Tips

✅ Use high-quality vehicle images.

✅ Keep image filenames lowercase.

✅ Make sure the image exists inside `web/images`.

✅ Verify the GTA vehicle model name before adding it.

✅ Set realistic rental prices for your server economy.

***

## Common Mistakes

#### Vehicle image is missing

* Verify the image exists inside `web/images`.
* Check that the filename exactly matches the `img` value.
* Ensure the image is in `.webp` format.

***

#### Vehicle won't spawn

* Verify the vehicle model name is correct.
* Make sure the vehicle is streamed on your server.

***

#### VIP vehicle is available for everyone

Check:

```lua
vip = true
```

and make sure your Discord VIP configuration has been set up correctly.

***

## Next Step

Continue to **⭐ VIP Vehicles** to learn how to configure Discord roles and restrict premium vehicles to specific players.