docs: create vehiclesplus/configuration/vehicles
This commit is contained in:
stijnb1234
parent
02e00f49ff
commit
a12fd27b80
1 changed files with 258 additions and 0 deletions
258
vehiclesplus/configuration/vehicles.md
Normal file
258
vehiclesplus/configuration/vehicles.md
Normal file
|
|
@ -0,0 +1,258 @@
|
|||
---
|
||||
title: Vehicle Configuration
|
||||
description: Configure the base vehicles.
|
||||
published: true
|
||||
date: 2023-07-22T14:07:37.924Z
|
||||
tags:
|
||||
editor: markdown
|
||||
dateCreated: 2023-07-22T14:07:37.924Z
|
||||
---
|
||||
|
||||
# Vehicle Configuration
|
||||
## Settings per vehicle
|
||||
### The configuration file
|
||||
This section explains which settings are available per vehicle.
|
||||
*Per setting will be explained what it means as a comment (`#`).*
|
||||
```yaml
|
||||
# DO NOT CHANGE!
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.BaseVehicle
|
||||
# The unique identifier of this base vehicle.
|
||||
name: ExampleCar
|
||||
# The type of the vehicle (check out the default for the type to use to get the correct value).
|
||||
vehicleType: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.types.CarType
|
||||
# The permissions for this vehicle
|
||||
permissions:
|
||||
# DO NOT CHANGE!
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.VehiclePermissions
|
||||
# The permission to buy this vehicle.
|
||||
buyPermission: vp.buy.car
|
||||
# The permission to drive this vehicle.
|
||||
ridePermission: vp.ride.car
|
||||
# If true, players can sit in the non-driving seats without the ride permission.
|
||||
enterWithoutRidePermission: true
|
||||
# The list of available colors in the shop (will only work for COLORABLE_ARMOR).
|
||||
baseColorList:
|
||||
# To add a new color, just copy the last one and add 1 to the list value, for example list5.
|
||||
list0:
|
||||
==: Color
|
||||
ALPHA: 255
|
||||
RED: 255
|
||||
BLUE: 0
|
||||
GREEN: 0
|
||||
list1:
|
||||
==: Color
|
||||
ALPHA: 255
|
||||
RED: 0
|
||||
BLUE: 0
|
||||
GREEN: 0
|
||||
list2:
|
||||
==: Color
|
||||
ALPHA: 255
|
||||
RED: 255
|
||||
BLUE: 255
|
||||
GREEN: 255
|
||||
list3:
|
||||
==: Color
|
||||
ALPHA: 255
|
||||
RED: 128
|
||||
BLUE: 128
|
||||
GREEN: 128
|
||||
list4:
|
||||
==: Color
|
||||
ALPHA: 255
|
||||
RED: 192
|
||||
BLUE: 192
|
||||
GREEN: 192
|
||||
# The list of parts for this vehicle. The full list will be explained further below.
|
||||
partList:
|
||||
list0:
|
||||
[...]
|
||||
# The max speed settings.
|
||||
speedSettings:
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.base.storage.StorageUpgradeable
|
||||
# The base max speed value (given when bought).
|
||||
base: 100
|
||||
# The maximum max speed value (which can be upgraded to).
|
||||
max: 200
|
||||
# The steps per upgrade for the max speed value (will be added to the current value at upgrade).
|
||||
step: 5
|
||||
# The cost to upgrade with the step value.
|
||||
upgradeCost: 1000
|
||||
# The fuel tank settings.
|
||||
fuelTankSettings:
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.base.storage.StorageUpgradeable
|
||||
# The base fuel tank value (Liters) (given when bought).
|
||||
base: 50
|
||||
# The maximum fuel tank value (Liters) (which can be upgraded to).
|
||||
max: 100
|
||||
# The steps per upgrade for the fuel tank value (Liters) (will be added to the current value at upgrade).
|
||||
step: 5
|
||||
# The cost to upgrade with the step value.
|
||||
upgradeCost: 1000
|
||||
# The turning radius settings.
|
||||
turningRadiusSettings:
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.base.storage.StorageUpgradeable
|
||||
# The base turning radius value (given when bought).
|
||||
base: 7
|
||||
# The maximum turning radius value (which can be upgraded to).
|
||||
max: 15
|
||||
# The steps per upgrade for the turning radius value (will be added to the current value at upgrade).
|
||||
step: 1
|
||||
# The cost to upgrade with the step value.
|
||||
upgradeCost: 1000
|
||||
# The acceleration settings.
|
||||
accelerationSettings:
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.base.storage.StorageUpgradeable
|
||||
# The base acceleration value (given when bought).
|
||||
base: 50
|
||||
# The maximum acceleration value (which can be upgraded to).
|
||||
max: 100
|
||||
# The steps per upgrade for the acceleration value (will be added to the current value at upgrade).
|
||||
step: 5
|
||||
# The cost to upgrade with the step value.
|
||||
upgradeCost: 1000
|
||||
# The horn settings (not compatible with drift).
|
||||
hornSettings:
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.base.storage.StorageHorn
|
||||
# If true, the horn sound will be played at space.
|
||||
enabled: true
|
||||
# The sound to play for the horn.
|
||||
# Full list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html#enum-constant-summary
|
||||
sound: BASS
|
||||
# The cooldown (seconds) before the horn can be pressed again.
|
||||
cooldown: 0
|
||||
# If true, the vehicle can drift when pressing space (not compatible with the horn).
|
||||
drift: true
|
||||
# The exhaust settings.
|
||||
exhaustSettings:
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.base.storage.StorageSmoke
|
||||
# If true, the exhaust particle will be shown.
|
||||
enabled: true
|
||||
# The X offset (from the base) for the particle location.
|
||||
xOffset: -5.0
|
||||
# The Y offset (from the base) for the particle location.
|
||||
yOffset: 0.0
|
||||
# The Z offset (from the base) for the particle location.
|
||||
zOffset: 0.0
|
||||
# The particle to show.
|
||||
# Full list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html#enum-constant-summary
|
||||
particleName: SMOKE_LARGE
|
||||
# If true, players can exit while the vehicle is moving.
|
||||
# PLEASE NOTE: On Minecraft 1.16.x, setting this value to false will NOT work!
|
||||
canExitWhileMoving: true
|
||||
# The price for this base vehicle.
|
||||
price: 100000.0
|
||||
# The fuel settings.
|
||||
fuelSettings:
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.base.storage.StorageFuel
|
||||
# The fuel usage (Liters) of this vehicle.
|
||||
usage: 6.0
|
||||
# The type of fuel to use. This references the ID of the created fuel type.
|
||||
# By default, only GASOLINE is available.
|
||||
type: GASOLINE
|
||||
# The total health available on this vehicle.
|
||||
health: 100
|
||||
# The size (slots) available in the trunk.
|
||||
# Available options: 0, 9, 18, 27, 36, 45, 54
|
||||
trunkSize: 27
|
||||
# The hitbox settings.
|
||||
hitbox:
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.base.storage.StorageHitbox
|
||||
# The length of the hitbox (from to back).
|
||||
length: 3.0
|
||||
# The width of the hitbox (left to right).
|
||||
width: 2.0
|
||||
# The height of the hitbox (bottom to top).
|
||||
height: 1.0
|
||||
# If true, realistic steering will be used. How longer you press the steering keys (A-D), how stronger the vehicle will steer to that direction.
|
||||
steeringType: true
|
||||
# If true, the skin model will be placed on the hand of the armorstand.
|
||||
# If false, the skin model will be placed on the head of the armorstand.
|
||||
handModel: false
|
||||
```
|
||||
|
||||
### Parts
|
||||
Parts can be added to the vehicle. Some parts are visible (using an item), some are not.
|
||||
|
||||
#### Skin
|
||||
The skin part represents the chassic of the vehicle.
|
||||
```yaml
|
||||
[...]
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.addons.skins.Skin
|
||||
# The skin item to show.
|
||||
# For all the available settings, check out: https://www.spigotmc.org/wiki/itemstack-serialization/
|
||||
skin:
|
||||
==: org.bukkit.inventory.ItemStack
|
||||
v: 3337
|
||||
type: LEATHER_BOOTS
|
||||
meta:
|
||||
==: ItemMeta
|
||||
meta-type: COLORABLE_ARMOR
|
||||
Unbreakable: true
|
||||
Damage: 1
|
||||
# The color of the skin item (will only work for COLORABLE_ARMOR).
|
||||
color:
|
||||
==: Color
|
||||
ALPHA: 255
|
||||
RED: 255
|
||||
BLUE: 255
|
||||
GREEN: 255
|
||||
# The X offset (from the base).
|
||||
xOffset: 0.0
|
||||
# The Y offset (from the base).
|
||||
yOffset: 0.0
|
||||
# The Z offset (from the base).
|
||||
zOffset: 0.0
|
||||
# DO NOT CHANGE
|
||||
UID: 83479cdf-55fb-4d75-98f6-312b7b38343f
|
||||
# DO NOT CHANGE
|
||||
isCustomPlaced: false
|
||||
```
|
||||
|
||||
#### Seat
|
||||
|
||||
|
||||
The seat parts represents a seat in the vehicle. Players can sit on each seat.
|
||||
```yaml
|
||||
[...]
|
||||
# DO NOT CHANGE
|
||||
className: me.legofreak107.vehiclesplus.vehicles.vehicles.objects.addons.seats.Seat
|
||||
# If true, the player can drive the vehicle from this seat (will only work for ONE seat!).
|
||||
steer: true
|
||||
# The X offset (from the base).
|
||||
xOffset: 0.0
|
||||
# The Y offset (from the base).
|
||||
yOffset: 0.0
|
||||
# The Z offset (from the base).
|
||||
zOffset: 0.0
|
||||
# DO NOT CHANGE
|
||||
UID: d13eb53e-bfa8-44e1-bc55-c250fb20880b
|
||||
# DO NOT CHANGE
|
||||
isCustomPlaced: false
|
||||
```
|
||||
|
||||
####
|
||||
|
||||
## Modifying an existing vehicle
|
||||
The plugin comes with a standard vehicle per type (cars, motorcycles, boats, etc.).
|
||||
|
||||
- `bikes/ExampleBike.yml`
|
||||
- `boats/ExampleBoat.yml`
|
||||
- `cars/ExampleCar.yml`
|
||||
- `helicopters/ExampleHelicopter.yml`
|
||||
- `hovercrafts/ExampleHovercraft.yml`
|
||||
- `planes/ExamplePlane.yml`
|
||||
- `tanks/ExampleTank.yml`
|
||||
|
||||
The default files can be download from [the GitHub repository](https://github.com/SBDPlugins/VehiclesPlus/tree/master/Vehicle%20Models/Examples-v2).
|
||||
|
||||
## Creating your own new vehicle
|
||||
Reference in a new issue