# 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 %}

***

## <mark style="color:orange;">Vehicle Settings</mark>

```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'`                         | <p>This is the unique name of the given chosen vehicle.<br>You can choose to make these upper or lower case.m</p>                                                                                                                                                         |
| `seatMaterial`, `wheelsUrl`, `backMaterial`   | <p>Set the desired material or material urls here.<br>More info on re-texturing vehicles can be found <a href="#re-texture-vehicles"><mark style="color:orange;">here</mark></a>.</p>                                                                                     |
| `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 [<mark style="color:orange;">here</mark>](https://docs.vehiclesplugin.com/commands-and-permissions/use-permissions#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 [<mark style="color:orange;">this</mark>](https://docs.vehiclesplugin.com/general-settings#vehicle-health). |

***

## <mark style="color:orange;">Adding more Vehicles</mark>

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 [<mark style="color:orange;">here</mark>](https://docs.vehiclesplugin.com/shop-settings#add-vehicles-to-the-shop).&#x20;

```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
```

***

## <mark style="color:orange;">Re-texture Vehicles</mark>

### 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.

<details>

<summary><mark style="color:orange;">New System | Custom Skin</mark></summary>

#### Step 1:

Customize your skin (We suggest [<mark style="color:orange;">PlanetMinecraft</mark>](https://www.planetminecraft.com/pmcskin3d/) (*"File" > "Save To File" to export*)).\
\
\&#xNAN;*<mark style="color:orange;">Caution!</mark>* Certain "Hat" textures may overlap with items on vehicles, hiding them behind the texture!<br>

#### Step 2:

Equip it as usual (If you don't know where, click on the link below).<br>

### Step 3:

Head on over to [<mark style="color:orange;">https://www.minecraft.net/en-us/msaprofile/mygames/editskin</mark> ](https://www.minecraft.net/en-us/msaprofile/mygames/editskin)and navigate to the following area:

<img src="https://2046797179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUu9U3NNRucR8zsXfSW%2Fuploads%2FBsNCRl0VkodyXmoF1omM%2Fimage.png?alt=media&#x26;token=8bd31c4b-e522-4490-abbd-b883f9ec2f29" alt="Current Skin Section - Minecraft.net" data-size="original">

### 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.

</details>

<details>

<summary><mark style="color:orange;">New System | Minecraft Heads</mark></summary>

#### Step 1:

Navigate to [<mark style="color:orange;">https://minecraft-heads.com/</mark>](https://minecraft-heads.com/) and select a Skull/Skin you want to use.<br>

#### 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.

</details>