SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedQuality of life & UI

PhysicsLib - Solid boats and entities

by Davis99 · for Vintage Story

This mod implements a long awaited feature - solid entities!

7.1KDownloads
1.22.3Latest game version
Vintage Story ModDBSource

About PhysicsLib - Solid boats and entities

From Vintage Story ModDB

This 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:

 

Spoiler!

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:

 

  1. Remove the ellipsoidalrepulseagents from the entity(if present, otherwise your fancy new solid entities will be pushed away from your own hitbox)
  2. Add the physicslib behaviour with code "dynamic-physics" to both the client and server behaviours of the entity.
  3. 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>&nbsp;</pre>
Spoiler!
<pre>[ { "file": "game:entities/nonliving/boat-sailed", "op": "remove", "path": "/server/behaviors/0" }, { "file": "game:entities/nonliving/boat-sailed", "op": "remove", "path": "/client/behaviors/0" }, { "file": "game:entities/nonliving/boat-sailed", "op": "addmerge", "path": "/server/behaviors", "value": [ { "code": "dynamic-physics", "selectors": [ "ORIGIN/ORIGIN-Section1/", "ORIGIN/ORIGIN-Section2/", "ORIGIN/ORIGIN-Prow/", "ORIGIN/ORIGIN-Prow2/GunwhaleS4/", "ORIGIN/ORIGIN-Prow2/GunwhaleN4/", "ORIGIN/ORIGIN-Prow2/ProwFloorS6/", "ORIGIN/ORIGIN-Prow2/ProwFloorN5/" ] } ] }, { "file": "game:entities/nonliving/boat-sailed", "op": "addmerge", "path": "/client/behaviors", "value": [ { "code": "dynamic-physics", "selectors": [ "ORIGIN/ORIGIN-Section1/", "ORIGIN/ORIGIN-Section2/", "ORIGIN/ORIGIN-Prow/", "ORIGIN/ORIGIN-Prow2/GunwhaleS4/", "ORIGIN/ORIGIN-Prow2/GunwhaleN4/", "ORIGIN/ORIGIN-Prow2/ProwFloorS6/", "ORIGIN/ORIGIN-Prow2/ProwFloorN5/" ] } ] } ]</pre>

Highlights

From source data

Game 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 catalog
Listed on Vintage Story ModDB as “QoL”

Quality of life & UI

Small conveniences, tweaks and interface improvements players notice straight away.

Runs on your server

From source side support

Vintage 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

PhysicsLib - Solid boats and entities, answered

Generated from the mod’s own source data.

Do my players need to install PhysicsLib - Solid boats and entities?

Vintage 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.

Is it free?

Yes. PhysicsLib - Solid boats and entities is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run PhysicsLib - Solid boats and entities on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add PhysicsLib - Solid boats and entities in one click.