Getting started with your Vintage Story server
Updated July 02, 2026
Vintage Story Vintage Story Server Setup
Vintage Story is a deep technological survival sandbox with realistic crafting chains, geology, and seasonal systems. The dedicated server is lightweight and has strong modding via the official ModDB.
First Boot
- Open your Vintage Story server in the panel.
- Click Start.
- First boot pulls the server files (about 500 MB; very small). 3 to 5 minutes.
- The console shows
Server program version: x.x.xfollowed byServer entering RUNNING state.
To connect: in Vintage Story, Multiplayer > Direct Connect, enter IP and port (default 42420).
In-Game Admin Commands
Code
/time set day /time set night /weather set sunny /weather set rain /tp <player> /tpp <player1> <player2> Teleport one player to another /gamemode 0/1/2 0=survival, 1=creative, 2=spectator /give <item> <count> /spawn Teleport to spawn /setspawn Set spawn at your location /clear Clear chat /savemap Save the world /stop Shut down the server /kick <player> /ban <player> /unban <player>
World Management
Worlds are at Saves/ in the data folder. Each world is a .vcdbs (SQLite) file plus folders for chunks and player data.
To wipe:
- Stop the server.
- Delete or rename the world file.
- Restart. A new world generates with the seed from
serverconfig.json.
To upload a single-player save:
- Find your local save at
%AppData%\VintagestoryData\Saves\. - Upload to the server's
Saves/. - Update
serverconfig.json'sWorldNamefield.
Backups
World saves are small (50 MB to 2 GB even for long-running servers). Daily panel Backups are very cheap.
Vintage Story also creates in-engine backups in Backups/ automatically every few hours.
Performance Tips
- Lower
MaxChunkRadiusif you see chunk-load lag (12 is a good compromise) - Schedule a daily restart to clear cached chunk memory
- Watch the console for chunk save messages; if they take longer than 5 seconds, your disk I/O is the bottleneck
Common Issues
- Server not in public list: Confirm
AdvertiseServer: true. The list also takes a few minutes to populate on first boot. - Mods fail to load: Check the console log for the failure reason. Usually a missing dependency like CommonLib.
- Cannot connect with "version mismatch": Player is on a different VS version. Game updates frequently; restart the server to pull the latest version.
- World load slow: Normal for older saves with many explored chunks. 30-60 seconds is typical for a year-old save.