Vintage Story-server opzetten: mods, wereldinstellingen en RAM

Een Vintage Story-server zet je op met één bestand en een paar commando's. In serverconfig.json staan de naam, de poort (standaard 42420), het maximum aantal spelers (standaard 16) en een eventueel wachtwoord. De wereld kies je met een speelstijl-preset en pas je later aan met /worldconfig. Mods zijn .zip-bestanden in de map Mods, en spelers halen ze bij het joinen automatisch binnen. Voor geheugen rekent de officiële wiki met 1 GB plus 300 MB per speler: 2 GB voor drie spelers, 4 GB voor een man of tien. De actuele stabiele versie is 1.22.7.

Een dedicated server is er voor als jij er niet bent

Samen spelen kan ook zonder aparte server: open je wereld en kies Open to LAN of Open to Internet. Dat laatste probeert via UPnP een poort op je router te openen; volgens de makers werkt dat in ongeveer 60 procent van de gevallen meteen. Anders moet je zelf poort 42420 (TCP én UDP) doorsturen. En de wereld is alleen bereikbaar zolang jouw spel openstaat.

Een dedicated server draait los van jouw pc: je vrienden bouwen door als jij slaapt, en je kunt meer spelers kwijt dan een spel-pc ernaast aankan. Eén nuance: PassTimeWhenEmpty staat standaard uit, dus zonder spelers staat de kalender stil. Wil je dat de seizoenen doorlopen terwijl niemand online is, zet het dan op true.

Wanneer niet: speel je altijd met z'n tweeën of drieën tegelijk en werkt Open to Internet bij jou? Dan heb je geen server nodig.

serverconfig.json: eerst stoppen, dan aanpassen

Bij ons staat het bestand in data/serverconfig.json, via het tabblad Files in het paneel. De wiki zegt het duidelijk: stop de server voordat je het bewerkt, en wijzigingen gelden pas na een herstart. Liever geen JSON? Veel velden zet je ook live met /serverconfig in de console. De belangrijkste velden, met standaardwaarden:

"ServerName": "Vintage Story Server",
"Port": 42420,
"MaxClients": 16,
"Password": null,
"AdvertiseServer": false,
"WhitelistMode": 0,
"PassTimeWhenEmpty": false,
"WorldConfig": {
  "SaveFileLocation": ".../Saves/default.vcdbs",
  "WorldName": "A new world",
  "PlayStyle": "surviveandbuild"
}

• ServerName: 4 tot 80 tekens, verplicht als je in de publieke serverlijst wilt.
• MaxClients: hogere waarden kosten meer RAM en CPU.
• Password: null betekent geen wachtwoord.
• AdvertiseServer: sinds 1.20 standaard uit: je server staat niet in de publieke lijst.
• WhitelistMode: 0 = standaard, 1 = uit, 2 = aan. Standaard betekent sinds 1.20: aan op een dedicated server. De klassieke reden dat vrienden er niet in komen.
• MapSizeX en MapSizeZ: breedte en lengte, standaard 1.024.000 blokken; MapSizeY is de hoogte (256).
• WorldConfig: SaveFileLocation wijst naar het wereldbestand (.vcdbs) dat bij de start wordt geladen of aangemaakt; WorldName en PlayStyle gelden alleen voor een nieuwe wereld.

Let op bij een gehoste server: de startregel geeft --port en --maxclients mee, en die overschrijven wat in het bestand staat. De poort krijg je van het paneel, en het aantal spelers pas je aan via de startup-variabele Max Clients.

Kies de speelstijl vóór de eerste start

Wereldinstellingen in serverconfig.json werken alleen zolang de wereld nog niet bestaat. Er zijn vijf presets:

• Standard (surviveandbuild): de normale survivalervaring, en niet bepaald beginnersvriendelijk.
• Exploration (exploration): geen temporal storms, je houdt je inventaris bij doodgaan en wezens vallen pas aan als je ze raakt. Een goede keus voor nieuwe spelers.
• Wilderness Survival (wildernesssurvival): geen kaart, instortende grond en rots, en 50 procent sterkere wezens.
• Homo sapiens (homosapiens): geen lore en geen temporal stability; je bent de eerste mens op de planeet.
• Creative Building (creativebuilding): plat land, vliegen en onbeperkt blokken.

De makkelijkste route volgens de wiki: maak de wereld in singleplayer via Customize, stop de server en upload het .vcdbs-bestand naar data/Saves. Hernoem het naar default.vcdbs of laat SaveFileLocation ernaar wijzen.

Daarna verander je veel instellingen live met /worldconfig naam waarde (hoofdlettergevoelig, herstart erna). De bekendste:

• temporalStorms: off, veryrare, rare, sometimes (standaard, ongeveer elke 10 tot 20 speldagen), often of veryoften.
• deathPunishment: drop (standaard) of keep.
• blockGravity: sandgravel (standaard) of sandgravelsoil, plus caveIns on of off voor instortend gesteente.
• creatureHostility: aggressive, passive of off.

Niet alles kan achteraf: startingClimate, graceTimer, worldClimate, worldWidth en worldLength liggen vast zodra de wereld is aangemaakt.

Mods: .zip in de map, iedereen op dezelfde versie

De officiële bron is de ModDB op mods.vintagestory.at; kijk bij elke mod voor welke gameversie hij is gemaakt. Er zijn drie soorten: content mods (JSON zonder C#: blokken, items, wezens), code mods (C#, voor nieuwe systemen) en theme packs (alleen uiterlijk). Elke mod geeft ook aan waar hij draait: Server, Client of Universal.

1. Stop de server en zet de .zip in data/Mods. Niet uitpakken.
2. Start de server weer. Je kunt ook vanuit de console installeren met /moddb install modid.
3. Spelers accepteren bij het joinen de modlijst; het spel downloadt dan de Server- en Universal-mods in een eigen map (ModsByServer). Client-mods zet een speler zelf.

De valkuil zit in versies. De gameversie van spelers moet gelijk zijn aan die van de server, en na een game-update werk je ook je mods bij. Maak een back-up voordat je mods toevoegt of verwijdert: na het weghalen van een mod kunnen blokken in je wereld kapotgaan.

Beheer: jezelf admin maken en vrienden binnenlaten

Typ deze in de console van het paneel, of als admin in de chat:

• /op JouwNaam: jezelf admin maken (hetzelfde als /player JouwNaam role admin).
• /player Vriend whitelist on: een speler op de whitelist zetten, ook jezelf.
• /player Vriend role suplayer: de rol van een speler wijzigen.
• /serverconfig password geheim: wachtwoord instellen; /serverconfig nopassword haalt het weg.
• /serverconfig advertise 0: niet in de publieke lijst.
• /genbackup: volledige kopie van de wereld.
• /stop: netjes afsluiten.

De whitelist geldt meteen, zonder herstart. Nieuwe spelers krijgen de rol uit DefaultRoleCode (standaard suplayer). Zet die op suvisitor als nieuwkomers eerst alleen mogen rondkijken en chatten.

Versie 1.22.7 en veilig updaten

Op 23 september 2026 is 1.22.7 de stabiele versie. De wiki is streng over updaten: verwijder eerst de oude installatiebestanden, maar nooit je datamap, anders krijg je onvoorspelbaar gedrag. In ons paneel staan versietak (stable, unstable of pre) en versie (standaard latest) als startup-variabelen, zodat een herinstallatie de nieuwste versie binnenhaalt. Maak vooraf een back-up, werk je mods bij en laat iedereen dezelfde versie spelen. Merk je elke vijf minuten een korte hapering? Dat is waarschijnlijk de autosave, standaard elke 300 seconden.

Hoeveel RAM: de officiële rekensom

De wiki geeft een voorzichtige schatting voor een survivalwereld waarin spelers uitwaaieren: 1 GB basis plus 300 MB per speler, vier threads, en 1 GHz plus 100 MHz kloksnelheid per speler. Tel spelers die tegelijk online zijn, niet de lengte van je whitelist:

Daar komen mods en kijkafstand bij. MaxChunkRadius (standaard 12) bepaalt hoe ver spelers mogen laden, en hoger kost meer RAM. Draai je een flinke modlijst, neem dan een pakket groter. Eerlijk is ook: de wiki noemt de rekensom conservatief, en met tuning kan het lager. En loopt je server tegen de processor aan in plaats van het geheugen, dan helpt extra RAM niet. Met /stats zie je wat de server echt gebruikt.

Voor grotere groepen lopen de Vintage Story-pakketten door tot Chief met 16 GB voor € 24,00 per maand, met DDoS-bescherming en maandelijks opzegbaar. Kies de locatie dicht bij je spelers (Hengelo, Frankfurt, Warschau of Beauharnois): volgens de wiki geeft spelen vanaf een ander continent vertraging. Bestellen en starten staat in Hoe start ik een Vintage Story-server?, het dagelijkse werk in je server beheren via het paneel.

Veelgestelde vragen

Welke poort gebruikt een Vintage Story-server?

Standaard poort 42420. Thuis stuur je die door voor TCP en, sinds versie 1.20, ook UDP. Bij een gehoste server krijg je de poort van het paneel.

Hoeveel RAM heeft een Vintage Story-server nodig?

De officiële wiki rekent met 1 GB basis plus 300 MB per speler die tegelijk online is. Dat is 2 GB voor drie spelers, 4 GB voor ongeveer tien en 6 GB voor zestien. Mods en een grotere kijkafstand vragen meer.

Waarom kunnen mijn vrienden niet joinen op mijn Vintage Story-server?

Meestal door de whitelist: sinds versie 1.20 staat die op dedicated servers standaard aan. Zet elke speler erop met /player naam whitelist on in de console. Controleer daarnaast of iedereen dezelfde gameversie speelt als de server.

Hoe maak ik mezelf admin op een Vintage Story-server?

Typ /op jouwnaam in de serverconsole; dat is hetzelfde als /player jouwnaam role admin. Zonder console zet je "StartupCommands": "/op jouwnaam" in serverconfig.json en herstart je.

Verder lezen

• VPS of gameserver: wat heb je echt nodig?
• Serverlocatie en ping: waarom Nederland een sterk knooppunt is