How to Install Mods on a Vintage Story Server

Vintage Story's mods live on its official ModDB, mods.vintagestory.at, and a server installs them as zip files. A few rules keep a modded world healthy.

Where mods go

A server loads every mod zip in the Mods folder of its data path when it starts. Leave the zips packed. Players are offered the server's mods to download from the ModDB when they join.

Match the game version

Each release on the ModDB is tagged with the game versions it was made for. A release for 1.22.0 usually runs on every 1.22.x, but a release for 1.21 rarely runs on 1.22. Install the release tagged for your server's version, or the newest one of the same version line.

Dependencies

Many mods need a library mod (Carry On needs CarryOnLib, for example), listed in the mod's modinfo.json. Install those too, or the mod does not load.

On Flux

  • The Mods tab searches the whole ModDB for your server's version and installs with one click, dependencies included. The game's own /moddb install command fails on 1.22.7; the panel does not use it.
  • Mods that only change what a player sees are flagged as players-only: they do nothing on a server.
  • Turn a mod off without deleting it, and update every mod at once when the ModDB has newer releases.
  • Every change applies after a restart, which the tab offers.
Tip:Removing a mod that added blocks or items to a world leaves those as unknown blocks. Back up first: the Backups tab keeps the world as it was.

Frequently asked questions

Do players have to install the server's mods?

The game offers to download the server's mods from the ModDB when a player joins.

Can I upload my own mod?

Yes: put its zip in the Mods folder with the Files tab, and restart.

Related Vintage Story guides

Vintage Story on Flux

Rent a dedicated Vintage Story server from $4.99/mo. Any play style and world setting, mods from the official ModDB in one click, roles and the whitelist, backups and the server console in your browser.

A product of Flux

© 2026 InFlux Technologies. All rights reserved. v1.19.28