Completely Reset a Vintage Story Server
The fastest way to completely reset a Vintage Story server without keeping the old world is to stop the server, back up, delete the world save in data/Saves, clear data/Playerdata, and start again. That is quicker than a reinstall. A world-only reset leaves serverconfig.json and the Mods folder in place. Wiping one player uses /player [playername] wipedata and does not reset the server.
Choose a reset path
Section titled “Choose a reset path”- Complete reset. Delete the world save and player data so the old world is gone.
- World-only reset. Delete only the world file in
data/Saves. Server settings and mods stay. - One player’s data. Run
/player [playername] wipedatafrom the console. The world, other players, settings, and mods stay.
Back up before any of these. Deleting a world save or player data cannot be undone from the panel except by restoring a backup.
Back up server files first
Section titled “Back up server files first”Create a backup from the Backups tab and wait for it to finish before you delete files or reinstall. A reset removes world progress.
Which files matter most?
Section titled “Which files matter most?”| Path | What it holds |
|---|---|
data/Saves |
World save (.vcdbs, often default.vcdbs) |
data/Playerdata |
Character data for players on the server |
data/serverconfig.json |
Server settings, including SaveFileLocation |
Mods |
Installed mods |
[WORLD] values on Startup (playstyle, seed, land claiming) apply when Vintage Story generates a new world. [ADMIN] Startup values are written into serverconfig.json on each start.
Completely reset without keeping the old world
Section titled “Completely reset without keeping the old world”Use this when you want a fresh world and fresh characters, and you do not need the old save.
- Open the Blacksmith’s Portal and select your Vintage Story server
- Stop the server
- Create a backup from the
Backupstab - Review
[WORLD]options on theStartuppage (playstyle, seed, land claiming, and other new-world settings) before you wipe - Go to
Files→data→Saves - Delete (or move) the
.vcdbsworld file — oftendefault.vcdbs. IfSaveFileLocationindata/serverconfig.jsonnames a different file, delete that file too - Clear player data under
data/Playerdata - Leave the
Modsfolder and the rest ofdata/serverconfig.jsonin place unless you also reinstall - Start the server so Vintage Story generates a new world using your current
[WORLD]Startup values
Reset only the world
Section titled “Reset only the world”This keeps server settings and mods. Characters in data/Playerdata stay unless you clear them.
- Stop the server
- Create a backup from
Backups - Review
[WORLD]options onStartupif the new world should use a different playstyle or seed - Go to
Files→data→Saves - Delete (or move) only the
.vcdbsworld file — oftendefault.vcdbs - Leave
data/Playerdata,data/serverconfig.json, and theModsfolder unchanged - Start the server so Vintage Story generates a new world
If SaveFileLocation points at a specific save, delete that file or the server will keep loading it. To upload a replacement map instead, see create a custom world.
Wipe one player’s data
Section titled “Wipe one player’s data”This does not reset the world or other players. Open the Blacksmith’s Portal Console (or in-game chat with admin privileges) and run:
/player [playername] wipedataReplace [playername] with the exact player name. The Vintage Story wiki player commands document this command as wiping that player’s data, including inventory, skin, and class.
| Item | What happens |
|---|---|
| Target player | Inventory, skin, and class are wiped |
| Other players | Unchanged |
World save in data/Saves |
Unchanged |
serverconfig.json and Mods |
Unchanged |
Do not delete the whole data/Playerdata folder when you only want one player reset. More commands are in Vintage Story server commands and the Vintage Story wiki server commands.
Reinstall game files
Section titled “Reinstall game files”Use a reinstall when you also want fresh game binaries (for example after a bad update). A soft reinstall refreshes game files. It does not, by itself, replace a world you want to keep.
- Stop the server
- Create a backup from
Backups - Confirm
Release branchandRelease versiononStartup - Go to
Settingsand clickReinstall Server - Confirm the reinstall and wait for it to finish
- Start the server
If you need a fully clean world after reinstalling, remove the world save and player data as in the complete reset above, or restore only what you need from the backup.
After resetting
Section titled “After resetting”- Confirm playstyle and other
[WORLD]Startup options before players join - Re-check
[ADMIN]Startup settings such as password, whitelist, and Startup Commands - To bring back a customized single-player map, use create a custom world
Frequently Asked Questions
Section titled “Frequently Asked Questions”Should I back up before resetting a Vintage Story world?
Section titled “Should I back up before resetting a Vintage Story world?”Yes. Create a backup from the Backups tab first. The files that matter most are the world save in data/Saves, character files in data/Playerdata, data/serverconfig.json, and the Mods folder.
What is the fastest way to completely reset a Vintage Story server?
Section titled “What is the fastest way to completely reset a Vintage Story server?”Stop the server, back up, delete the .vcdbs file in data/Saves, clear data/Playerdata, then start. That drops the old world without a full reinstall.
Can I reset the world and keep mods and settings?
Section titled “Can I reset the world and keep mods and settings?”Yes. Delete only the world file in data/Saves. Leave Mods and data/serverconfig.json alone, then start the server.