‼️ See GitHub for the latest binaries for Windows, Linux, and macOS.  Versions will not be updated here regularly due to the ModDB API not supporting automated publishing. ‼️

Vintage Story Mod Manager (vsmod)

A command-line tool designed to manage mods for Vintage Story, a wilderness survival sandbox game, using a simple config file.

[!WARNING] Early version. Expect bugs!

Features

Download mods

Mod and Game version compatibility

Each time a new game version is released mod authors must manually mark their mods as compatible with it. Many don’t bother to do this, breaking reliable compatibility checks.

To work around this, game_version supports semver constraints. For example, setting it to ~1.20.0 will mean as long as a mod is marked as compatible for 1.20.0, 1.20.1, 1.20.2, etc., it will be downloaded.

List mods

Hooks

Pre and post-run hooks can be used to run arbitrary commands before or after a vsmod command runs. For example, you can use a pre-run hook to clear the mods directory before downloading new mods. Hooks also support templating values from the config file. See the documentation for Go’s text/template package for how to use templating.

Hooks can be skipped by passing --hooks=false.

Installation

Download pre-built binaries for Windows, macOS and Linux on the Releases page.

Usage

Run vsmod --help to see the available commands and their options.

An example configuration file can be found in examples/.

Container Image

vsmod is also built as a container image.

Planned Features

• Mod version updating

Support

Please raise an issue if you need help or have a feature request. Even better, raise a pull request if you’re able.