# 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>](https://docs.vehiclesplugin.com/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. |