Vintage StoryVintage Story Server Configuration Generator
Create your Vintage Story server config online without writing JSON by hand: set the server name, password, player count, whitelist, PvP and playstyle in the form, or describe your server to an AI in Easy Mode. The live preview shows the finished serverconfig.json, ready to copy or download. Free, no sign-up required, and works directly in your browser.
Built by Florian Galz
Example result
Example: the generated serverconfig.json
You set the options using a form or AI Easy Mode, and the generator creates the finished serverconfig.json for Vintage Story live. Below are the first lines of the default configuration; your file contains your values and all other settings.
Example · Default configuration
Output
{ "FileEditWarning": "This file is being overwritten by the game each time the server is started/stopped. Ensure the server is not running when you edit this file!", "ConfigVersion": "1.0.0", "ServerUrl": null, "Ip": null, "Port": 42420, "UpnpInfiniteLifetime": false, "CompressPackets": true, "LastLaunchMods": null, "LastLaunchPlaystyle": null, "WarnClientsAfterAfkSeconds": 300, "MasterserverUrl": "https://masterserver.vintagestory.at/", "ModDbUrl": "https://mods.vintagestory.at/", "ClientConnectionTimeout": 60, "EntityDebugMode": false,- +45 rowsYou can copy or download the complete file in the generator; the sample lines here only show the beginning.
Settings
What you can set in your Vintage Story server's serverconfig.json
The server configuration is divided into four sections. The key under which each value appears in serverconfig.json is shown in parentheses.
Server identity
Server name (ServerName), description (ServerDescription), welcome message (WelcomeMessage), password (Password), maximum players (MaxClients, 1–100, default 16), and whether the server appears in the public server list (AdvertiseServer).
World
World name (WorldName), seed, playstyle (PlayStyle), and whether players with the right permissions can switch to creative mode (AllowCreativeMode). Seed and playstyle only take effect when a new world is created.
Access & Gameplay
Whitelist-only access (OnlyWhitelisted), PvP (AllowPvP), fire spread (AllowFireSpread), falling blocks such as gravel and sand (AllowFallingBlocks), and whether time continues to pass on an empty server (PassTimeWhenEmpty).
Performance & Admin
Queue for a full server (MaxClientsInQueue, 0–100, default 20), AFK kick after a set number of seconds (KickClientsAfterAfkSeconds, 0 disables it), and UPnP for automatic router port forwarding, which should remain off on a rented server.
The generator covers a selection of the most important settings. All other values, such as the port (default 42420), cannot be changed in the form. Without an import, they come from the file's fixed base structure; with an import, the values from your file are kept.
Guide
How to create your Vintage Story server config
From the first setting to a running server: here's how to get your serverconfig.json onto your Vintage Story server.
- 1
Step 1
Open generator
The generator starts with the default serverconfig.json for Vintage Story, which you can immediately see in the live preview. If you already have a serverconfig.json, upload it using import in the toolbar or paste its contents.
- 2
Step 2
Choose Easy Mode or the form
In Easy Mode, describe your server in your own words, such as “a small password-protected whitelist server for a group of friends.” The AI suggests suitable values and explains each change. Only the suggestions you select are applied. In Advanced Mode, you set every option yourself.
- 3
Step 3
Set server identity
Enter a server name, description, welcome message, and optionally a password. Set the maximum players between 1 and 100 and decide whether the server appears in the public server list.
- 4
Step 4
Configure world and gameplay
Choose a world name, seed, and playstyle for a new world, and set creative mode, whitelist, PvP, fire spread, falling blocks, queue, and AFK kick to your liking.
- 5
Step 5
Check and save the config
Check serverconfig.json in the live preview; the generator flags invalid values. Then copy or download the file, or share a link without the password.
- 6
Step 6
Stop server, upload file, start server
Stop your Vintage Story server, upload serverconfig.json to its root directory using the file manager or FTP/SFTP, for example, and start it again. If the server is running during the upload, it will overwrite the file the next time it stops.
Setup
File location & usage
Two ways to get the config onto a server: upload it yourself or apply it directly in our panel.
The manual method
Upload yourself
- 1
Download file
Download the generated serverconfig.json using the button above.
- 2
Upload via file manager or FTP/SFTP
On a self-hosted server, place it in
~/.config/VintagestoryData/serverconfig.json(Linux) or%APPDATA%\VintagestoryData\serverconfig.json(Windows); at ZAP-Hosting, inserverconfig.json. - 3
Apply changes
Vintage Story writes serverconfig.json when it shuts down — stop your server BEFORE uploading, then restart it so your changes are not overwritten.
The ZAP-Hosting way
Apply in the panel, no FTP needed
Rent a Vintage Story server from us: download the file, place it in the file manager, and restart. The server overwrites some values with the startup parameters on every start; you set those directly in the panel.
- File Manager directly in your browser
- No FTP client required
- Online in 60 seconds
More tools
More tools for your server config
Server Configuration Generator
Describe your enshrouded_server.json settings to the ZapX AI Agent in your own words, or set each option manually—with a live preview for your rented Enshrouded server.
Built by Florian Galz
Server Configuration Generator
Describe ServerHostSettings.json and ServerGameSettings.json to the ZapX AI Agent in your own words or set each option manually — with a live preview for your rented V Rising server.
Built by Florian Galz
Server Configuration Generator
Describe your ServerConfig.json settings to the ZapX AI Agent in your own words, or set each option manually—with a live preview for your rented Core Keeper server.
Built by Florian Galz
Compare text online (Diff Checker)
Compare text online: Compare two texts, configs, or code versions, see differences line by line and word by word, and copy them as a Unified Diff. Runs entirely in your browser.
Built by Dimitri Heissler
JSON Formatter
Format, minify, and validate JSON with syntax highlighting, error messages, and downloads, entirely in your browser.
Built by Jakub Martyniak
Password Generator
Generate strong, random passwords directly in your browser — nothing is stored or transmitted.
Built by Rugile Rutkauskaite
FAQ
Frequently asked questions
File location, world generation, playstyles, privacy, and Easy Mode—briefly answered.
serverconfig.json is located in your Vintage Story server's root directory. You can view and edit it directly in the File Manager in the ZapX Customer Panel.
Vintage Story writes its current settings back to serverconfig.json when it shuts down. If you upload a new file while the server is running, it will be overwritten the next time the server stops. So follow this order: stop the server, upload the file, start the server.
Seed and playstyle are only read when a new world is created; changing them has no effect on an existing world. Which save is loaded is set by SaveFileLocation in the file, fixed to ./Saves/world.vcdbs in the downloaded file. A different world name therefore doesn't switch the world there. On a ZAP-Hosting server, however, the world name is the save file name in the Saves folder: a different name loads or creates a different world, while the previous one remains under its old name.
The generator offers five presets: Survive and Build (default), Wilderness Survival (hardcore), Exploration, Homo Sapiens and Creative Building. In the file, they appear as surviveandbuild, wildernesssurvival, exploration, homosapiens and creativebuilding in the WorldConfig object. Like the seed, the playstyle only applies to a newly generated world.
Set a server password, enable “Whitelist only” (OnlyWhitelisted), and turn off “List on public server list” (AdvertiseServer). Then only whitelisted players can join, they need the password, and the server won't appear in the public server list. You manage the whitelist on the server itself, not in the generator.
Describe the server you want in your own words, such as “a small whitelist server without PvP for a group of friends.” The AI suggests suitable settings and explains each change. You choose which suggestions to apply; nothing changes without your confirmation. Your server password is not sent to the AI.
The server password is not saved in share links and is masked in the form. A share link contains only the non-secret values you deliberately changed.
The generator is free and requires no sign-up: the form, Easy Mode, import, copy, download and sharing all work without an account. The serverconfig.json is generated directly in your browser. Only for Easy Mode suggestions are your description and the current values, without the server password, sent to the AI.
Any more questions?
Contact SupportGet your Vintage Story server online today
Rent your Vintage Story server now and apply this config directly in the panel.
No setup. No risk. Online in seconds.
