Skip to content

How to configure your Vintage Story server

Identify the serverconfig.json settings worth modifying, update passwords, set world defaults, and apply safe text editing practices.

Updated July 24, 2026
Vintage Story

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:

{
  "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.

Tuning the World with /worldconfig

World rules live in the save itself and are changed with admin console commands, then a restart:

> /worldconfig deathPunishment keep
> /worldconfig temporalStorms rare
> /worldconfig temporalStability false
> /worldconfig creatureHostility passive
> /worldconfig graceTimer 10
> /worldconfig daysPerMonth 12

deathPunishment keep disables item drop on death, graceTimer delays the first temporal storm by that many days, and higher daysPerMonth slows the seasons. Run /worldconfig alone to list every option the server supports.

Made with 💜 by GameServerKings