Vintage Story Server Installatiehandleiding

Deze handleiding behandelt het instellen en configureren van je Vintage Story dedicated server gehost bij Legion Hosting, inclusief de eerste opstart, GPanel variabelen, versiebeheer, serverconfiguratie, wereldinstellingen, spelers verbinden en opslagbeheer. Voor mod-installatie, zie Vintage Story Mod Installatie. Voor admin-instellingen en commando's, zie Vintage Story Admin Commando's.

Voordat je begint: Zorg ervoor dat je server is aangemaakt in GPanel. Als je hulp nodig hebt bij het vinden van het IP-adres en de port van je server, zie Hoe vind je het IP-adres en de port van je server.

Eerste opstart

Wanneer je je Vintage Story server voor de eerste keer start vanuit GPanel, zal de server automatisch de gamebestanden downloaden via de officiële Vintage Story API en een standaardwereld genereren. Deze eerste opstart kan enkele minuten duren terwijl bestanden worden gedownload en uitgepakt.

Log in op GPanel en selecteer je Vintage Story server.
Controleer voordat je start het tabblad Startup om je gewenste versietak te bevestigen (stable, unstable of pre-release).
Klik op Start op het tabblad Console. Bekijk de console-uitvoer voor voortgangsberichten terwijl de server gamebestanden downloadt en installeert.
Zodra je een bericht ziet dat de server luistert naar verbindingen, is de server gereed. Een standaard serverconfig.json bestand wordt automatisch gegenereerd.

De eerste opstart duurt langer dan normaal. De server moet het volledige Vintage Story serverpakket downloaden voordat deze kan starten. Volgende opstarten zullen veel sneller zijn, tenzij je de versie of tak wijzigt.

GPanel Opstartvariabelen

De belangrijkste serverinstellingen worden beheerd via het tabblad Startup in GPanel. Controleer en pas deze aan voordat je de server start.

Variabele	Standaard	Beschrijving
`SERVER_PORT`	(toegewezen)	De gameport die spelers gebruiken om te verbinden. Deze wordt automatisch toegewezen door GPanel -- controleer het tabblad Network voor je toegewezen port.
`MAX_CLIENTS`	`16`	Maximaal aantal gelijktijdige spelers. Kan worden ingesteld tot 256. Moet overeenkomen met de resources van je hostingpakket.
`FILES_BRANCH`	`stable`	Welke releasetak gebruikt wordt. Opties: `stable`, `unstable` of `pre`. Zie het gedeelte Versiebeheer hieronder voor details.
`RELEASE_VERSION`	`latest`	De specifieke versie om te installeren. Stel in op `latest` om altijd de nieuwste release op je gekozen tak te gebruiken, of voer een specifiek versienummer in (bijv. `1.19.8`) om die versie vast te zetten.
`OPTIONS`	(leeg)	Extra opdrachtregelargumenten die bij het opstarten aan het serverproces worden doorgegeven. Laat dit leeg tenzij je specifieke opstartvlaggen nodig hebt.
`SQLITE_TMPDIR`	(auto)	Tijdelijke map die door SQLite wordt gebruikt voor databasebewerkingen. Hoeft normaal gesproken niet te worden gewijzigd.

Na het bijwerken van opstartvariabelen, herstart de server vanuit GPanel om de wijzigingen door te voeren.

Versiebeheer

Vintage Story biedt drie releasetakken. Je keuze van tak wordt ingesteld via de FILES_BRANCH opstartvariabele in GPanel.

Tak	Waarde	Beschrijving
Stable	`stable`	De aanbevolen tak voor de meeste servers. Deze releases zijn grondig getest en zijn het meest betrouwbaar voor langlopende werelden.
Unstable	`unstable`	Bètareleases met nieuwe functies en wijzigingen die nog worden getest. Kunnen bugs bevatten. Gebruik dit als je vroege toegang wilt tot nieuwe content en enige instabiliteit accepteert.
Pre-release	`pre`	Vroege ontwikkelingsbuilds. Deze zijn het minst getest en kunnen aanzienlijke problemen hebben. Alleen aanbevolen voor testdoeleinden -- niet voor productieservers.

Een specifieke versie vastzetten

Standaard is RELEASE_VERSION ingesteld op latest, wat betekent dat de server de nieuwste beschikbare versie op je gekozen tak downloadt en installeert telkens wanneer de server start (als er een nieuwere versie beschikbaar is). Om automatische updates te voorkomen en je server op een specifieke versie te vergrendelen:

Ga naar het tabblad Startup in GPanel.
Wijzig RELEASE_VERSION van latest naar het exacte versienummer dat je wilt (bijv. 1.19.8).
Herstart de server. Deze zal alleen de vastgezette versie gebruiken, ongeacht nieuwere releases.

Mod-compatibiliteit: Als je mods gebruikt, wordt het aanbevolen om een specifieke versie vast te zetten. Game-updates kunnen de compatibiliteit van mods verbreken, en updaten tijdens een speelsessie kan problemen veroorzaken. Controleer of je mods de doelversie ondersteunen voordat je update. Zie Vintage Story Mod Installatie voor details.

Wisselen van tak kan een wereldreset vereisen. Het wisselen tussen stable- en unstable-takken kan wijzigingen in het wereldformaat introduceren. Maak altijd een back-up van je wereld voordat je van tak wisselt. Als de nieuwe versie niet compatibel is met je bestaande wereld, moet je mogelijk een nieuwe beginnen.

serverconfig.json

Het primaire serverconfiguratiebstand is serverconfig.json, te vinden in de hoofdmap van de server. Dit bestand wordt automatisch gegenereerd bij de eerste opstart. Stop de server voordat je het bewerkt en herstart daarna om de wijzigingen door te voeren.

Stop de server via het GPanel tabblad Console.
Open het tabblad Files en klik op serverconfig.json om het te bewerken.
Pas de instellingen aan die je nodig hebt (zie de tabel hieronder).
Sla het bestand op en start de server.

Belangrijke instellingen

Instelling	Voorbeeldwaarde	Beschrijving
`ServerName`	`"My Legion VS Server"`	De naam die wordt weergegeven in de in-game serverbrowser. Maak deze beschrijvend zodat spelers je server kunnen vinden.
`WelcomeMessage`	`"Welcome to the server!"`	Bericht dat aan spelers wordt getoond wanneer ze deelnemen. Ondersteunt basisopmaak.
`MaxClients`	`16`	Maximaal aantal gelijktijdige spelers. Moet overeenkomen met de `MAX_CLIENTS` opstartvariabele.
`Password`	`"mysecretpass"`	Wachtwoord vereist om de server te betreden. Laat als lege string (`""`) voor een openbare server.
`AllowPvP`	`true`	Stel in op `true` om speler-tegen-speler gevechten in te schakelen, of `false` voor een PvE-only server.
`SpawnRadius`	`50`	Straal (in blokken) rond het wereldspawnpunt waar nieuwe spelers kunnen spawnen. Een hogere waarde verspreidt spelers meer bij het joinen.
`MapSizeX`	`1024000`	Wereldbreedte in blokken. De standaardwaarde creëert een zeer grote wereld. Dit verlagen beperkt hoe ver spelers oost-west kunnen reizen.
`MapSizeZ`	`1024000`	Werelddiepte in blokken. De standaardwaarde creëert een zeer grote wereld. Dit verlagen beperkt hoe ver spelers noord-zuid kunnen reizen.
`WorldSeed`	`"myseed123"`	Seed gebruikt voor wereldgeneratie. Dezelfde seed produceert dezelfde wereld. Laat als lege string voor een willekeurige seed.

Een minimaal voorbeeld van belangrijke instellingen in serverconfig.json:

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

Het bestand moet geldige JSON zijn. Zorg ervoor dat alle strings tussen dubbele aanhalingstekens staan, booleans in kleine letters zijn (true/false), en er geen komma's na het laatste item in een object of array staan. Als de server niet start na het bewerken, controleer dan op JSON-syntaxfouten.

Wereldconfiguratie

Vintage Story genereert de wereld op basis van instellingen in serverconfig.json. Wereldgeneratie vindt alleen plaats bij de eerste opstart met een gegeven wereld -- het wijzigen van generatie-instellingen nadat de wereld is aangemaakt, zal het bestaande terrein niet met terugwerkende kracht wijzigen.

Wereldgeneratie-instellingen

WorldSeed: Bepaalt de terreinindeling, bioomplaatsing en grondstofverdeling. Stel een specifieke seed in om dezelfde wereldindeling met anderen te delen, of laat het leeg voor een willekeurig gegenereerde wereld.
MapSizeX / MapSizeZ: Bepalen het maximale speelbare gebied. Kleinere waarden creëren een meer afgebakende wereld en kunnen het resourcegebruik verminderen. Spelers die de rand van de kaart bereiken, kunnen niet verder reizen in die richting.
WorldConfig: Het WorldConfig object binnen serverconfig.json stelt je in staat om wereldgeneratieparameters fijn af te stemmen, zoals landvormschaal, klimaatpatronen en geologische kenmerken. Dit zijn geavanceerde instellingen -- de standaardwaarden werken goed voor de meeste servers.

Wereldgeneratie-instellingen zijn vergrendeld na aanmaak. Instellingen zoals WorldSeed, MapSizeX en MapSizeZ worden alleen van kracht wanneer de wereld voor het eerst wordt gegenereerd. Om nieuwe generatie-instellingen toe te passen, moet je een nieuwe wereld aanmaken (zie Opslagbeheer hieronder).

Een seed kiezen

De seed kan elke tekststring of elk getal zijn. Spelers in de Vintage Story community delen seeds voor interessante wereldindelingen. Als je een specifiek type terrein of spawnlocatie wilt, zoek dan op de Vintage Story forums of communitysites naar aanbevolen seeds.

Verbinding maken

Spelers verbinden met je Vintage Story server via het in-game multiplayermenu.

Directe verbinding

Start Vintage Story en klik op Multiplayer vanuit het hoofdmenu.
Klik op Direct Connect.
Voer het IP-adres en de gameport van je server in het volgende formaat in:
```
your.server.ip:port
```
Controleer het tabblad Network in GPanel voor je toegewezen IP en port.
Klik op Connect. Als de server een wachtwoord heeft, voer dit in wanneer daarom wordt gevraagd.

Serverbrowser

Start Vintage Story en klik op Multiplayer vanuit het hoofdmenu.
De serverbrowser laadt een lijst met openbare servers. Gebruik de zoekbalk om je server op naam te vinden (de ServerName waarde uit serverconfig.json).
Klik op je server in de lijst en klik op Join.

Server verschijnt niet in de browser? De serverbrowser kan enkele minuten nodig hebben om een nieuw gestarte server te indexeren. Gebruik Direct Connect voor directe toegang. Controleer ook of je geen wachtwoord hebt ingesteld -- met een wachtwoord beveiligde servers verschijnen mogelijk niet in de openbare browser, afhankelijk van de serverinstellingen.

Opslagbeheer

Vintage Story wereldgegevens worden opgeslagen op je server en automatisch bewaard tijdens het spelen.

Locatie van wereldgegevens

Wereldopslagbestanden worden opgeslagen in de map data/ op je server. Het exacte pad hangt af van je wereldnaam. Je kunt deze bestanden benaderen via het GPanel tabblad Files of via SFTP.

Een back-up maken van je wereld

Stop de server om een schone back-up te garanderen (geen bestanden die midden in een opslag worden geschreven).
Verbind met je server via SFTP. Zie Bestanden uploaden via SFTP voor verbindingsinstructies.
Download de volledige map data/ naar je lokale machine.
Bewaar de back-up op een veilige locatie. Overweeg om meerdere gedateerde back-ups te bewaren voor het geval je naar een specifiek punt moet terugkeren.

Regelmatige back-ups worden sterk aanbevolen. Wereldcorruptie, onbedoeld griefing of mislukte mod-updates kunnen allemaal leiden tot gegevensverlies. Maak een back-up van je wereld voordat je significante wijzigingen aanbrengt, zoals het updaten van de gameversie, het toevoegen of verwijderen van mods, of het wijzigen van wereldinstellingen.

De wereld resetten

Om een volledig nieuwe wereld te starten:

Stop de server via het GPanel tabblad Console.
Maak een back-up van de bestaande wereldgegevens als je deze wilt bewaren (zie hierboven).
Navigeer naar de map data/ in de GPanel bestandsbeheerder en verwijder de wereldopslagbestanden.
Werk optioneel de WorldSeed bij in serverconfig.json om een andere wereldindeling te genereren.
Start de server. Een nieuwe wereld wordt vanaf nul gegenereerd met je huidige configuratie-instellingen.

Het verwijderen van wereldbestanden is permanent. Eenmaal verwijderd kan de wereld niet worden hersteld, tenzij je een back-up hebt. Download altijd een back-up voordat je een wereldreset uitvoert.

Hulp nodig?

Als je een probleem tegenkomt dat niet in deze handleiding wordt behandeld, open een supportticket en vermeld het IP-adres van je server, een beschrijving van het probleem en relevante console-uitvoer uit GPanel.

Vintage Story Server Installatiehandleiding - Kennisbank

Ondersteuning

Categorieën

Vintage Story Server Installatiehandleiding