Configuration
The settings in config.yml and the other files. config.yml is only read at startup.
Database and language
| Key | Description |
|---|---|
license-key | In license-key.yml: the license key. The plugin verifies it on every start and then every 6 hours; if the license is no longer valid, it disables itself. |
host, port, database, username, password, tablePrefix | In database.yml: the MySQL connection and the table prefix (ev_). |
economy.free | With true payments are turned off and everything is free (for servers without an economy). |
data.interval | How many seconds between saves of changed data (10). |
language | Message file in vehicle-messages/ (it_IT). |
placeholderapi | With PlaceholderAPI installed, every text accepts its placeholders (true by default). With false they stay as written. |
smallcaps | Writes every text of the plugin in small caps (true by default). With false texts stay as written. Tags and color codes do not change. |
Limits and rules
| Key | Description |
|---|---|
limits.have | Vehicles owned per player (10, -1 unlimited). |
limits.spawn | Vehicles out on the road at once per player (5, -1 unlimited). |
spawnLocked | Vehicles spawn locked. |
actionBar | Shows the driver's action bar (true). |
hud.show | What appears in the action bar, in the written order: speed, fuel and integrity. Remove an entry to hide it; an empty list hides everything. |
hud.low-fuel.percent | Below this fuel percentage the warning appears next to the value (15; 0 = never). |
hud.low-fuel.sound | Warning sound (block.note_block.pling). Empty: no sound. Accepts any Minecraft sound key. |
hud.low-fuel.sound-interval-seconds | Seconds between two beeps (10; 0 = a single beep when fuel first drops below the threshold). |
plate.pattern | Plate pattern. |
requests.timeout-seconds | Duration of sale and transfer requests. |
distance.enabled | Requires proximity for sales and transfers. |
distance.blocks | Maximum distance in blocks. |
Driving and collisions
| Key | Description |
|---|---|
collision.enabled | With false the collision system is off: no damage, no VehicleCollisionEvent, no impact with living entities or other vehicles. |
collision.entities.enabled | With false vehicles never hit living entities. |
collision.entities.players | With false players are never hit (animals and mobs still are). |
collision.entities.damage | With false living entities are only pushed, without damage. |
collision.vehicles.enabled | With false vehicles pass through each other without damage. |
collision.disabled-worlds | List of worlds where collisions are always off. |
collision.damageLevel | REALISTIC, NORMAL, REDUCED, MINIMAL or NONE. |
collision.despawnOnZeroHealth | The vehicle disappears at zero health. |
collision.dropTrunkItems | The trunk's contents drop on the ground when the vehicle is destroyed. |
collision.behavior.blockDriving | Climb full blocks and stairs. |
collision.behavior.slabDriving | Climb slabs. |
collision.behavior.stopAtBlock | Blocks stop the vehicle. |
collision.behavior.stopAtEntity | Living entities stop the vehicle. |
collision.behavior.stopAtVehicle | Other vehicles stop the vehicle. |
repairCostDivision | Repair cost = price divided by this value (100). |
driving.mode | WASD or HORSE (see Driving). |
driving.horse.full-lock-degrees | Direction error at which the steering is at its maximum (35). |
driving.horse.dead-zone-degrees | Below this error the vehicle drives straight (3). |
driving.horse.reverse | In HORSE, S brakes and then reverses (true; false: only brakes). |
driving.horse.strafe.enabled | In HORSE, A and D move the vehicle sideways while keeping the look direction (false). |
driving.horse.strafe.speed-share | Sideways speed as a share of the top speed (0.35). |
driving.horse.turn-in-place | In HORSE, cars can turn while standing still (false). |
driving.horse.aircraft.look-climb | In HORSE, planes and helicopters climb and descend with the look (true). |
driving.horse.aircraft.max-pitch-degrees | Look pitch at which climbing is at its maximum (35); beyond it nothing changes. |
driving.horse.aircraft.dead-zone-degrees | Below this pitch the plane holds its altitude (5). |
steering.multiplier | Steering strength of all vehicles (1). |
fuel.usage-basis-km | Kilometers the models' usage refers to (10). |
wheelieMinSpeed | Minimum speed for a motorcycle's wheelie (100). |
animations.wheels.spin | Wheels spin (steer: they steer). |
turrets.break-blocks | Turret explosions break blocks. |
Model appearance
| Key | Description |
|---|---|
display.origin-height | Height above ground of the point the offsets start from (0.8). |
display.seat-offset | Moves every seat (0.5). |
display.scale | Model scale (0.625). |
display.item-transform | display settings of the model to use (HEAD). |
Other files
| File | Description |
|---|---|
blocked-blocks.yml | Forbidden blocks and damage, see Driving, physics and damage. |
company-garages.yml | garages.<name>.title and icon (with the same keys as menu items). |
vehicles-registry.yml | models.<id>.category for models without a category. |
vehicle-messages/it_IT.yml | Chat messages (MiniMessage, with placeholders in curly braces). |