Getting started with your Vintage Story server
Updated July 02, 2026
Vintage Story Vintage Story Configuration
This guide covers the configuration files and key settings for your Vintage Story server. For first boot and connecting, see Getting Started.
The main config is at the data folder root: serverconfig.json. Structure:
JSON
{
"ServerName": "My GSK Vintage Story Server",
"ServerUrl": "",
"ServerDescription": "A vintage survival adventure",
"MaxClients": 16,
"Port": 42420,
"Password": "",
"AdvertiseServer": true,
"WhitelistMode": false,
"Whitelist": [],
"OnlinePlayers": 0,
"MaxChunkRadius": 14,
"MOTD": "Welcome to the server!",
"WorldConfig": {
"WorldName": "Default",
"Seed": "12345",
"WorldType": "standard",
"PlayStyle": "surviveandbuild",
"PlayStyleLangCode": "surviveandbuild",
"AllowCheats": false,
"ServerSpawnPos": null,
"WorldConfiguration": {
"gameMode": "survival",
"deathPunishment": "drop",
"playerlives": "0",
"graceTimer": "3",
"loreContent": "true",
"harshWinters": "true",
"daysPerMonth": "9",
"playerHealthPoints": "15",
"creatureHostility": "aggressive",
"creatureStrength": "1",
"playerHungerSpeed": "1",
"playerHealthRegenSpeed": "1",
"foodSpoilSpeed": "1",
"saplingGrowthSpeed": "1",
"miningSpeed": "1",
"globalDepositSpawnRate": "1",
"microblockChiseling": "all",
"deathPunishment": "drop"
}
}
}| Setting | Notes |
|---|---|
| MaxClients | Slot count |
| AdvertiseServer | True to appear in public server list |
| MaxChunkRadius | Chunks loaded per player (12-14 is sane) |
| PlayStyle | surviveandbuild, exploration, homosapiens, wildernesssurvival |
| harshWinters | Cold-weather mortality challenge |
| creatureHostility | passive, defensive, aggressive |
Restart after editing.
What to Read Next
- Getting Started for first boot and the basics
- Vintage Story Admin Setup
- Installing Mods on Vintage Story