# Vehicles
{% hint style="danger" %}
Do not reload the plugin or the server to put these changes into effect. Restart the server.
{% endhint %}
{% hint style="info" %}
A small snippet of the config has been selected for this page. Config settings may vary between vehicles, yet should be self explanatory if you have read through this page.
{% endhint %}
{% hint style="info" %}
**Custom 3D-Model configuration can be found on the 3D-Models page!**
{% endhint %}
***
## Vehicle Settings
```yaml
bikes:
'BLACK':
seatMaterial: 'BLACK_TERRACOTTA'
wheelsUrl: 'http://textures.minecraft.net/texture/444cd5d2fd2fe397ddb927e184f19ecbd0fe24af6ef68852c172ae447cd4'
backMaterial: 'SPRUCE_SLAB'
maxSpeed: 1.2
acelerationValue: 0.006
displayName: '&7Black Bike'
permission: 'Bikes.type.BLACK'
maxHealth: 40
fuelCapacity: 1000
fuelWasteSpeed: 1.2
'ORANGE':
seatMaterial: 'ORANGE_TERRACOTTA'
wheelsUrl: 'http://textures.minecraft.net/texture/444cd5d2fd2fe397ddb927e184f19ecbd0fe24af6ef68852c172ae447cd4'
backMaterial: 'CUT_RED_SANDSTONE_SLAB'
maxSpeed: 1.4
acelerationValue: 0.006
displayName: '&6Orange Bike'
permission: 'Bikes.type.ORANGE'
maxHealth: 40
fuelCapacity: 1200
fuelWasteSpeed: 1.1
```
*\* This example is using the first two vehicles from the bikes section.*
| Setting | Info |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `'BLACK'`, `'ORANGE'` | This is the unique name of the given chosen vehicle.
You can choose to make these upper or lower case.m
|
| `seatMaterial`, `wheelsUrl`, `backMaterial` | Set the desired material or material urls here.
More info on re-texturing vehicles can be found here.
|
| `maxSpeed`, `acelerationValue` | Set the maximum speed and how fast the vehicle accelerates. |
| `displayName` | This is the name you will see on the chests when holding them. Has to be a unique name. |
| `permission` | The permission for players to use and buy the vehicle. For more info on "Use-Permissions" click [here](/commands-and-permissions/use-permissions.md#usage-permissions). |
| `maxHealth`, `fuelCapactiy`, `fuelWasteSpeed` | Sets the value of the maximum vehicle health and fuel amount. You can also set how fast each vehicle loses fuel. To disable health for all vehicles check out [this](/configuration/general-settings.md#vehicle-health). |
***
## Adding more Vehicles
If you want to add more vehicles, simply copy/paste the settings (see below) from one vehicle and edit those. Keep in mind that every type has to be a unique name.\
\
To learn how to add the new vehicles to the shop click [here](/configuration/shop-settings.md#add-vehicles-to-the-shop).
```yaml
'BLACK':
seatMaterial: 'BLACK_TERRACOTTA'
wheelsUrl: 'http://textures.minecraft.net/texture/444cd5d2fd2fe397ddb927e184f19ecbd0fe24af6ef68852c172ae447cd4'
backMaterial: 'SPRUCE_SLAB'
maxSpeed: 1.2
acelerationValue: 0.006
displayName: '&7Black Bike'
permission: 'Bikes.type.BLACK'
maxHealth: 40
fuelCapacity: 1000
fuelWasteSpeed: 1.2
'NEW UNIQUE VEHICLE NAME':
seatMaterial: 'MATERIAL'
wheelsUrl: 'http://textures.minecraft.net/texture/444cd5d2fd2fe397ddb927e184f19ecbd0fe24af6ef68852c172ae447cd4'
backMaterial: 'MATERIAL'
maxSpeed: 1.4
acelerationValue: 0.006
displayName: 'NAME'
permission: 'PERMISSION'
maxHealth: 40
fuelCapacity: 1200
fuelWasteSpeed: 1.1
```
***
## Re-texture Vehicles
### Old System
```yaml
mainMaterial: 'GREEN_TERRACOTTA'
```
Most Vehicles use the old system. Simple blocks/items can be used to re-color your vehicles.
### New System
```yaml
mainMaterialUrl: 'http://textures.minecraft.net/texture/fca5bff325ed71d97a2ddfc83acf05fe7fd9cb7cbdb15ebb4f05621907e9f2b'
```
On the newer/newest Vehicles the materials are skin textures. That means you can upload your own custom skins as use them as a vehicle color.\
\
Below you will find two ways on how to add your own textures to Vehicles.
New System | Custom Skin
#### Step 1:
Customize your skin (We suggest [PlanetMinecraft](https://www.planetminecraft.com/pmcskin3d/) (*"File" > "Save To File" to export*)).\
\
\&#xNAN;*Caution!* Certain "Hat" textures may overlap with items on vehicles, hiding them behind the texture!
#### Step 2:
Equip it as usual (If you don't know where, click on the link below).
### Step 3:
Head on over to [https://www.minecraft.net/en-us/msaprofile/mygames/editskin ](https://www.minecraft.net/en-us/msaprofile/mygames/editskin)and navigate to the following area:
### Step 3:
`Right-Click` the image and choose `Copy image address`. You now have the skin texture and can change the `mainMaterialUrl:` in the config.
New System | Minecraft Heads
#### Step 1:
Navigate to [https://minecraft-heads.com/](https://minecraft-heads.com/) and select a Skull/Skin you want to use.
#### Step 2:
After selecting, scroll down to the bottom of the page to find the `Minecraft-URL`.\
\
Simply copy that URL and add the texture to the `mainMaterialUrl:` in the config.
---
# 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://docs.vehiclesplugin.com/configuration/vehicle-settings.md?ask=
```
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.