> For the complete documentation index, see [llms.txt](https://adriansr.gitbook.io/battleroyale/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adriansr.gitbook.io/battleroyale/battlefield-setup/vehicle-configuration.md).

# Vehicle Configuration

The vehicle configuration system works in a similar way to the arena system. Each .yml inside the folder "**plugins/BattleRoyale/vehicle**" is a different configuration. This way each battlefield can have a different vehicle configuration; but also different battlefields can use the same vehicle configuration. Note that if you don't specify which vehicle configuration a particular battlefield will use, a random vehicle configuration from the loot configurations folder will be used.

Each section in a vehicle configuration represents a vehicle with a certain spawning chance. Of course a **vehicles plugin is required to enable vehicles.**

***

### How to setup a vehicle section

Simply create a new section, then specify some values:

* **chance**: Chance/probability of spawning. A value between **0** or **100** is **recommended**, however you can enter a number even **greater than 100**.
* **vehicle-name**: The vehicle to spawn. This value refers to a vehicle in a vehicles plugin.
* **fuel**:
  * **enable**: Whether or not to enable/disable the fuel system. Note that there might be vehicle plugins that **don't support the fuel system**.
  * **initial-fuel**: The fuel the vehicle will spawn with.

***

Here is an example vehicle configuration:

```yaml
newsvan:
  chance: 55.0
  vehicle-name: newsvan
  fuel:
    enable: false
    initial-fuel: 0
jeep:
  chance: 20.0
  vehicle-name: jeep
  fuel:
    enable: false
    initial-fuel: 0
t50:
  chance: 10.0
  vehicle-name: t50
  fuel:
    enable: false
    initial-fuel: 0
cadillac62:
  chance: 69.0
  vehicle-name: cadillac62
  fuel:
    enable: false
    initial-fuel: 0
```

(**vehicles shown in this configuration are QualityArmoryVehicle vehicles**)

<br>