About VehiclesLib
From Vintage Story ModDBA library to make it easy to add vehicles to the game using JSON modding.
If you find a bug, have a suggestion or want to talk, feel free to join my Discord server!
VehiclesLib is a library that makes it easy to add vehicles to the game.
This library supports boats, cars, motorcycles, helicopters, airships, flying brooms... You name it. Only thing not supported yet are airplanes.
How to use VehiclesLib?
VehiclesLib supports three types of fuel: gas, steam and temporal. There's also a "none" fuel for vehicles that don't need any fuel.
Refueling a vehicle is simple:
- For gas, just right-click your vehicle with a bucket filled with a valid fuel (in vanilla, only Aqua Vitae can be used in a gas engine). You can pick the fuel back up by shift+right-clicking the vehicle with a bucket.
- For steam, fill it with water by right-clicking it with a water bucket, then add any combustible (wood, coal... With the exception of peat, which doesn't work right now) to it and wait for it to heat up.
- For temporal, just right-click the vehicle with a valid temporal fuel (in vanilla, that's temporal gears).
To drive your vehicle, simply use WASD, and for flying vehicles, space and control.
To pick up a vehicle, dismount it, hold CTRL and right-click it. Note that not all vehicles can be picked up! Also note that picking up a vehicle will lose its fuel.
However, being a library, VehiclesLib adds nothing by itself. You'll need to install a mod that uses it to actually get something out of it.
Here's a list of the mods that use VehiclesLib:
For modders: how does it work?
VehiclesLib adds a relatively simple JSON API to create your vehicles, giving you full control over wheels, steering wheels, propellers and seats (up to 16 seats can be added to a single vehicle). A documentation is on its way, in the meantime feel free to check out the mods that use it for reference, or to ask me on discord (@moby_dick, or over on my discord server)
Here's an overview of the JSON attributes you'll have to add to your entity (the entity's class should be EntityVehicle, or another class inheriting from that).
The specified values are the default values (except for seats and animation parts, they're empty lists by default), if you don't want to change them, you don't have to add them to the file.
"Attributes": { "VehicleProps": { "canBePickedUp": true, # Whether the vehicle can be picked up with ctrl+right click "density": 100.0, # Any density higher than 1000 will make the vehicle sink in water, lower will make it float "SwimmingYOffset": 0.45, # The vertical offset at which the vehicle will float, if it floats "topSpeed": 1.0, # The vehicle's top speed, not really in blocks/second somehow but pretty close "acceleration": 1.0, # The vehicle's acceleration. Higher values means it will reach its top speed faster "swivelAngle": 0.0, # The game's swivel angle. Apparently it's pitching up and down when moving? "groundMultiplier": 1.0, # The ground speed multiplier "waterMultiplier": 0, # The water speed multiplier "turnSpeed": 45.0, # The vehicle's turning speed, in degrees per second I think "movingTurnOnly": false, # Whether the vehicle can only turn when moving forwards and backwards (think wheels) "canStepUp": true, # Whether the vehicle can step up blocks
"stepHeight": 1.1, # How high the vehicle can step up "canReverse": true, # Whether the vehicle can drive in reverse "canBrake": true, # Whether the vehicle can brake by pressing space. Recommended false for flying vehicles "seats": [ # The array of all seats { "isControllable": true, # Whether the seat can control the vehicle "angleMode": 1, # The angle mode of the seat. See values below. "lockBodyYaw": true, # Whether the player's yaw will be locked. Good for oriented seats "offset": { # The offset of the seat "x": 0, "y": 0, "z": 0 }, "suggestedAnimation": "sneakidle", # The animation the player will play on the seat. See values below. "parentPart": "", # Not implemented "aimPart": "", # Not implemented "maxAimAngle": 0.0 # Not implemented } ], "wheels": [ # The list of wheel parts for animation. Will rotate around their Z axis { "partName": "", # The model part name of the wheel "strength": 1.0, # The rotation speed of the wheel "enabled": true # Set to false to disable the
Highlights
From source dataGame versions
Supports 3 Vintage Story versions, the newest being 1.19.4.
Footprint
Rated a light load on a server.
VehiclesLib on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
- Server side
- Required on the server
- Server load
- light
- Smallest plan we suggest
- Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.
Run VehiclesLib on a Vintage Story server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogTechnology & automation
Machines, power, logistics and automation.
Runs on your server
From source side supportVintage Story ModDB lists VehiclesLib as required on the server. Check its Vintage Story ModDB page to see whether players need it too.
Compatibility
- Game
- Vintage Story
- Runs on
- Serverrequired on the server
- Game versions
- 1.19.4 and 2 earlier
Verified at the source
- ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
- ✓AuthorMoby_, as published on Vintage Story ModDB
- ✓LicenseNot published by the sourceFree













