Software Distribution Preview

Seraph MPM / VSMM

Vintage Story Mod Package Manager for CLI workflows

Built from the real `vsmm` CLI: config-first JSON manifests, mod discovery from the Vintage Story mod DB, deterministic sync, and backup/restore operations for mod folders.

Go CLI Linux First Windows/macOS Planned Coming Soon
View on GitHub Join Release List Back to Projects

Downloads

Prebuilt binaries are being prepared.

  • Linux x64: coming soon
  • Windows x64: planned
  • macOS ARM/x64: planned

Current installer in repo: `scripts/install.sh`

Release Channel

Public release notes and checksum manifests are not live yet.

  • Stable channel: coming soon
  • Changelog feed: coming soon
  • Versioned binaries: coming soon

First release focus: reliable sync and backup safety.

Purpose

A utilitarian manager for modded setups that should behave like software infrastructure, not manual file juggling.

  • Track desired mods in JSON config
  • Sync managed state to mod directory
  • Back up and restore mod folders

CLI Snapshot (Current)

Based on the current `vsmm` commands from the public Seraph MPM repository.

vsmm init
vsmm search quern --limit 10
vsmm add serverstatusquery --version 1.0.18
vsmm sync --prune
vsmm config --mod-dir /path/to/VintagestoryData/Mods
vsmm backup-create
vsmm backup-list
vsmm backup-restore mods-backup-YYYYMMDD-HHMMSS.zip --clean

Also available: `show`, `browse`, `list`, `remove`, and `install` (alias of `sync`).

Config-First Workflow

Seraph MPM uses a JSON configuration model (`~/.vsmm/config.json`) so teams and solo players can keep mod state reproducible and shareable.

Data Source Vintage Story mod DB API
Config Home `~/.vsmm/`
Core File `config.json`
State Cache `cache/state.json`

Roadmap Note

A GUI may be developed later, but this release track is intentionally CLI-first to establish reliable package semantics and update behavior before adding interface layers.