Stratum

Stratum is a high-performance, server-side fork of Vintage Story.

Sponsors

Big thanks to everyone supporting Stratum.

Financial support now goes through OpenCollective, which gives the project a cleaner and more transparent way to handle donations and project costs.

Older Ko-fi supporters are still listed below because they helped Stratum early on.

Supporters

Algernon

PHoenixOPHury

PARTIZAN_N

_{Thanks for helping keep Stratum moving.}

Server Stats

_{Statistics shown are as of v1.22.3-stratum.15-indev.1 and on.}

Install

1. Grab the latest stratum-<version>-<rid>.zip from Releases.
2. Extract it.
3. Run StratumServer.exe on Windows or ./StratumServer on Linux.

First launch gets the official Vintage Story server archive through Anego's release manifest, verifies it, unpacks it, and writes Stratum's patched files on top. Later launches use the prepared install unless the Stratum or base version changes.

Flags

Flag	Effect
--stratum-version	Print version info and exit
--stratum-help	Print launcher options and exit
--stratum-refresh	Download and prepare the base server again
--stratum-skip-bootstrap	Skip first-run prepare work
--stratum-prepare-only	Prepare the install, then exit
--stratum-no-banner	Suppress the startup banner

Anything else is forwarded to the server, such as --port or --dataPath.

Build

Requires the .NET 10 SDK and git. Linux/macOS also need bash, python3, and curl.

# Linux / macOS
git clone https://github.com/StratumServer/Stratum.git
cd Stratum
make build        # bootstrap + build in one step
make smoke        # build + boot-test the server

# Windows (PowerShell)
git clone https://github.com/StratumServer/Stratum.git
cd Stratum
.\scripts\bootstrap.ps1
dotnet build VintageStory.slnx -c Release
.\scripts\smoke-test.ps1    # boot-test the server

bootstrap.ps1 resolves the targeted official server archive through Anego's release manifest, verifies it, decompiles VintagestoryLib and VintagestoryServer into baseline/, clones the forks pinned in forks.json, applies every patch in patches/, and drops Stratum-only files from sources/ into place.

After bootstrap, every patched file carries a // Stratum: marker so edits are easy to find. Edit, build, then run .\scripts\extract-patches.ps1 to regenerate the diffs. Full workflow in CONTRIBUTING.md.

See SECURITY.md for reporting exploits.

Versions

Stratum builds are tagged v<vs-version>-stratum.<rev>, for example v1.22.3-stratum.1.

The vs-version half always matches the Vintage Story release the server was built against. The stratum.<rev> half increments per public Stratum release on that base.

See CONTRIBUTING.md for the full scheme.

License

MIT.