Installationsguide för Vintage Story-server

Den här guiden går igenom hur du ställer in och konfigurerar din Vintage Story dedikerade server som hostas hos Legion Hosting, inklusive första start, GPanel-variabler, versionshantering, serverkonfiguration, världsinställningar, anslutning av spelare och hantering av sparfiler. För modinstallation, se Modinstallation för Vintage Story. För admin-installation och kommandon, se Vintage Story Admin-kommandon.

Innan du börjar: Se till att din server är skapad i GPanel. Om du behöver hjälp med att hitta din servers IP-adress och port, se Hur du hittar din servers IP och port.

Första start

När du startar din Vintage Story-server för första gången från GPanel kommer servern automatiskt att ladda ner spelfilerna från den officiella Vintage Story-API:t och generera en standardvärld. Den här inledande starten kan ta flera minuter medan filer laddas ner och extraheras.

Logga in på GPanel och välj din Vintage Story-server.
Innan du startar, granska fliken Startup för att bekräfta din föredragna versionsgren (stable, unstable eller pre-release).
Klicka på Start på fliken Console. Bevaka konsolutdatan för förloppsmeddelanden medan servern laddar ner och installerar spelfiler.
När du ser ett meddelande som indikerar att servern lyssnar efter anslutningar är servern redo. En standardfil serverconfig.json genereras automatiskt.

Första starten tar längre tid än vanligt. Servern måste ladda ner hela Vintage Story-serverpaketet innan den kan starta. Efterföljande starter kommer att vara mycket snabbare om du inte ändrar versionen eller grenen.

GPanel-startvariabler

Centrala serverinställningar styrs genom fliken Startup i GPanel. Granska och justera dessa innan du startar din server.

Variabel	Standard	Beskrivning
`SERVER_PORT`	(tilldelad)	Spelporten som spelare använder för att ansluta. Den tilldelas automatiskt av GPanel -- kontrollera fliken Network för din tilldelade port.
`MAX_CLIENTS`	`16`	Maximalt antal samtidiga spelare. Kan ställas in upp till 256. Bör matcha din hostingplans resurser.
`FILES_BRANCH`	`stable`	Vilken utgivningsgren som ska användas. Alternativ: `stable`, `unstable` eller `pre`. Se avsnittet Versionshantering nedan för detaljer.
`RELEASE_VERSION`	`latest`	Den specifika versionen som ska installeras. Ställ in på `latest` för att alltid använda den nyaste utgåvan på din valda gren, eller ange ett specifikt versionsnummer (t.ex. `1.19.8`) för att låsa till den versionen.
`OPTIONS`	(tomt)	Ytterligare kommandoradsargument som skickas till serverprocessen vid start. Lämna tomt om du inte behöver specifika startflaggor.
`SQLITE_TMPDIR`	(auto)	Temporär katalog som används av SQLite för databasoperationer. Behöver vanligtvis inte ändras.

När du har uppdaterat startvariabler, starta om servern från GPanel för att ändringarna ska träda i kraft.

Versionshantering

Vintage Story erbjuder tre utgivningsgrenar. Ditt val av gren anges via startvariabeln FILES_BRANCH i GPanel.

Gren	Värde	Beskrivning
Stable	`stable`	Den rekommenderade grenen för de flesta servrar. Dessa utgåvor har testats grundligt och är de mest tillförlitliga för långsiktiga världar.
Unstable	`unstable`	Betautgåvor med nya funktioner och ändringar som fortfarande testas. Kan innehålla buggar. Använd den här om du vill ha tidig tillgång till nytt innehåll och accepterar viss instabilitet.
Pre-release	`pre`	Tidiga utvecklingsbyggen. Dessa är de minst testade och kan ha betydande problem. Rekommenderas endast för testsyften -- inte för produktionsservrar.

Låsa en specifik version

Som standard är RELEASE_VERSION inställd på latest, vilket innebär att servern laddar ner och installerar den nyaste versionen som är tillgänglig på din valda gren varje gång servern startar (om en nyare version finns tillgänglig). För att förhindra automatiska uppdateringar och låsa din server till en specifik version:

Gå till fliken Startup i GPanel.
Ändra RELEASE_VERSION från latest till det exakta versionsnummer du vill ha (t.ex. 1.19.8).
Starta om servern. Den kommer endast att använda den låsta versionen oavsett nyare utgåvor.

Modkompatibilitet: Om du kör mods rekommenderas det att låsa en specifik version. Speluppdateringar kan bryta modkompatibiliteten, och att uppdatera mitt under en spelomgång kan orsaka problem. Kontrollera att dina mods stöder målversionen innan du uppdaterar. Se Modinstallation för Vintage Story för detaljer.

Att byta gren kan kräva en världsåterställning. Att flytta mellan grenarna stable och unstable kan introducera ändringar i världsformatet. Säkerhetskopiera alltid din värld innan du byter gren. Om den nya versionen är inkompatibel med din befintliga värld kan du behöva starta en ny.

serverconfig.json

Den primära serverkonfigurationsfilen är serverconfig.json, som finns i serverns rotkatalog. Den här filen genereras automatiskt vid första start. Stoppa servern innan du redigerar den, starta sedan om för att ändringarna ska träda i kraft.

Stoppa servern från GPanel-fliken Console.
Öppna fliken Files och klicka på serverconfig.json för att redigera den.
Ändra de inställningar du behöver (se tabellen nedan).
Spara filen och starta servern.

Viktiga inställningar

Inställning	Exempelvärde	Beskrivning
`ServerName`	`"My Legion VS Server"`	Namnet som visas i serverbläddraren i spelet. Gör det beskrivande så att spelare kan hitta din server.
`WelcomeMessage`	`"Welcome to the server!"`	Meddelande som visas för spelare när de ansluter. Stöder grundläggande formatering.
`MaxClients`	`16`	Maximalt antal samtidiga spelare. Bör matcha startvariabeln `MAX_CLIENTS`.
`Password`	`"mysecretpass"`	Lösenord som krävs för att ansluta till servern. Lämna som en tom sträng (`""`) för en offentlig server.
`AllowPvP`	`true`	Ställ in på `true` för att aktivera strid spelare mot spelare, eller `false` för en server endast med PvE.
`SpawnRadius`	`50`	Radie (i block) runt världens spawnpunkt där nya spelare kan spawna. Ett större värde sprider ut spelare mer vid anslutning.
`MapSizeX`	`1024000`	Världens bredd i block. Standardvärdet skapar en mycket stor värld. Att minska detta begränsar hur långt spelare kan resa öster-väster.
`MapSizeZ`	`1024000`	Världens djup i block. Standardvärdet skapar en mycket stor värld. Att minska detta begränsar hur långt spelare kan resa norr-söder.
`WorldSeed`	`"myseed123"`	Seed som används för världsgenerering. Samma seed producerar samma värld. Lämna som en tom sträng för en slumpmässig seed.

Ett minimalt exempel på viktiga inställningar i serverconfig.json:

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

Filen måste vara giltig JSON. Se till att alla strängar är inneslutna i dubbla citattecken, att booleska värden är med små bokstäver (true/false) och att det inte finns några efterföljande kommatecken efter det sista objektet i ett objekt eller en array. Om servern inte startar efter redigering, kontrollera om det finns JSON-syntaxfel.

Världskonfiguration

Vintage Story genererar sin värld baserat på inställningar i serverconfig.json. Världsgenerering sker endast vid första start med en given värld -- att ändra genereringsinställningar efter att världen har skapats kommer inte att retroaktivt ändra befintlig terräng.

Inställningar för världsgenerering

WorldSeed: Bestämmer terränglayout, biomplacering och resursfördelning. Ställ in en specifik seed för att dela samma världslayout med andra, eller lämna den tom för en slumpmässigt genererad värld.
MapSizeX / MapSizeZ: Styr det maximala spelbara området. Mindre värden skapar en mer avgränsad värld och kan minska resursanvändningen. Spelare som når kanten av kartan kan inte resa längre i den riktningen.
WorldConfig: Objektet WorldConfig i serverconfig.json låter dig finjustera parametrar för världsgenerering såsom landformsskala, klimatmönster och geologiska egenskaper. Detta är avancerade inställningar -- standardvärdena fungerar bra för de flesta servrar.

Inställningar för världsgenerering är låsta efter skapande. Inställningar som WorldSeed, MapSizeX och MapSizeZ träder endast i kraft när världen först genereras. För att tillämpa nya genereringsinställningar måste du skapa en ny värld (se Hantering av sparfiler nedan).

Välja en seed

Seeden kan vara vilken textsträng eller siffra som helst. Spelare i Vintage Story-communityn delar seeds för intressanta världslayouter. Om du vill ha en specifik typ av terräng eller spawnplats, sök i Vintage Story-forumen eller community-webbplatser efter rekommenderade seeds.

Hur du ansluter

Spelare ansluter till din Vintage Story-server via flerspelarmenyn i spelet.

Direktanslutning

Starta Vintage Story och klicka på Multiplayer från huvudmenyn.
Klicka på Direct Connect.
Ange din servers IP-adress och spelport i formatet:
```
your.server.ip:port
```
Kontrollera fliken Network i GPanel för din tilldelade IP och port.
Klicka på Connect. Om servern har ett lösenord, ange det när du uppmanas.

Serverbläddrare

Starta Vintage Story och klicka på Multiplayer från huvudmenyn.
Serverbläddraren laddar en lista över offentliga servrar. Använd sökfältet för att hitta din server via namn (värdet ServerName från serverconfig.json).
Klicka på din server i listan och klicka på Join.

Visas inte servern i bläddraren? Serverbläddraren kan ta flera minuter på sig att indexera en nyligen startad server. Använd Direktanslutning för omedelbar åtkomst. Bekräfta även att du inte har ställt in ett lösenord -- lösenordsskyddade servrar kanske inte visas i den offentliga bläddraren beroende på serverinställningar.

Hantering av sparfiler

Vintage Story-världsdata lagras på din server och sparas automatiskt under spelandet.

Plats för världsdata

Sparfiler för världar lagras i katalogen data/ på din server. Den exakta sökvägen beror på ditt världsnamn. Du kan komma åt dessa filer via GPanel-fliken Files eller via SFTP.

Säkerhetskopiera din värld

Stoppa servern för att säkerställa en ren säkerhetskopia (inga filer skrivs mitt i en sparning).
Anslut till din server via SFTP. Se Hur du laddar upp filer via SFTP för anslutningsinstruktioner.
Ladda ner hela katalogen data/ till din lokala dator.
Lagra säkerhetskopian på en säker plats. Överväg att behålla flera daterade säkerhetskopior ifall du behöver återgå till en specifik tidpunkt.

Regelbundna säkerhetskopior rekommenderas starkt. Världskorruption, oavsiktlig griefing eller misslyckade moduppdateringar kan alla resultera i dataförlust. Säkerhetskopiera din värld innan du gör några betydande ändringar såsom att uppdatera spelversionen, lägga till eller ta bort mods, eller ändra världsinställningar.

Återställa världen

För att starta en helt ny värld:

Stoppa servern från GPanel-fliken Console.
Säkerhetskopiera den befintliga världsdatan om du vill behålla den (se ovan).
Navigera till katalogen data/ i GPanel-filhanteraren och ta bort sparfilerna för världen.
Uppdatera valfritt WorldSeed i serverconfig.json för att generera en annan världslayout.
Starta servern. En ny värld genereras från grunden med dina aktuella konfigurationsinställningar.

Att ta bort världsfiler är permanent. När de väl tagits bort kan världen inte återställas om du inte har en säkerhetskopia. Ladda alltid ner en säkerhetskopia innan du utför en världsåterställning.

Relaterade artiklar

Behöver du hjälp?

Om du stöter på ett problem som inte tas upp i den här guiden, öppna ett supportärende och inkludera din servers IP-adress, en beskrivning av problemet och eventuell relevant konsolutdata från GPanel.

Installationsguide för Vintage Story-server - Hjälpcentral

Support

Kategorier

Installationsguide för Vintage Story-server