About PhysicsLib - Solid boats and entities
From Vintage Story ModDBThis mod implements a long awaited feature - solid entities!
After many moons of coding to determine how on earth player motion is controlled by vintage story, i present to you PhysicsLib - Solid Entities.
On its own, solid entities only makes the vanilla sailboat walkable, but it opens the door for any modder to patch existing entities or implement their own with solid collisions!
Mods Currently leveraging PhysicsLib:
VS Airships
Shipwrights
How does it work?
Physics lib is simple, it implements 1 entity behaviour which can be patched onto existing entities, or leveraged directly within mods - behaviour code: "dynamic-physics".
With this one entity behaviour attached, every cube in the shape file of the model will be used to build up a dynamic collision box for the shape of the entity, and then caches it to be reused for every instance of that model.
In order to prevent EVERY cube being used, wildcard selection can be used against the cubes of the model.
(For Modders/Asset creators) How to set it up for your own entities, or patch existing ones:
- Remove the ellipsoidalrepulseagents from the entity(if present, otherwise your fancy new solid entities will be pushed away from your own hitbox)
- Add the physicslib behaviour with code "dynamic-physics" to both the client and server behaviours of the entity.
- Optionally, supply a "selectors": [] object with a list of selectors for the list of cubes in the model youd like included in collision.
Example Patch for the vanilla sailboat, the first 2 sections remove ellipsoidrepulseagents behaviour, the next 2 add the behaviour to client and server:
<pre> </pre>Highlights
From source dataGame versions
Supports 3 Vintage Story versions, the newest being 1.22.3.
Footprint
Rated a light load on a server.
PhysicsLib - Solid boats and entities 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 PhysicsLib - Solid boats and entities 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 catalogQuality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Runs on your server
From source side supportVintage Story ModDB lists PhysicsLib - Solid boats and entities 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.22.3 and 2 earlier
Verified at the source
- ✓Vintage Story ModDBOfficial listing, checked 2026-09-24
- ✓AuthorDavis99, as published on Vintage Story ModDB
- ✓LicenseNot published by the sourceFree















