Getting Started with Vintage Story Modding
In-game Mod Manager, mods.vintagestory.at, and multiplayer parity
Vintage Story modding is built into the game by design. Subscribe through the in-game Mod Manager, or drop mods into the Mods/ folder. No third-party tools required.
Step 1 — Open the in-game Mod Manager
Vintage Story → Settings → Mod Manager. The browser pulls from mods.vintagestory.at.
Browse and install. Mods download to %AppData%/VintagestoryData/Mods/ (or equivalent on Linux/macOS).
Step 2 — Install your first mods
Three popular picks:
- Carry Capacity — extend what you can carry, lift, and move.
- More Recipes — additional crafting recipes for life-quality.
- Better Crates — improved storage UI.
Click Install in the in-game browser. Mods take effect on next world load.
Step 3 — Manual install
For mods not on the official repo (rare):
.zip files go directly into %AppData%/VintagestoryData/Mods/. Restart VS; the Mod Manager detects them.
Step 4 — Per-world mod selection
Each world remembers the mods active when it was created. Switching mod sets between worlds works; mid-world changes are mod-specific.
For new worlds: confirm your mod selection before generating; some content mods need to be active during world generation.
Step 5 — Multiplayer
Server-side mods must be installed on the server. Clients with matching mods can connect; mismatched clients are refused.
Common gotchas
- Mod requires newer VS version. Update Vintage Story or use an older mod version.
- Mod conflict. Two mods touching the same recipe or block. Disable to test.
- Multiplayer disconnect. Mod-set mismatch with server.
- Save game corruption. Removing a content mod from a save that used its blocks leaves dangling references. Back up.
Vintage Story's modding scene is one of the cleanest in PC gaming — official, well-supported, and conceptually simple.