# Vehicles

Welcome to the official Vehicles plugin wiki! Here you will find quite a bit of information, which might even resolve your issue or answer your questions!

![Version 14.9](/files/CUPyUFlBzaYqeRu0LMxR)

***

## <mark style="color:orange;">FAQ - Frequently Asked Questions</mark>

The most asked questions can be found here!&#x20;

{% content-ref url="/pages/-MZDxM64w\_uUEt5nABsT" %}
[FAQ](/introduction/faq)
{% endcontent-ref %}

***

## <mark style="color:orange;">Commands & Permissions</mark>

All commands & permissions are listed here. Per vehicle ("Use Permissions") permissions are explained here.

{% content-ref url="/pages/-MUuBVi27sboc3z5z6bD" %}
[Commands](/commands-and-permissions/commands-and-permissions)
{% endcontent-ref %}

{% content-ref url="/pages/-MZECMyOsYxDd2lDK\_Sl" %}
[Other Permissions](/commands-and-permissions/permissions)
{% endcontent-ref %}

{% content-ref url="/pages/-MZEKDCq1-z3NBIjyUFO" %}
["Use" Permissions](/commands-and-permissions/use-permissions)
{% endcontent-ref %}

***

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

Need help setting up the plugin? Don't worry, here are some explanations to each setting!

{% content-ref url="/pages/-MbqasLyO\_fKB4q1R3RU" %}
[Vehicles](/configuration/vehicle-settings)
{% endcontent-ref %}

{% content-ref url="/pages/-MbqbJ8TyLZ453ZFiTHn" %}
[Shop](/configuration/shop-settings)
{% endcontent-ref %}

{% content-ref url="/pages/-Mbqb3HqjcdRt7pQFOGb" %}
[Fuel](/configuration/fuel-settings)
{% endcontent-ref %}

{% content-ref url="/pages/-MbqbBorELRThVmbA-O-" %}
[General Settings](/configuration/general-settings)
{% endcontent-ref %}

{% content-ref url="/pages/EA2UXtdrbReyjQBKW1zf" %}
[3D-Models](/configuration/3d-models)
{% endcontent-ref %}

***

## <mark style="color:orange;">Plugin Files</mark>

All default files and short explanations to each can be found here. Also make sure to check out the <mark style="color:orange;">configuration</mark> page for more info.

{% content-ref url="/pages/-MUuBiQ2Ed3KHFKDrSJl" %}
[Plugin Files](/plugin-files/plugin-files)
{% endcontent-ref %}

***

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

Find a list of all addons for the Vehicles plugin here. This includes all official and community addons.

{% content-ref url="/pages/-MahycstoY5KCudjjnVD" %}
[Official Addons](/addons/official-addons)
{% endcontent-ref %}

{% content-ref url="/pages/-MahyfXWJmFV8mO-l9ve" %}
[Community Addons](/addons/community-addons)
{% endcontent-ref %}

***

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

A small documentation about our API can be found here!

{% content-ref url="/pages/3ADRZhoIWmJWQBpgxmfR" %}
[API](/api-guide/api)
{% endcontent-ref %}


# FAQ

## <mark style="color:orange;">How do I drive this/that vehicle?</mark>

**Basic driving:** 'W / A / S / D'\
**Jumping / Flying the helicopter & broom / Jetpack / Honking: '**&#x53;PACE'\
**Change direction of the train:** Hold 'S'\
**Flying the plane:** Look up / down to gain / lose altitude\
**Dismount:** 'SHIFT'\
\
**Opening the trunk:** 'RIGHT CLICK' - *while riding the vehicle*\
**Refueling the vehicle:** 'SHIFT + LEFT-CLICK'\
**Picking up the vehicle:** 'SHIFT + RIGHT-CLICK'\
\
**Dropping bombs from the plane:** 'RIGHT-CLICK' with tnt in hand - *while flying* ([<mark style="color:orange;">permission</mark>](/commands-and-permissions/use-permissions#firing-missiles-and-bombs))\
**Firing missiles from a tank / helicopter:** 'RIGHT-CLICK' with fire charge in hand - *while riding* ([<mark style="color:orange;">permission</mark>](/commands-and-permissions/use-permissions#fire-missile-charges))\
**Shooting with the Mecha:** 'RIGHT CLICK'\
**Grappling / Hooking with the Mecha:** 'LEFT-CLICK'\
\
**Enter Submarine View:** 'RIGHT-CLICK' - *while riding*\
**Exit Submarine View:** 'SPACE'

*Keybinds may differ if you have customized your settings. The shown keybinds use the default minecraft settings.*

***

## <mark style="color:orange;">My players can't place, buy, or drive vehicles!</mark>

Players need permissions to buy and drive each vehicle. We call it the **"**&#x55;se-Permissions" which can be found [<mark style="color:orange;">here</mark>](/commands-and-permissions/use-permissions). In addition to this, make sure that you have added the [<mark style="color:orange;">allowed worlds</mark>](https://vehicles.gitbook.io/wiki/configuration/general-settings#allowing-worlds) to the config, or given the [<mark style="color:orange;">world override permission</mark>](/commands-and-permissions/permissions#override-world-permissions) to the player.

***

## <mark style="color:orange;">What does not work with Vehicles?</mark>

* Certain clients, such as Optifine and Lunar Client, especially in 1.16.5 have had issues with armorstands. We suggest updating these to the latest versions. Sometimes the cached rendering can cause issues with the skin rendering.<br>
* Are you using Bedrock / Geyser? We only support Spigot based servers, due to the large differences of both versions in terms of armorstands and skins.<br>
* If you are using any armor-stand limiter plugins or similar, increase the amount or remove the plugin to not have missing parts anymore.<br>
* Armorstand editors - as the name might already suggest, plugins or datapacks which edit armorstands don't work in harmony. From malformed vehicles, to skulls you can take off of vehicles - We have seen it all.<br>
* Have a resource pack enabled? Try disabling that, as some mess with the looks of armorstands.<br>
* ItemsAdder and Oraxen both use Gestures/Emotes which allow players to pose. This breaks certain skin textures for the newer Vehicles. Disable these features to fix that issue.<br>
* Using Entity Stackers? We have discovered that certain stackers try to stack our vehicles, especially when pushed by pistons, and could drop loads of items in response - or just look terrible.<br>
* Using the "Anti-Xray" feature from Paper? Try disabling that, as we have encountered issues with it.<br>
* Certain /sit plugins might be the issue. We currently only know of GSit to not have any issues with Vehicles. Other plugins delete the most important armorstand when you dismount.<br>
* Teleport Horse / Mount: Plugins which teleport your horse or mount with you, as soon as you teleport, will most likely teleport the armorstand you are sitting on with you.<br>
* McMMo seems to dislike all the armorstands. When using abilities, it fires events on all armorstands. Vehicles then takes all damage events and triggers the code respectively. This results in quite a bit of lag for the entire server. We suggest disabling the vehicle health.<br>
* Bad hardware is a huge topic too. Don't expect the vehicles to not "bungee" or lag when your server does not have sufficient RAM, CPU power, and in general be overloaded already.<br>
* Using Paper? You can disable the armorstand tick feature in your `config/paper-world-defaults`. This will increase the performance of vehicles.

```yaml
entities:
  armor-stands:
    do-collision-entity-lookups: true
    tick: false
```

***

## <mark style="color:orange;">Do I need a resourcepack for this plugin?</mark>

You'd be surprised, but no! You don't need a resource pack to see the vehicles<mark style="color:yellow;">**.**</mark> Also, some resourcepacks might change the looks of armorstands and destroy the vehicles.

***

## <mark style="color:orange;">Are custom/my own vehicles supported?</mark>

No, but also yes!\
\
As of Vehicles 14.2 you can use your own resourcepack models for the Vehicles! All default models still remain with their features, if you don't intend on changing them.\
\
You can not add more vehicle types with the API or configs.\
\
For more information regarding 3D-Models, check out [<mark style="color:orange;">this page</mark>](/configuration/3d-models).\
All vehicles' colors/materials can be changed. Here is a bit more info on [<mark style="color:orange;">how to color Vehicles</mark>](/configuration/vehicle-settings#re-texture-vehicles).

***

## <mark style="color:orange;">What vehicles are available?</mark>

In total there are 16 vehicles. These are:

| Bikes       | Cars        |
| ----------- | ----------- |
| Trains      | Rafts       |
| Planes      | Parachutes  |
| Tanks       | Helicopters |
| Submarines  | Brooms      |
| Hoverbikes  | Drills      |
| Racing Cars | Sport Bikes |
| Tractors    | Mechas      |

***

## <mark style="color:orange;">Can I craft the vehicles?</mark>

No, we don't have any features which allow this. You can use custom crafting plugins to achieve this, or use other ways such as custom GUIs to accomplish this.

***

## <mark style="color:orange;">My vehicle has taken damage! Help!</mark>

Use `/repairvehicle` ([<mark style="color:orange;">permission</mark>](/commands-and-permissions/commands-and-permissions#other-commands)) to fix your vehicle again. If you disable Health, make sure to also disable `blockBreakDamage` for Drills, as they take damage when mining.

***

## <mark style="color:orange;">What versions are supported?</mark>

We only support Minecraft Java 1.15+. That means we currently support 1.15 -> 1.21.8\
\
Please also keep in mind that we only support Spigot or Spigot forks *(Paper, Purpur, Tuinity, etc...)*. Bedrock or mobile users will NOT see the vehicles.

***

## <mark style="color:orange;">Are there any dependencies?</mark>

Yes, a permissions plugin (eg: [<mark style="color:orange;">LuckPerms</mark>](https://luckperms.net/download)\*) is required to give players permission to for example drive/buy vehicles.\
\
In addition to this, to use / enable shop, you need [<mark style="color:orange;">Vault</mark>](https://www.spigotmc.org/resources/vault.34315/)**\*\*** and a Vault compatible economy plugin. Plugins like EssentialsX have a built in economy. Some Plugins like CLI require a special version to hook into Vault.\
\
\* *LuckPerms is not affiliated with Vehicles, the developer or any of our plugins. For questions regarding this plugin, please contact their support.*\
*\*\* Vault is not affiliated with Vehicles, the developer or any of our plugins.*

***

## <mark style="color:orange;">Do I need to take precautions?</mark>

Yes! Vehicles checks for malware and tampering with the plugin jar. If you have malware on your server, Vehicles will disable and will not work. This happens so that we can protect your stored data and our plugin. Trust us, some things just don't belong on your server!\
\
More questions about this, or need help to fix this? Join our discord!

***

## <mark style="color:orange;">Can I try the plugin before buying it?</mark>

Yes, that is possible on the test servers (*see below*). Please keep in mind, that some servers are public and not owned by Vehicles.

* <mark style="color:orange;">**Server One:**</mark>

  **IP:**`Try.VehiclesPlugin.com` *(<mark style="color:red;">currently not available</mark>)*\
  **Version:** 1.19.2\
  **Language:** English


# Commands

{% hint style="info" %}
Some tables have 2 pages, like the one below. Click through both pages to see the different permissions!
{% endhint %}

{% hint style="warning" %}
We can help you understand these permissions better on our discord, but we can't explain how a permissions plugin (eg: LuckPerms) works. For that, please watch a tutorial or read the wiki for your permissions plugin.
{% endhint %}

***

## <mark style="color:orange;">Shop Commands</mark>

{% tabs %}
{% tab title="Shop Commands | Open" %}

### **Open Shop Commands**

| Command                                                                                                                                                                                                                                                                                                                                                                                                                                     | Permission                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Description                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| <p>/bikeShop</p><p><strong>/carShop</strong></p><p>/trainShop</p><p><strong>/raftShop</strong><br>/planeShop</p><p><strong>/parachuteShop</strong></p><p>/tankShop</p><p><strong>/helicopterShop</strong></p><p>/submarineShop</p><p><strong>/broomShop</strong></p><p>/hoverBikeShop</p><p><strong>/drillShop</strong></p><p>/racingCarShop</p><p><strong>/sportBikeShop</strong></p><p>/tractorShop</p><p><strong>/mechaShop</strong></p> | <p>Bikes.openShop</p><p><strong>Cars.openShop</strong></p><p>Trains.openShop</p><p><strong>Rafts.openShop</strong></p><p>Planes.openShop</p><p><strong>Parachutes.openShop</strong></p><p>Tanks.openShop</p><p><strong>Helicopters.openShop</strong></p><p>Submarines.openShop</p><p><strong>Brooms.openShop</strong></p><p>HoverBikes.openShop</p><p><strong>Drills.openShop</strong><br>RacingCars.openShop</p><p><strong>SportBikes.openShop</strong></p><p>Tractors.openShop</p><p><strong>Mechas.openShop</strong></p> | Opens the shop GUI of that Vehicle. |
| {% endtab %}                                                                                                                                                                                                                                                                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                                     |

{% tab title="Shop Commands | Open Other" %}

### Open Player's Shop Commands

<table data-header-hidden><thead><tr><th width="270">Command</th><th width="270.66666666666663">Permission</th><th>Description</th></tr></thead><tbody><tr><td>Command</td><td>Permission</td><td>Description</td></tr><tr><td><p>/bikeShop &#x3C;player></p><p><strong>/carShop &#x3C;player></strong></p><p>/trainShop &#x3C;player></p><p><strong>/raftShop &#x3C;player></strong><br>/planeShop &#x3C;player></p><p><strong>/parachuteShop &#x3C;player></strong></p><p>/tankShop &#x3C;player></p><p><strong>/helicopterShop &#x3C;player></strong></p><p>/submarineShop &#x3C;player></p><p><strong>/broomShop &#x3C;player></strong></p><p>/hoverBikeShop &#x3C;player></p><p><strong>/drillShop &#x3C;player></strong></p><p>/racingCarShop &#x3C;player></p><p><strong>/sportBikeShop &#x3C;player></strong></p><p>/tractorShop &#x3C;player></p><p><strong>/mechaShop &#x3C;player></strong></p></td><td><p>Bikes.openShopOthers</p><p><strong>Cars.openShopOthers</strong></p><p>Trains.openShopOthers</p><p><strong>Rafts.openShopOthers</strong></p><p>Planes.openShopOthers</p><p><strong>Parachutes.openShopOthers</strong></p><p>Tanks.openShopOthers</p><p><strong>Helicopters.openShopOthers</strong></p><p>Submarines.openShopOthers</p><p><strong>Brooms.openShopOthers</strong></p><p>HoverBikes.openShopOthers</p><p><strong>Drills.openShopOthers</strong><br>RacingCars.openShopOthers</p><p><strong>SportBikes.openShopOthers</strong></p><p>Tractors.openShopOthers</p><p><strong>Mechas.openShopOthers</strong></p></td><td><p>Opens the shop GUI of that</p><p>Vehicle for another player.</p></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

***

## <mark style="color:orange;">Give/Get Vehicle Commands</mark>

{% tabs %}
{% tab title="Vehicle Commands | Give" %}

### Give Vehicle Commands

<table data-header-hidden><thead><tr><th width="324.3333333333333">Command</th><th width="255.53474459272897">Permission</th><th>Description</th></tr></thead><tbody><tr><td>Command</td><td>Permission</td><td>Description</td></tr><tr><td><p>/giveBike &#x3C;player> &#x3C;type></p><p><strong>/giveCar &#x3C;player> &#x3C;type></strong></p><p>/giveTrain &#x3C;player> &#x3C;type></p><p><strong>/giveRaft &#x3C;player> &#x3C;type></strong><br>/givePlane &#x3C;player> &#x3C;type></p><p><strong>/giveParachute &#x3C;player> &#x3C;type></strong></p><p>/giveTank &#x3C;player> &#x3C;type></p><p><strong>/giveHelicopter &#x3C;player> &#x3C;type></strong></p><p>/giveSubmarine &#x3C;player> &#x3C;type></p><p><strong>/giveBroom &#x3C;player> &#x3C;type></strong></p><p>/giveHoverBike &#x3C;player> &#x3C;type></p><p><strong>/giveDrill &#x3C;player> &#x3C;type></strong></p><p>/giveRacingCar &#x3C;player> &#x3C;type></p><p><strong>/giveSportBike &#x3C;player> &#x3C;type></strong></p><p>/giveTractor &#x3C;player> &#x3C;type></p><p><strong>/giveMecha &#x3C;player> &#x3C;type></strong></p></td><td><p>Bikes.giveBike</p><p><strong>Cars.giveCar</strong></p><p>Trains.giveTrain</p><p><strong>Rafts.giveRaft</strong></p><p>Planes.givePlane</p><p><strong>Parachutes.giveParachute</strong></p><p>Tanks.giveTank</p><p><strong>Helicopters.giveHelicopter</strong></p><p>Submarines.giveSubmarine</p><p><strong>Brooms.giveBroon</strong></p><p>HoverBikes.giveHoverBike</p><p><strong>Drills.giveDrill</strong><br>RacingCars.giveRacingCar</p><p><strong>SportBikes.giveSportBike</strong></p><p>Tractors.giveTractor</p><p><strong>Mechas.giveMecha</strong></p></td><td><p>Gives another player</p><p>a certain Vehicle.</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Vehicle Commands | Get" %}

### Get Vehicle Commands

<table data-header-hidden><thead><tr><th width="250">Command</th><th width="278.66666666666663">Permission</th><th>Description</th></tr></thead><tbody><tr><td>Command</td><td>Permission</td><td>Description</td></tr><tr><td><p>/getBike &#x3C;type></p><p><strong>/getCar &#x3C;type></strong></p><p>/getTrain &#x3C;type></p><p><strong>/getRaft &#x3C;type></strong><br>/getPlane &#x3C;type></p><p><strong>/getParachute &#x3C;type></strong></p><p>/getTank &#x3C;type></p><p><strong>/getHelicopter &#x3C;type></strong></p><p>/giveSubmarine &#x3C;type></p><p><strong>/getBroom &#x3C;type></strong></p><p>/giveHoverBike &#x3C;type></p><p><strong>/getDrill &#x3C;type></strong></p><p>/getRacingCar &#x3C;type></p><p><strong>/getSportBike &#x3C;type></strong></p><p>/getTractor &#x3C;type></p><p><strong>/getMecha &#x3C;type></strong></p></td><td><p>Bikes.getBike</p><p><strong>Cars.getCar</strong></p><p>Trains.getTrain</p><p><strong>Rafts.getRaft</strong></p><p>Planes.getPlane</p><p><strong>Parachutes.getParachute</strong></p><p>Tanks.getTank</p><p><strong>Helicopters.getHelicopter</strong></p><p>Submarines.getSubmarine</p><p><strong>Brooms.getBroon</strong></p><p>HoverBikes.getHoverBike</p><p><strong>Drills.getDrill</strong><br>RacingCars.getRacingCar</p><p><strong>SportBikes.getSportBike</strong></p><p>Tractors.getTractor</p><p><strong>Mechas.getMecha</strong></p></td><td>Give yourself a Vehicle.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

***

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

| Command                                                                                                                                                                                                                                                                                                                                                                                                                                     | Permission                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Description                                                      |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| <p>/bikeList</p><p><strong>/carList</strong></p><p>/trainList</p><p><strong>/raftList</strong><br>/planeList</p><p><strong>/parachuteList</strong></p><p>/tankList</p><p><strong>/helicopterList</strong></p><p>/submarineList</p><p><strong>/broomList</strong></p><p>/hoverBikeList</p><p><strong>/drillList</strong></p><p>/racingCarList</p><p><strong>/sportBikeList</strong></p><p>/tractorList</p><p><strong>/mechaList</strong></p> | <p>Bikes.bikeList</p><p><strong>Cars.carList</strong></p><p>Trains.trainList</p><p><strong>Rafts.raftList</strong></p><p>Planes.planeList</p><p><strong>Parachutes.parachuteList</strong></p><p>Tanks.tankList</p><p><strong>Helicopters.helicopterList</strong></p><p>Submarines.submarineList</p><p><strong>Brooms.broomList</strong></p><p>HoverBikes.hoverBikeList</p><p><strong>Drills.drillList</strong><br>RacingCars.racingCarList</p><p><strong>SportBikes.sportBikeList</strong></p><p>Tractors.tractorList</p><p><strong>Mechas.mechaList</strong></p> | <p>Sends a list of all available<br>Vehicle types into chat.</p> |

***

## <mark style="color:orange;">Other Commands</mark>

<table data-header-hidden><thead><tr><th width="294.3333333333333">Command</th><th width="232.45847335573694">Permission</th><th>Description</th></tr></thead><tbody><tr><td>Command</td><td>Permission</td><td>Description</td></tr><tr><td>/vehicleClear &#x3C;radius> &#x3C;true></td><td><p>Vehicles.clear</p><p>Vehicles.removeOthers</p></td><td><p>Clear vehicles in a given radius.</p><p>Add the <code>&#x3C;true></code> flag to clear other</p><p>players' vehicles as well.</p></td></tr><tr><td>/repairVehicle</td><td>Vehicles.repair</td><td>Repairs a vehicle when riding it.</td></tr><tr><td>/vehiclesReload</td><td>Vehicles.reload</td><td><p><strong>CAUTION</strong>: We do <strong>NOT</strong> recommend using</p><p>this feature. Instead of reloading the plugin,</p><p>please restart the server.</p></td></tr></tbody></table>


# Other Permissions

{% hint style="info" %}
Some tables have 2 pages, like the one below. Click through both pages to see the different permissions!
{% endhint %}

{% hint style="warning" %}
We can help you understand these permissions better on our discord, but we can't explain how a permissions plugin (eg: LuckPerms) works. For that, please watch a tutorial or read the wiki for your permissions plugin.
{% endhint %}

***

## <mark style="color:orange;">Override Owner Permissions</mark>

{% tabs %}
{% tab title="Override Owner | Remove Permissions" %}

### Override Owner | Remove Permissions

| Permission                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Description                                                              |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| <p>Bikes.overrideOwner</p><p><strong>Cars.overrideOwner</strong></p><p>Trains.overrideOwner</p><p><strong>Rafts.overrideOwner</strong></p><p>Planes.overrideOwner</p><p><strong>Parachutes.overrideOwner</strong></p><p>Tanks.overrideOwner</p><p><strong>Helicopters.overrideOwner</strong></p><p>Submarines.overrideOwner</p><p><strong>Brooms.overrideOwner</strong></p><p>HoverBikes.overrideOwner</p><p><strong>Drills.overrideOwner</strong></p><p>RacingCars.overrideOwner</p><p><strong>SportBikes.overrideOwner</strong></p><p>Tractors.overrideOwner</p><p><strong>Mechas.overrideOwner</strong></p> | <p>Lets another user pick up </p><p>vehicles which aren't their own.</p> |
| {% endtab %}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                                                                          |

{% tab title="Override Owner | Ride Permissions" %}

### Override Owner | Ride Permissions

| Permission                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Description                                                          |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| <p>Bikes.overrideOwner.ride</p><p><strong>Cars.overrideOwner.ride</strong></p><p>Trains.overrideOwner.ride</p><p><strong>Rafts.overrideOwner.ride</strong></p><p>Planes.overrideOwner.ride</p><p><strong>Parachutes.overrideOwner.ride</strong></p><p>Tanks.overrideOwner.ride</p><p><strong>Helicopters.overrideOwner.ride</strong></p><p>Submarines.overrideOwner.ride</p><p><strong>Brooms.overrideOwner.ride</strong></p><p>HoverBikes.overrideOwner.ride</p><p><strong>Drills.overrideOwner.ride</strong></p><p>RacingCars.overrideOwner.ride</p><p><strong>SportBikes.overrideOwner.ride</strong></p><p>Tractors.overrideOwner.ride</p><p><strong>Mechas.overrideOwner.ride</strong></p> | <p>Lets another user ride vehicles</p><p>which aren't their own.</p> |
| {% endtab %}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                                                                      |
| {% endtabs %}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                                                                      |

***

## <mark style="color:orange;">Override World Permissions</mark>

| Permission                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Description                                                                                                                                                                                 |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Bikes.overrideWorld</p><p><strong>Cars.overrideWorld</strong></p><p>Trains.overrideWorld</p><p><strong>Rafts.overrideWorld</strong></p><p>Planes.overrideWorld</p><p><strong>Parachutes.overrideWorld</strong></p><p>Tanks.overrideWorld</p><p><strong>Helicopters.overrideWorld</strong></p><p>Submarines.overrideWorld</p><p><strong>Brooms.overrideWorld</strong></p><p>HoverBikes.overrideWorld</p><p><strong>Drills.overrideWorld</strong></p><p>RacingCars.overrideWorld</p><p><strong>SportBikes.overrideWorld</strong></p><p>Tractors.overrideWorld</p><p><strong>Mechas.overrideWorld</strong></p> | <p>Lets users use vehicles in disabled worlds.<br></p><p>See <a href="/pages/-MbqbBorELRThVmbA-O-#allowing-worlds"><mark style="color:orange;">other settings</mark></a> for more info.</p> |

***

## <mark style="color:orange;">Override Remove Permissions</mark>

| Permission                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Description                                                                                                                                                                                                                                           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Bikes.overrideRemoveOnDismount</p><p><strong>Cars.overrideRemoveOnDismount</strong></p><p>Trains.overrideRemoveOnDismount</p><p><strong>Rafts.overrideRemoveOnDismount</strong></p><p>Planes.overrideRemoveOnDismount</p><p><strong>Parachutes.overrideRemoveOnDismount</strong></p><p>Tanks.overrideRemoveOnDismount</p><p><strong>Helicopters.overrideRemoveOnDismount</strong></p><p>Submarines.overrideRemoveOnDismount</p><p><strong>Brooms.overrideRemoveOnDismount</strong></p><p>HoverBikes.overrideRemoveOnDismount</p><p><strong>Drills.overrideRemoveOnDismount</strong></p><p>RacingCars.overrideRemoveOnDismount</p><p><strong>SportBikes.overrideRemoveOnDismount</strong></p><p>Tractors.overrideRemoveOnDismount</p><p><strong>Mechas.overrideRemoveOnDismount</strong></p> | <p>If enabled, this permission will not despawn the vehicle on dismount, if the config option has been set.<br></p><p>See <a href="/pages/-MbqbBorELRThVmbA-O-#remove-on-dismount"><mark style="color:orange;">configuration</mark></a> for more.</p> |


# "Use" Permissions

{% hint style="info" %}
Please make sure to read everything on this page! Permissions for shooting missiles or dropping bombs are on this page too!
{% endhint %}

{% hint style="warning" %}
We can help you understand these permissions better on our discord, but we can't explain how a permissions plugin (eg: LuckPerms) works. For that, please watch a tutorial or read the wiki for your permissions plugin.
{% endhint %}

***

## <mark style="color:orange;">Usage Permissions</mark>

Every vehicle type has its own permission node. These permissions are needed so players can buy and ride each vehicle. By default these permissions are: `<Vehicles>.type.<type>`. You can find a list of all default permissions below:&#x20;

| <p><mark style="color:orange;"><strong>Group Permission</strong></mark><br>This permission includes all on the right. That means, if you want to allow all types from one category, you simply need to add this column.</p> | <p><mark style="color:orange;"><strong>Type Permissions</strong></mark><br>These permissions are for each individual subtype. Use these if you want to only allow the use of a single type/color.</p> |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Bikes.type.*`                                                                                                                                                                                                              | <p><code>Bikes.type.BLACK</code></p><p><code>Bikes.type.ORANGE</code></p><p><code>Bikes.type.RED</code></p>                                                                                           |
| `Cars.type.*`                                                                                                                                                                                                               | <p><code>Cars.type.BLACK</code></p><p><code>Cars.type.YELLOW</code></p><p><code>Cars.type.MAGENTA</code></p>                                                                                          |
| `Trains.type.*`                                                                                                                                                                                                             | <p><code>Trains.type.T1</code></p><p><code>Trains.type.T2</code></p><p><code>Trains.type.T3</code></p>                                                                                                |
| `Rafts.type.*`                                                                                                                                                                                                              | <p><code>Rafts.type.OLD</code></p><p><code>Rafts.type.NETHER</code></p><p><code>Rafts.type.PIRATE</code></p>                                                                                          |
| `Planes.type.*`                                                                                                                                                                                                             | <p><code>Planes.type.P1</code></p><p><code>Planes.type.P2</code></p><p><code>Planes.type.P3</code></p>                                                                                                |
| `Parachutes.type.*`                                                                                                                                                                                                         | <p><code>Parachutes.type.PC1</code></p><p><code>Parachutes.type.PC2</code></p><p><code>Parachutes.type.PC3</code></p>                                                                                 |
| `Tanks.type.*`                                                                                                                                                                                                              | <p><code>Tanks.type.T1</code></p><p><code>Tanks.type.T2</code></p><p><code>Tanks.type.T3</code></p>                                                                                                   |
| `Helicopters.type.*`                                                                                                                                                                                                        | <p><code>Helicopters.type.H1</code></p><p><code>Helicopters.type.H2</code></p><p><code>Helicopters.type.H3</code></p>                                                                                 |
| `Submarines.type.*`                                                                                                                                                                                                         | <p><code>Submarines.type.S1</code></p><p><code>Submarines.type.S2</code></p><p><code>Submarines.type.S3</code></p>                                                                                    |
| `Brooms.type.*`                                                                                                                                                                                                             | <p><code>Brooms.type.B1</code></p><p><code>Brooms.type.B2</code></p><p><code>Brooms.type.B3</code></p>                                                                                                |
| `HoverBikes.type.*`                                                                                                                                                                                                         | <p><code>Hoverbikes.type.HB1</code></p><p><code>Hoverbikes.type.HB2</code></p><p><code>Hoverbikes.type.HB3</code></p>                                                                                 |
| `Drills.type.*`                                                                                                                                                                                                             | <p><code>Drills.type.D1</code></p><p><code>Drills.type.D2</code></p><p><code>Drills.type.D3</code></p>                                                                                                |
| `RacingCars.type.*`                                                                                                                                                                                                         | <p><code>RacingCars.type.YELLOW</code></p><p><code>RacingCars.type.PURPLE</code></p><p><code>RacingCars.type.RED</code></p>                                                                           |
| `SportBikes.type.*`                                                                                                                                                                                                         | <p><code>SportBikes.type.SB1</code></p><p><code>SportBikes.type.SB2</code></p><p><code>SportBikes.type.SB3</code></p>                                                                                 |
| `Tractors.type.*`                                                                                                                                                                                                           | <p><code>Tractors.type.YELLOW</code></p><p><code>Tractors.type.RED</code></p><p><code>Tractors.type.GREEN</code></p>                                                                                  |
| `Mechas.type.*`                                                                                                                                                                                                             | <p><code>Mechas.type.MKI</code></p><p><code>Mechas.type.MKII</code></p><p><code>Mechas.type.MKV</code></p>                                                                                            |

***

## <mark style="color:orange;">Firing missiles and bombs</mark>

| Permission               | Description                                                      |
| ------------------------ | ---------------------------------------------------------------- |
| `Tank.fireMissile`       | <p>Lets the player shoot fire</p><p>charges from their tank.</p> |
| `Helicopter.fireMissile` | <p>Lets the player drop tnt</p><p>from their helicopter.</p>     |
| `Planes.throwBombs`      | <p>Lets the player drop tnt</p><p>from their plane.</p>          |

{% hint style="info" %}
Mechas do not need additional permissions to shoot/hook.
{% endhint %}

***

## <mark style="color:orange;">Editing "Use Permissions"</mark>

{% hint style="danger" %}
Ignore this if you don't want to edit any of the permissions, or if you are a beginner with permissions! This will only confuse you!
{% endhint %}

You are able to edit these permissions in the `config.yml`, if you want to. If you don't want to edit them, you do not need to change anything in the config! To find out where you can change them, please check out the [<mark style="color:orange;">vehicle settings</mark>](/configuration/vehicle-settings#vehicle-settings).


# 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="/pages/-MbqasLyO_fKB4q1R3RU#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>](/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>](/configuration/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>](/configuration/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*)).\
\
*<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="/files/hk6KvycdlR0QNDDvzaH7" 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>


# Shop

{% hint style="danger" %}
Do not reload the plugin or the server to put these changes into effect. Restart the server.
{% endhint %}

***

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

```yaml
bike-shopsize: 9
bike-shoptitle: '&6Bike Shop'
bike-shopslots:
 '1':
  bikeType: 'BLACK'
  price: 30
  itemMaterial: 'CHEST'
  itemDisplayName: '&7Black Bike'
  itemLore:
   - '&7A standard black bike'
   - '&6Price: &730'
 '4':
  bikeType: 'ORANGE'
  price: 60
  itemMaterial: 'CHEST'
  itemDisplayName: '&6Orange Bike'
  itemLore:
   - '&7A standard orange bike'
   - '&6Price: &760'
```

*\* This example is using the first two vehicles from the bike shop section.*

| Setting                                       | Info                                                                                                                                                                                                                                                                      |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `bike-shopsize`                               | Limits the size of each Vehicle shop. The maximum size is 54.                                                                                                                                                                                                             |
| `bike-shoptitle`                              | Sets the title of the shop, which can be seen at the top of the gui.                                                                                                                                                                                                      |
| `'1'`, `'4'`                                  | These are the slots the chest/vehicle will appear in. For more info on what number belongs to which slot click [<mark style="color:orange;">here</mark>](https://proxy.spigotmc.org/286cf93278ca679cecf2a40528fd830418b75d4a?url=http%3A%2F%2Fi.imgur.com%2FgK9plGo.png): |
| `bikeType`                                    | The type of bike which will be given to the user. This has to be the exact name to the one you've set in the [<mark style="color:orange;">vehicle settings</mark>](/configuration/vehicle-settings).                                                                      |
| `price`                                       | Set the price users need to pay. The price has to be a whole number (no , or .) and the highest possible price is 2147483647.                                                                                                                                             |
| `itemMaterial`, `itemDisplayName`, `itemLore` | Set the item which should be displayed in the slot, including its name and lore. Note: When you change the price, you will also need to change it in the lore.                                                                                                            |

***

## <mark style="color:orange;">Add Vehicles to the Shop</mark>

To add more vehicles to the shop, simply copy/paste a shop slot (see below) and edit it to fit to the vehicle you want to add. Make sure that the type is the exact same as the one in the vehicle settings.

```yaml
 '1':
  bikeType: 'BLACK'
  price: 30
  itemMaterial: 'CHEST'
  itemDisplayName: '&7Black Bike'
  itemLore:
   - '&7A standard black bike'
   - '&6Price: &730'
 'NEW SHOP SLOT NUMBER HERE':
  bikeType: 'NAME FROM THE VEHICLE YOU ADDED'
  price: 60
  itemMaterial: 'CHEST'
  itemDisplayName: 'NAME HERE'
  itemLore:
   - 'LORE'
   - 'LORE'
```


# Fuel

{% hint style="danger" %}
Do not reload the plugin or the server to put these changes into effect. Restart the server.
{% endhint %}

***

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

The default fuel items can be found in the `config.yml`. Some examples are: Wood items, coal, wool items, lava buckets, wheat, etc...&#x20;

To refuel your vehicle open the fuel gui ([<mark style="color:orange;">controls</mark>](/introduction/faq#how-do-i-drive-this-that-vehicle)), and drag the items onto the fuel bucket.

***

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

{% code title="" %}

```yaml
fuelEnabled: true
fuelBarEnabled: true
#1: Text, 2: Icon
fuelBarType: 2
iconFuelBarSize: 30
```

{% endcode %}

| Setting           | Info                                                               |
| ----------------- | ------------------------------------------------------------------ |
| `fuelEnabled`     | Enable or disable the fuel entirely                                |
| `fuelBarEnabled`  | Enable or disable the fuel bar icon/text in your action bar.       |
| `fuelBarType`     | Choose between text or bars (icon) to indicate the remaining fuel. |
| `iconFuelBarSize` | For the icon fuel bar, select how many bars are displayed.         |

***

## <mark style="color:orange;">Adding Fuel Items</mark>

{% code title="" %}

```yaml
fuelMaterialValues:
 'OAK_LOG':
  material: 'OAK_LOG'
  fuel-amount: 4
```

{% endcode %}

| Setting       | Info                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------ |
| `'OAK_LOG'`   | Set a unique name for the fuel.                                                                              |
| `material`    | Select the material/block/item which shall be used to refuel. It must be a valid vanilla Minecraft Material. |
| `fuel-amount` | Set the amount each item should refuel the vehicle for.                                                      |

{% hint style="info" %}
You can add as many or as few items as you'd like to.
{% endhint %}

***

## <mark style="color:orange;">Custom Fuel Item</mark>

{% code title="" %}

```yaml
 'CUSTOM_ITEM_1':
  material: 'PLAYER_HEAD'
  displayName: '&eFuel Can'
  lore:
   - '&7Used to refill vehicles fuel.'
  fuel-amount: 20
  displayNameRequired: true
  loreRequired: true
```

{% endcode %}

| Setting                               | Info                                                                                                                              |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `'CUSTOM_ITEM_1'`                     | Set a unique name for the fuel.                                                                                                   |
| `material`                            | Select the material/block/item which shall be used to refuel.                                                                     |
| `displayName`                         | Set a display name for your item.                                                                                                 |
| `lore`                                | Set an optional lore for your fuel item.                                                                                          |
| `fuel-amount`                         | Set the amount each item should refuel the vehicle for.                                                                           |
| `displayNameRequired`, `loreRequired` | Enable or disable the option for the lore or displayname to be required. If enabled, the item needs to have that exact name/lore. |

### <mark style="color:orange;">Custom Skull Fuel with HDB</mark>

If you are using [*<mark style="color:orange;">HeadDataBase</mark>*](https://www.spigotmc.org/resources/head-database.14280/)*\** and would like to use the same fuel can as in the refuel gui, here is a small tutorial: (This works with every other head too.)

**Step 1:** Setup the fuel in the *Vehicles* config.yml like this.

{% code title="" %}

```yaml
 'CUSTOM_ITEM_1':
  material: 'PLAYER_HEAD'
  displayName: '&aFuel Can'
  lore:
   - '&7Used to refill vehicles fuel.'
  fuel-amount: 50
  displayNameRequired: true
  loreRequired: false
```

{% endcode %}

**Step 2:** In your *HeadDataBase* config.yml find `disabled-heads:`. Add the following head to that list. That head is now no longer buyable through the *HeadDataBase* menu.

{% code title="HeadDataBase - config.yml" %}

```yaml
disabled-heads:
  - "ID:812"
```

{% endcode %}

**Step 3:** In your *HeadDataBase* config.yml find `rename-heads:`. Add the following ID and name. (Make sure that the name of the skull in *Vehicles* and *HeadDataBase* are the same! Including color codes!)

{% code title="HeadDataBase - config.yml" %}

```yaml
rename-heads:
  812: "&aFuel Can"
```

{% endcode %}

**Step 4:** Restart your server, and you will now able to give players the fuel can skull with the following command: `/hdb give 812 <amount> <player>` \
\
\
*\* HeadDataBase is not affiliated with Vehicles, the developer or any of our plugins.*


# General Settings

{% hint style="danger" %}
Do not reload the plugin or the server to put these changes into effect. Restart the server.
{% endhint %}

***

## <mark style="color:orange;">Allowing Worlds</mark>

```yaml
allowedWorlds:
 - 'world'
 - 'another_world'
 - 'more_worlds'
```

You need to set the worlds players can use the vehicles in, in your config.yml. For that simply add more lines or overwrite the default value. Players can also receive the [<mark style="color:orange;">override permission</mark>](/commands-and-permissions/permissions#override-world-permissions) to use the vehicles in any world.

***

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

```yaml
vehicleHealthEnabled: true
transferDamageToRider: true
damageTransferMultiplier: 0.8
```

Enable or disable Vehicle health here. In addition to this you can set the damage it transfers to the rider, or disable this function fully.\
\
Drills will still loose damage when mining. To disable this, navigate to `BlockBreakDamage:` in the config.yml.

***

## <mark style="color:orange;">Shulker Storage</mark>

```yaml
allowShulkersInVehicleStorage: false
```

Enable or disable the storage of Shulkers in the trunks.

***

## <mark style="color:orange;">Projectile Removing</mark>

```yaml
removeProjectileOnHit: true
```

Enable or disable the removing of projectiles from Vehicles when hit.

***

## <mark style="color:orange;">Powered Rails & Trains</mark>

```yaml
trainAffectByPoweredRails: true
```

Enable or disable the trains to be influenced by powered rails. This simply allows the train to be able to turn around or not.

***

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

```yaml
keepVehicleMomentum: true
```

| Setting               | Info                                                                                      |
| --------------------- | ----------------------------------------------------------------------------------------- |
| `keepVehicleMomentum` | Enable or disable if the vehicle should continue moving a bit after exiting while riding. |

***

## <mark style="color:orange;">Remove on Death</mark>

```yaml
removeBikeOnRiderDie: false
removeCarOnRiderDie: false
removeTrainOnRiderDie: false
removeRaftOnRiderDie: false
removePlaneOnRiderDie: false
removeParachuteOnRiderDie: false
removeHelicopterOnRiderDie: false
removeTankOnRiderDie: false
removeSubmarineOnRiderDie: false
removeBroomOnRiderDie: false
removeHoverBikeOnRiderDie: false
removeDrillOnRiderDie: false
removeSportBikeOnRiderDie: false
removeRacingCarOnRiderDie: false
removeTractorOnRiderDie: false
```

| Setting                     | Info                                                                  |
| --------------------------- | --------------------------------------------------------------------- |
| `remove<Vehicle>OnRiderDie` | Enable or disable if the vehicle should be removed if the rider dies. |

***

## <mark style="color:orange;">Remove on Dismount</mark>

```yaml
removeBikeOnDismount: false
removeCarOnDismount: false
removeTrainOnDismount: false
removeRaftOnDismount: false
removePlaneOnDismount: false
removeParachuteOnDismount: false
removeHelicopterOnDismount: false
removeTankOnDismount: false
removeSubmarineOnDismount: false
removeBroomOnDismount: false
removeHoverBikeOnDismount: false
removeDrillOnDismount: false
removeSportBikeOnDismount: false
removeRacingCarOnDismount: false
removeTractorOnDismount: false
removeMechaOnDismount: false
```

| Setting                     | Info                                                                                  |
| --------------------------- | ------------------------------------------------------------------------------------- |
| `remove<Vehicle>OnDismount` | Enable or disable if the vehicle should be removed if the rider gets off the vehicle. |

***

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

```yaml
enableBikeStorage: true
enableCarStorage: true
enableTrainStorage: true
enableRaftStorage: true
enablePlaneStorage: true
enableHelicopterStorage: true
enableTankStorage: true
enableHoverBikeStorage: true
enableDrillStorage: true
enableSportBikeStorage: true
enableRacingCarStorage: true
enableTractorStorage: true
```

| Setting                  | Info                                                          |
| ------------------------ | ------------------------------------------------------------- |
| `enable<Vehicle>Storage` | Enable or disable if the vehicle should have a trunk/storage. |

{% hint style="info" %}
Mechas, Brooms, Submarines, and Parachutes do not have a storage.
{% endhint %}

***

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

```yaml
soundsEnabled: true
bikeJumpVolume: 1.0
bikeEngineVolume: 1.0
bikeExplodeVolume: 1.0
broomExplodeVolume: 1.0
carEngineVolume: 1.0
carExplodeVolume: 1.0
carHornVolume: 8.0
helicopterEngineVolume: 2.0
helicopterMissileLaunchVolume: 1.0
helicopterExplodeVolume: 1.0
hoverBikeEngineVolume: 2.0
hoverBikeExplodeVolume: 1.0
parachuteExplodeVolume: 1.0
planeEngineVolume: 2.0
planeBombDropVolume: 1.0
planeExplodeVolume: 1.0
raftExplodeVolume: 1.0
submarineBaseVolume: 2.0
submarineExplodeVolume: 1.0
tankEngineVolume: 2.0
tankMissileLaunchVolume: 1.0
tankExplodeVolume: 1.0
trainBaseVolume: 1.0
trainHornVolume: 7.0
trainExplodeVolume: 1.0
sportBikeJumpVolume: 1.0
sportBikeEngineVolume: 1.0
sportBikeExplodeVolume: 1.0
racingCarEngineVolume: 1.0
racingCarExplodeVolume: 1.0
racingCarHornVolume: 8.0
drillEngineVolume: 2.0
drillBreakVolume: 1.0
drillExplodeVolume: 1.0
tractorEngineVolume: 1.5
tractorExplodeVolume: 1.0
mechaEngineVolume: 1.1
mechaThrustVolume: 1.1
mechaExplodeVolume: 1.0
mechaGunVolume: 1.2
mechaHookVolume: 1.2
mechaBlockGrabVolume: 1.0
```

| Setting                                                                                       | Info                                                                     |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `soundsEnabled`                                                                               | Enable or disable if the vehicles should have sounds.                    |
| `<Vehicle>JumpVolume`                                                                         | Sets the loudness of the vehicle when jumping.                           |
| `<Vehicle>EngineVolume`                                                                       | Sets the general volume when riding the vehicle.                         |
| `<Vehicle>ExplodeVolume`                                                                      | Sets the loudness of the explosion when the vehicle breaks.              |
| <p><code>\<Vehicle>BombDropVolume</code></p><p><code>\<Vehicle>MissileLaunchVolume</code></p> | Sets the volume of the bomb/missile dropping.                            |
| `<Vehicle>BaseVolume`                                                                         | Similar to the engine volume, it sets the general volume of the vehicle. |
| `<Vehicle>GunVolume`                                                                          | Sets the loudness of the laser gun on the Mecha.                         |
| `<Vehicle>HookVolume`                                                                         | Sets the loudness of the hook for the Mecha.                             |
| `<Vehicle>BlockGrabVolume`                                                                    | Sets the volume of the Mecha grappling a block.                          |

***

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

```yaml
particlesEnabled: true
```

| Setting            | Info                                                    |
| ------------------ | ------------------------------------------------------- |
| `particlesEnabled` | Enable or disable if the vehicle should have particles. |


# 3D-Models

{% hint style="danger" %}
Do not reload the plugin or the server to put these changes into effect. Restart the server.
{% endhint %}

{% hint style="info" %}
You do not need to do this, if you want to use the default models. This is a way to add more alternatives with resource packs.
{% endhint %}

***

## <mark style="color:orange;">Enabling Custom 3D-Models</mark>

To enable this feature, you need to disable the following config option. This setting may not be in your config, as it has been added in Vehicles 14.2!

```yaml
nativeModelsEnabled: false
```

This setting will disable all default models, limiting them to one invisible armorstand.

***

## <mark style="color:orange;">Important Notices</mark>

* Using this feature will remove all default models, limiting them to a single invisible armorstand.
* You can add your own models made with resource packs. File uploads and other models are not supported.
* Seat positions remain unchanged, regardless of your added model.
* All features of the default vehicles remain the same. Only the look changes!

***

## <mark style="color:orange;">Adding the ItemStack</mark>

To swap the vehicle for your new model, add the following code to a vehicle config:

```yaml
3dModelItem:
  ==: org.bukkit.inventory.ItemStack
  type: <ITEM>
  v: <VERSION>
  amount: 1
  meta:
    ==: ItemMeta
    meta-type: UNSPECIFIC
    custom-model-data: 1
```

{% hint style="info" %}
Make sure to adjust the `v` (Version) value, to match your data version:\
\
<https://minecraft.wiki/w/Data_version>
{% endhint %}

{% hint style="info" %}
Want to use more ItemMeta? Check out the entire format and settings here:\
\
<https://www.spigotmc.org/wiki/itemstack-serialization/>
{% endhint %}

***

The following is an example setting for the black car. For the default config options, see [<mark style="color:orange;">here</mark>](/configuration/vehicle-settings).

```yaml
cars:
  'BLACK':
  mainMaterial: 'BLACK_TERRACOTTA'
  wheelsUrl: 'http://textures.minecraft.net/texture/444cd5d2fd2fe397ddb927e184f19ecbd0fe24af6ef68852c172ae447cd4'
  frontLightsUrl: 'http://textures.minecraft.net/texture/59e9c9246f1ba5a41e53efa68b2bd56a70da308f393487dcf6fe756799b3c7'
  backLightsUrl: 'http://textures.minecraft.net/texture/4636afc9ecb492722eda37eaab7f5c4acca8974bdc628e4273cbcebd45073ac'
  steelUrl: 'http://textures.minecraft.net/texture/f0d3c96f8c183cf9415c437e4972827656abe7bee36d81d1e9c04466514b9e4'
  maxSpeed: 1
  maxBackSpeed: 0.5
  acelerationValue: 0.006
  displayName: '&7Black Car'
  permission: 'Cars.type.BLACK'
  maxHealth: 40
  fuelCapacity: 1000
  fuelWasteSpeed: 1.2
  3dModelItem:
    ==: org.bukkit.inventory.ItemStack
    type: CARVED_PUMPKIN
    v: 3465
    amount: 1
    meta:
      ==: ItemMeta
      meta-type: UNSPECIFIC
      custom-model-data: 1
```


# Plugin Files

## <mark style="color:orange;">Config.yml</mark>

You can download the `config.yml` by clicking the embed below:

{% file src="/files/dGucGii69Ryf9D5QWSCF" %}
Vehicles 14.8
{% endfile %}

***

## <mark style="color:orange;">Lang.yml</mark>

You can download the `lang.yml` by clicking the embed below:

{% file src="/files/6EmwJwCJEBQ4MMoH5L71" %}
Vehicles 14.8
{% endfile %}


# Official Addons

{% hint style="info" %}
Please keep in mind that these addons are not constantly maintained. Therefore some might be outdated or not working in certain versions anymore.
{% endhint %}

***

## <mark style="color:orange;">WorldGuard Flags Addon</mark>

The WorldGuard Flags Addon, adds a WorldGuard flag for each vehicle (*ALLOW or DENY*) that allows or denies the placing of certain vehicles in a region.\
\
**Author:** Pollitoyeye\
**Link:** <https://www.spigotmc.org/resources/vehicles-worldguard-flags.28788/>

***

## <mark style="color:orange;">PlotSquared Addon</mark>

The PlotSquared Addon, adds different types of protection regarding Vehicles for you to utilize in your Plots world.\
\
**Author:** Pollitoyeye\
**Link:** <https://www.spigotmc.org/resources/vehicles-plotsquared-protection.74753/>

***

## <mark style="color:orange;">Vehicles Limiter Addon</mark>

The Vehicles Limiter Addon, adds a limit to how many Vehicles a user can place.\
\
**Author:** Pollitoyeye\
**Link:** <https://www.mediafire.com/file/53t1oe903btlobo/VehiclesLimiter.jar/file>\
**Dependency:** <https://www.spigotmc.org/resources/bkcommonlib.39590/>


# Community Addons

{% hint style="warning" %}
Please make sure to read the setup instructions, permissions, and commands on each of the addons GitHub page. The Vehicles Team may not be able to help you with any of the following addons.
{% endhint %}

{% hint style="info" %}
Please keep in mind that these addons are not constantly maintained. Therefore some might be outdated or not working in certain versions anymore.
{% endhint %}

{% hint style="info" %}
If you'd like to submit your addon, please open a ticket on our discord!
{% endhint %}

***

## <mark style="color:orange;">Disposable Vehicles Addon</mark>

The Disposable Vehicles Addon adds the feature to delete Vehicles after they are dismounted by the player, making them single-use objects. \
\
**Author:** Nimaari\
**Link:** <https://github.com/Nimaari/DisposableVehiclesAddon>

***

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

The Vehicle Pickup Addon adds the feature to modify whether players can pick up certain vehicles or not.\
\
**Author:** Nimaari\
**Link:** <https://github.com/Nimaari/VehiclesPickupAddon>

***

## <mark style="color:orange;">Speedometer Addon</mark>

The Speedometer Addon adds a blocks per second indicator next to the fuel bar. It allows for custom colors as well!\
\
**Author:** Mtuart\
**Link:** <https://github.com/Mtuart/Speedometer>

***

## <mark style="color:orange;">FindMy Addon</mark>

The FindMy Addon allows you to find your vehicles, or the vehicles of others again!\
\
**Important Notice:** Please read the FAQ on the GitHub Page for more info!\
\
**Author:** Mtuart\
**Link:** <https://github.com/Mtuart/FindMy>

***

## <mark style="color:orange;">Repair Consumable Addon</mark>

The Repair Consumable Addon allows you to set a custom consumable item to repair your vehicle! \
\
**Important Notice:** Please read the "How to use?" section on the GitHub Page for more info!\
\
**Author:** Nimaari\
**Link:** <https://github.com/Nimaari/VehiclesRepairConsumableAddon>

***

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

The Vehicle Crafting Addon adds customizable crafting recipes for vehicles.\
\
**Important Notice:** Please read the wiki on the GitHub Page for more info!\
\
**Author:** srnyx\
**Link:** <https://github.com/srnyx/vehicles-crafting>


# API

{% hint style="info" %}
Please keep in mind that this wiki only shows a limited selection of methods, functions and possibilites.

For further questions regarding the development of addons, methods, or just general questions about what is possible, ask us on our discord server. Do read the entire page here though.
{% endhint %}

***

## <mark style="color:orange;">Using the API</mark>

#### Step 1:

Create a `/libs` folder in your project, and drag and drop the Vehicles jar into the folder.

#### Step 2:

Add the following to your `pom.xml` if you are using Maven:

```xml
<dependency>
  <groupId>Vehicles</groupId>
  <artifactId>Vehicles</artifactId>
  <scope>system</scope>
  <version>1.0</version>
  <systemPath>${pom.basedir}/src/main/java/<path>/<to>/<folder>/libs/Vehicles.jar</systemPath>
</dependency>
```

Depending on how you called your `Vehicles.jar`, you may also need to change that part in the `systemPath`.

#### Step 3:

You can now use the Vehicles API. Don't forget to add Vehicles as a dependency to your `plugin.yml`

{% hint style="warning" %}
The `Vehicle` object is a custom one. It is not the same as the `org.bukkit.entity` Vehicle. Please make sure to import the correct Vehicle:&#x20;

```java
import es.pollitoyeye.vehicles.interfaces.Vehicle;
```

{% endhint %}

***

## <mark style="color:orange;">Limitations of the API</mark>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><mark style="color:orange;"><strong>No custom Vehicles</strong></mark></td><td>As our FAQ already hinted towards, you can't create your own Vehicles with this plugin. Not even using the API.</td><td></td></tr><tr><td><mark style="color:orange;"><strong>No automatic Vehicle movement</strong></mark></td><td>You can't force Vehicles to follow a specific path (eg: like TrainCarts). </td><td></td></tr><tr><td><mark style="color:orange;"><strong>Want something added?</strong></mark></td><td>Tell us on our discord and the developer can see what is possible. Don't ask about new Vehicles though =).</td><td></td></tr><tr><td><mark style="color:orange;"><strong>Movement tracking is resource intensive</strong></mark></td><td>Default MoveEvents from Bukkit and other checks don't work, as only the armorstand moves.<br><br>ProtocolLib offers a VehicleSteerPacket, which can register the movement.</td><td></td></tr></tbody></table>

***

## <mark style="color:orange;">Available Events</mark>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><mark style="color:orange;"><strong>VehicleEnterEvent</strong></mark></td><td>This event gets fired when a player right clicks a Vehicle to mount it. You can not manually fire this event.</td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>VehicleExitEvent</strong></mark></td><td>This event gets fired when a player tries to dismount a Vehicle. You can not manually fire this event.</td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>VehiclePickupEvent</strong></mark></td><td>This event gets fired when a player tries to pick a Vehicle up. You can not manually fire this event.</td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>VehiclePlaceEvent</strong></mark></td><td>This event gets fire when a player tries to place a Vehicle. You can not manually fire this event.</td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>VehicleSpawnedEvent</strong></mark></td><td>This event gets fired AFTER a Vehicle has been spawned and AFTER the VehiclePlaceEvent has been. You can not manually fire this event.</td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>VehicleInventoryOpenEvent</strong></mark></td><td>This event gets fired when a player is trying to open the trunk of a Vehicle. You can not manually fire this event.<br></td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>VehicleCollideEvent</strong></mark></td><td>This event gets fired whenever a Vehicle encounters a block that it can not drive up. You can not manually fire this event.</td><td></td><td></td></tr></tbody></table>

***

## <mark style="color:orange;">General API Methods</mark>

The following code selections are based off of the VehiclesMain instance:

```java
VehiclesMain mainClass = VehiclesMain.getPlugin()
mainClass.<snippet>;
```

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden></th><th data-hidden><select></select></th><th data-hidden data-type="users" data-multiple></th></tr></thead><tbody><tr><td><mark style="color:orange;"><strong>Get current mounted Vehicle from Player</strong></mark></td><td><pre class="language-java"><code class="lang-java">.getPlayerVehicle(player);
</code></pre></td><td></td><td><pre><code>VehiclesMain.getPlugin()
</code></pre></td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>Generate subtype from String</strong></mark></td><td><pre class="language-java"><code class="lang-java">.vehicleSubTypeFromString(VehicleType type, String subtype)
</code></pre></td><td></td><td></td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>Get all current mounted Vehicles as a Hashmap</strong></mark></td><td><pre class="language-java"><code class="lang-java">.playerVehicles;
</code></pre></td><td></td><td></td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>Get other config options:</strong></mark></td><td><pre class="language-java"><code class="lang-java">.&#x3C;Config Option here>;
</code></pre></td><td></td><td></td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>Theres a bit more...</strong></mark></td><td>Ask us on the Discord and we can surely help you find a solution you need!</td><td></td><td></td><td></td><td></td></tr></tbody></table>

***

The following code selections are generalised and should give insight on what info you can get/set from Vehicles.\
\
Please keep in mind, that you call these methods with a Vehicle object.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><mark style="color:orange;"><strong>Get the</strong></mark> <code>mainstand</code> <mark style="color:orange;"><strong>of a Vehicle</strong></mark></td><td><pre class="language-java"><code class="lang-java">Vehicle#getMainstand();
</code></pre></td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>Edit Vehicle stats</strong></mark></td><td><pre class="language-java"><code class="lang-java">Vehicle#setHealth(double);
Vehicle#damage(double);
Vehicle#setFuel(double);
</code></pre></td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>Get current Players on Vehicle</strong></mark></td><td><pre class="language-java"><code class="lang-java">Vehicle#getRidingPlayers();
</code></pre></td><td></td><td></td></tr><tr><td><mark style="color:orange;"><strong>Get Type / Subtype of Vehicle</strong></mark></td><td><pre class="language-java"><code class="lang-java">Vehicle#getType();
</code></pre></td><td></td><td></td></tr></tbody></table>

***

## <mark style="color:orange;">Code Examples</mark>

<details>

<summary><mark style="color:orange;"><strong>Spawn a new Vehicle</strong></mark></summary>

Spawning is done via the VehicleManager. Each Vehicle has its own Manager.

```java
// General VehicleManager
VehicleManager vehicleManager;

// Examples of the "Per Vehicle" Managers
VehicleManager carManager = new CarManager();
VehicleManager tankManager = new TankManager();
VehicleManager planeManager = new PlaneManager();                      

// General method and parameters
vehicleManager.spawn(location, ownerUUID, vehicleSubType);

// Example for spawning a car
carManager.spawn(new Location(Bukkit.getWorld("world"), 0, 0, 0), "5ec4c0de-17ed-4d34-bddf-c703b5ac5737", "BLACK");
```

</details>

<details>

<summary><mark style="color:orange;"><strong>Instant Mount a Player on a Vehicle</strong></mark></summary>

Due to Vehicles having a `20L` delay when all interaction is blocked with it, you need to delay the mounting as well. Mounting only works by firing a `playerInteractAtEntityEvent` manually.

<pre class="language-java"><code class="lang-java">@EventHandler
public void onVehicleSpawn(VehicleSpawnedEvent event) {
    // Grab a random armorstand to fire the event on
    ArmorStand armorStand = event.getVehicleParts().get(0);
    Location location = armorStand.getLocation();

    // Create new Vector from its location
    Vector vector = new Vector(location.getBlockX(), location.getBlockY(), location.getBlockZ());

    // Create PlayerInteractAtEntityEvent
    Player player = Bukkit.getPlayer(UUID.fromString(event.getOwner()));
<strong>    PlayerInteractAtEntityEvent playerInteractAtEntityEvent = new PlayerInteractAtEntityEvent(player, armorStand, vector, EquipmentSlot.HAND);
</strong>    
    // Schedule event to fire after the delay
    Bukkit.getServer().getScheduler().scheduleSyncDelayedTask(Main.getInstance(), new Runnable(){
        @Override
        public void run(){
            Bukkit.getServer().getPluginManager().callEvent(playerInteractAtEntityEvent);
        }
    }, 21L);
}
</code></pre>

</details>


# Terms of Service

The Terms of Service constitute a binding agreement made between you, whether personally, or on behalf of an entitiy ("you") and Pollitoyeye ("Vehicles", "we", "us", or "our"), concering your access to and use of the Vehicles plugin uploaded by Pollitoyeye. You agree that by purchasing and / or downloading the plugin, you have read, understood and agreed to be bound by all these Terms of Service. If you do not agree with all of the following terms of service, you must not purchase or download the given features.

## Conditions of Use and Licenses

We grant you a limited license to access the plugin and all its features. You are not allowed to modify it, or any other part of the plugin itself, without written consent by us.\
\
Unless otherwise indicated, the plugin is our proprietary property and all source code, models, and files are owned or controlled by us or licensed to us. You may not modify, republish, upload, en-/decode, share, sell or distribute any part of the plugin. Please keep in mind that we reserve the right to remove your access and license to Vehicles, if you are distributing and / or modifying the plugin.\
\
We reserve the right to disable all functionalities of the plugin, if it detects that another entity, including, but not limited to, you, and other third-party tools / plugins, is injecting files into the zipped jar file. \
\
Claiming this plugin as your own is strictly forbidden. \
\
You are allowed to use the plugin on multiple servers, if these solely belong to you. A valid circumstance would be as follows: "You own a Survival and Earth Server on your Network and both should utilise Vehicles.". If you do not own the server, this counts as sharing.\
\
You receive the same version as every other buyer / user. Unique and custom additions will not be offered or created at any time. Additions to the plugin will be published for everyone to use.

Only licenses purchased directly from the official SpigotMc site, will be considered valid and eligible for product support and updates. Licenses obtained from third-party sources or unauthorized vendors will not be recognized as legitimate.

## Purchases

You are not allowed to purchase our content without reaching a sufficient legal age. If you have not met this legal age, the content must be purchased through a parent or legal guardian. We reserve the right to ask for verifiable consent from your parent or legal guardian, in case of a dispute.

## Disputes

In case of an error during purchase, including, but not limited to, not received licenses, and PayPal issues, please contact us first and immediately. We can speed up certain processes or discuss certain issues with you faster this way.\
\
Please keep in mind, that SpigotMc and PayPal may take up to 24 hours to register and complete your payment. If you haven't received it after 24 hours please contact us.\
\
Refunds will only be given within 14-days after purchase, with valid reason. Refunds at a later date will not be offered.  Please contact us, if you have any questions or concerns beforehand.\
\
Chargebacks and refunds will remove your access to the plugin immediately and forever. You may not be guaranteed another chance to purchase the plugin later, if you change your mind again.

## Service and Maintenance

When the plugin is bought, the current state of the plugin is guaranteed. Further maintenance, including, but not limited to, version updates, additions of features, or bug fixes, is not guaranteed at any time.\
\
On purchase, you receive all available versions, which are listed on SpigotMc. As mentioned above, updates are not guaranteed. Outdated plugin versions might be removed without warning. Support for outdated Minecraft Versions may also be removed at any time, if we deem it to be necessary.\
\
We reserve the right to do any of the following, at any time, without notice:\
\
1\) Remove and add features to our liking. (Submitting a suggestion, or a bug report, does not ⠀⠀ ⠀⠀ guarantee the addition or fixing of named feature.)\
\
2\) Alter the price of the plugin at any given time. (This will not affect already purchased licenses.)\
\
3\) Change the platform, on which the plugin is sold / distributed on.

## Support

Support, regarding the plugin, can be received by the Vehicles Team. Please use the SpigotMC discussions tab, or preferably the discord server, if you seek for assistance. More information on submitting reports or questions can be found in section "[Comments and Reviews](#comments-and-reviews)".\
\
Support, despite being free, is limited to all users who have purchased a license. Only one user per license is eligible for support on our discord server. Preferably the user who has purchased it.\
\
You must go through a verification process on our Discord in order to receive plugin support. If you have questions regarding the plugin before purchase, we will answer these regardless.\
\
The Vehicles support team reserves the right to ask for the PayPal transaction id, either as a screenshot or as plain text, in case further proof of purchase is requirednt.\
\
Attemted deception, this includes but is not limited to edited screenshots and forged transaction IDs or emails, during verification, will result in a permanent ban from the Discord and you will not be eligible for further support.

## Comments and Reviews

Suggestions or bug reports which have been submitted via the comments or reviews section on SpigotMc, may not be acknowledged and have a high chance of being ignored. You must post them on the forum or in our Discord, in order to correctly submit your suggestions or reports. See "[Service and Maintenance](#service-and-maintenance)".

## User Account

If you own an account with a license, you are solely responsible for all activites that occur under your account, including, but not limited to, another user using your login data to obtain the plugin. All consequences will have to be faced with your account, even if it includes the removal of your license.

## TOS Updates

We reserve the right, in our sole discretion, to make changes or modifications to these Terms of Service at any time and for any reason.

We may alert you about any changes by notifing the "@Wiki Updates" role on our Discord. You waive any right to receive specific notice of each such change.\
\
It is your responsibility to periodically review these Terms of Service to stay informed of updates. You will be subject to, and will be deemed to have been made aware of and to have accepted, the changes in any revised Terms of Service by your continued use of the Plugin after the date such revised Terms of Service are posted.

## Contact

If you have any questions about these terms, please contact us on our official discord. From there we will offer you multiple ways of further contact, if you insist on not using discord.

{% hint style="info" %}
December 15, 2024 | 21:50 CET
{% endhint %}