Vintage Story Server-Einrichtungsanleitung

Diese Anleitung beschreibt die Einrichtung und Konfiguration Ihres bei Legion Hosting gehosteten Vintage Story Dedicated Servers, einschließlich Erststart, GPanel-Variablen, Versionsverwaltung, Serverkonfiguration, Welteinstellungen, Spielerverbindung und Speicherverwaltung. Für die Mod-Installation siehe Vintage Story Mod-Installation. Für Admin-Einrichtung und Befehle siehe Vintage Story Admin-Befehle.

Bevor Sie beginnen: Stellen Sie sicher, dass Ihr Server in GPanel erstellt wurde. Wenn Sie Hilfe beim Finden der IP-Adresse und des Ports Ihres Servers benötigen, siehe So finden Sie Ihre Server-IP und Ihren Port.

Erster Start

Wenn Sie Ihren Vintage Story Server zum ersten Mal über GPanel starten, lädt der Server automatisch die Spieldateien von der offiziellen Vintage Story API herunter und generiert eine Standardwelt. Dieser erste Start kann einige Minuten dauern, während die Dateien heruntergeladen und entpackt werden.

Melden Sie sich bei GPanel an und wählen Sie Ihren Vintage Story Server aus.
Überprüfen Sie vor dem Start den Tab Startup, um Ihren bevorzugten Versionszweig (stable, unstable oder pre-release) zu bestätigen.
Klicken Sie auf Start im Tab Console. Beobachten Sie die Konsolenausgabe für Fortschrittsmeldungen, während der Server die Spieldateien herunterlädt und installiert.
Sobald eine Meldung erscheint, die anzeigt, dass der Server auf Verbindungen wartet, ist der Server bereit. Eine Standard-serverconfig.json-Datei wird automatisch generiert.

Der erste Start dauert länger als üblich. Der Server muss das vollständige Vintage Story Server-Paket herunterladen, bevor er starten kann. Nachfolgende Starts sind deutlich schneller, es sei denn, Sie ändern die Version oder den Zweig.

GPanel-Startvariablen

Die wichtigsten Servereinstellungen werden über den Tab Startup in GPanel gesteuert. Überprüfen und passen Sie diese an, bevor Sie Ihren Server starten.

Variable	Standard	Beschreibung
`SERVER_PORT`	(zugewiesen)	Der Spielport, den Spieler zum Verbinden verwenden. Dieser wird automatisch von GPanel zugewiesen – überprüfen Sie den Tab Network für Ihren zugewiesenen Port.
`MAX_CLIENTS`	`16`	Maximale Anzahl gleichzeitiger Spieler. Kann auf bis zu 256 eingestellt werden. Sollte den Ressourcen Ihres Hosting-Plans entsprechen.
`FILES_BRANCH`	`stable`	Welcher Versionszweig verwendet werden soll. Optionen: `stable`, `unstable` oder `pre`. Siehe den Abschnitt Versionsverwaltung unten für Details.
`RELEASE_VERSION`	`latest`	Die spezifische zu installierende Version. Setzen Sie auf `latest`, um immer die neueste Version Ihres gewählten Zweigs zu verwenden, oder geben Sie eine bestimmte Versionsnummer ein (z. B. `1.19.8`), um diese Version zu fixieren.
`OPTIONS`	(leer)	Zusätzliche Befehlszeilenargumente, die beim Start an den Serverprozess übergeben werden. Lassen Sie dieses Feld leer, es sei denn, Sie benötigen bestimmte Start-Flags.
`SQLITE_TMPDIR`	(auto)	Temporäres Verzeichnis, das von SQLite für Datenbankoperationen verwendet wird. Muss in der Regel nicht geändert werden.

Nach dem Aktualisieren der Startvariablen starten Sie den Server über GPanel neu, damit die Änderungen wirksam werden.

Versionsverwaltung

Vintage Story bietet drei Versionszweige. Ihre Wahl des Zweigs wird über die Startvariable FILES_BRANCH in GPanel festgelegt.

Zweig	Wert	Beschreibung
Stable	`stable`	Der empfohlene Zweig für die meisten Server. Diese Versionen wurden gründlich getestet und sind am zuverlässigsten für langfristige Welten.
Unstable	`unstable`	Beta-Versionen mit neuen Funktionen und Änderungen, die noch getestet werden. Können Fehler enthalten. Verwenden Sie dies, wenn Sie frühzeitigen Zugang zu neuen Inhalten wünschen und eine gewisse Instabilität akzeptieren.
Pre-release	`pre`	Frühe Entwicklungs-Builds. Diese sind am wenigsten getestet und können erhebliche Probleme aufweisen. Nur für Testzwecke empfohlen – nicht für Produktionsserver.

Eine bestimmte Version fixieren

Standardmäßig ist RELEASE_VERSION auf latest gesetzt, was bedeutet, dass der Server bei jedem Start die neueste verfügbare Version Ihres gewählten Zweigs herunterlädt und installiert (wenn eine neuere Version verfügbar ist). Um automatische Updates zu verhindern und Ihren Server auf eine bestimmte Version zu fixieren:

Gehen Sie zum Tab Startup in GPanel.
Ändern Sie RELEASE_VERSION von latest auf die exakte gewünschte Versionsnummer (z. B. 1.19.8).
Starten Sie den Server neu. Er wird nur die fixierte Version verwenden, unabhängig von neueren Veröffentlichungen.

Mod-Kompatibilität: Wenn Sie Mods verwenden, wird die Fixierung auf eine bestimmte Version empfohlen. Spielupdates können die Mod-Kompatibilität beeinträchtigen, und ein Update während des Spielverlaufs kann Probleme verursachen. Überprüfen Sie, ob Ihre Mods die Zielversion unterstützen, bevor Sie aktualisieren. Siehe Vintage Story Mod-Installation für Details.

Ein Wechsel des Zweigs kann einen Welt-Reset erfordern. Der Wechsel zwischen Stable- und Unstable-Zweigen kann Änderungen am Weltformat mit sich bringen. Sichern Sie immer Ihre Welt, bevor Sie den Zweig wechseln. Wenn die neue Version nicht mit Ihrer bestehenden Welt kompatibel ist, müssen Sie möglicherweise eine neue erstellen.

serverconfig.json

Die primäre Serverkonfigurationsdatei ist serverconfig.json, die sich im Server-Stammverzeichnis befindet. Diese Datei wird beim ersten Start automatisch generiert. Stoppen Sie den Server vor der Bearbeitung und starten Sie ihn danach neu, damit die Änderungen wirksam werden.

Stoppen Sie den Server über den GPanel-Tab Console.
Öffnen Sie den Tab Files und klicken Sie auf serverconfig.json, um sie zu bearbeiten.
Ändern Sie die gewünschten Einstellungen (siehe Tabelle unten).
Speichern Sie die Datei und starten Sie den Server.

Wichtige Einstellungen

Einstellung	Beispielwert	Beschreibung
`ServerName`	`"My Legion VS Server"`	Der Name, der im Serverbrowser im Spiel angezeigt wird. Gestalten Sie ihn aussagekräftig, damit Spieler Ihren Server finden können.
`WelcomeMessage`	`"Welcome to the server!"`	Nachricht, die Spielern beim Beitritt angezeigt wird. Unterstützt grundlegende Formatierung.
`MaxClients`	`16`	Maximale Anzahl gleichzeitiger Spieler. Sollte mit der Startvariable `MAX_CLIENTS` übereinstimmen.
`Password`	`"mysecretpass"`	Passwort, das zum Beitritt auf den Server erforderlich ist. Lassen Sie es als leere Zeichenfolge (`""`) für einen öffentlichen Server.
`AllowPvP`	`true`	Setzen Sie auf `true`, um Spieler-gegen-Spieler-Kampf zu aktivieren, oder auf `false` für einen reinen PvE-Server.
`SpawnRadius`	`50`	Radius (in Blöcken) um den Welt-Spawnpunkt, in dem neue Spieler spawnen können. Ein größerer Wert verteilt Spieler beim Beitritt weiter.
`MapSizeX`	`1024000`	Weltbreite in Blöcken. Der Standardwert erstellt eine sehr große Welt. Eine Reduzierung begrenzt, wie weit Spieler in Ost-West-Richtung reisen können.
`MapSizeZ`	`1024000`	Welttiefe in Blöcken. Der Standardwert erstellt eine sehr große Welt. Eine Reduzierung begrenzt, wie weit Spieler in Nord-Süd-Richtung reisen können.
`WorldSeed`	`"myseed123"`	Seed für die Weltgenerierung. Derselbe Seed erzeugt dieselbe Welt. Lassen Sie es als leere Zeichenfolge für einen zufälligen Seed.

Ein minimales Beispiel der wichtigsten Einstellungen 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": ""
}

Die Datei muss gültiges JSON sein. Stellen Sie sicher, dass alle Zeichenfolgen in doppelten Anführungszeichen stehen, Boolesche Werte kleingeschrieben sind (true/false) und keine nachgestellten Kommas nach dem letzten Element in einem Objekt oder Array stehen. Wenn der Server nach der Bearbeitung nicht startet, überprüfen Sie die JSON-Syntax auf Fehler.

Weltkonfiguration

Vintage Story generiert seine Welt basierend auf den Einstellungen in serverconfig.json. Die Weltgenerierung erfolgt nur beim ersten Start mit einer bestimmten Welt – das Ändern von Generierungseinstellungen nach der Welterstellung ändert nicht rückwirkend das bestehende Gelände.

Weltgenerierungs-Einstellungen

WorldSeed: Bestimmt die Geländestruktur, Biom-Platzierung und Ressourcenverteilung. Setzen Sie einen bestimmten Seed, um dasselbe Weltlayout mit anderen zu teilen, oder lassen Sie ihn leer für eine zufällig generierte Welt.
MapSizeX / MapSizeZ: Steuern den maximal bespielbaren Bereich. Kleinere Werte erstellen eine kompaktere Welt und können den Ressourcenverbrauch reduzieren. Spieler, die den Rand der Karte erreichen, können nicht weiter in diese Richtung reisen.
WorldConfig: Das WorldConfig-Objekt innerhalb von serverconfig.json ermöglicht die Feinabstimmung von Weltgenerierungsparametern wie Landformskala, Klimamuster und geologische Merkmale. Dies sind erweiterte Einstellungen – die Standardwerte funktionieren für die meisten Server gut.

Weltgenerierungs-Einstellungen sind nach der Erstellung gesperrt. Einstellungen wie WorldSeed, MapSizeX und MapSizeZ werden nur bei der ersten Weltgenerierung wirksam. Um neue Generierungseinstellungen anzuwenden, müssen Sie eine neue Welt erstellen (siehe Speicherverwaltung unten).

Einen Seed auswählen

Der Seed kann eine beliebige Zeichenfolge oder Zahl sein. Spieler in der Vintage Story Community teilen Seeds für interessante Weltlayouts. Wenn Sie eine bestimmte Art von Gelände oder Spawn-Position wünschen, suchen Sie in den Vintage Story Foren oder Community-Seiten nach empfohlenen Seeds.

Verbindung herstellen

Spieler verbinden sich über das Mehrspieler-Menü im Spiel mit Ihrem Vintage Story Server.

Direktverbindung

Starten Sie Vintage Story und klicken Sie im Hauptmenü auf Multiplayer.
Klicken Sie auf Direct Connect.
Geben Sie die IP-Adresse und den Spielport Ihres Servers im folgenden Format ein:
```
your.server.ip:port
```
Überprüfen Sie den Tab Network in GPanel für Ihre zugewiesene IP und Ihren Port.
Klicken Sie auf Connect. Wenn der Server ein Passwort hat, geben Sie es ein, wenn Sie dazu aufgefordert werden.

Serverbrowser

Starten Sie Vintage Story und klicken Sie im Hauptmenü auf Multiplayer.
Der Serverbrowser lädt eine Liste öffentlicher Server. Verwenden Sie die Suchleiste, um Ihren Server nach Namen zu finden (der ServerName-Wert aus serverconfig.json).
Klicken Sie auf Ihren Server in der Liste und klicken Sie auf Join.

Server erscheint nicht im Browser? Der Serverbrowser kann einige Minuten benötigen, um einen neu gestarteten Server zu indexieren. Verwenden Sie die Direktverbindung für sofortigen Zugang. Bestätigen Sie außerdem, dass Sie kein Passwort gesetzt haben – passwortgeschützte Server erscheinen je nach Servereinstellungen möglicherweise nicht im öffentlichen Browser.

Speicherverwaltung

Vintage Story Weltdaten werden auf Ihrem Server gespeichert und während des Spiels automatisch gesichert.

Speicherort der Weltdaten

Weltspeicherdateien befinden sich im Verzeichnis data/ auf Ihrem Server. Der genaue Pfad hängt von Ihrem Weltnamen ab. Sie können auf diese Dateien über den GPanel-Tab Files oder über SFTP zugreifen.

Ihre Welt sichern

Stoppen Sie den Server, um eine saubere Sicherung zu gewährleisten (keine Dateien werden während des Speicherns geschrieben).
Verbinden Sie sich per SFTP mit Ihrem Server. Siehe So laden Sie Dateien über SFTP hoch für Verbindungsanweisungen.
Laden Sie das gesamte Verzeichnis data/ auf Ihren lokalen Computer herunter.
Bewahren Sie die Sicherung an einem sicheren Ort auf. Erwägen Sie, mehrere datierte Sicherungen aufzubewahren, falls Sie auf einen bestimmten Zeitpunkt zurücksetzen müssen.

Regelmäßige Sicherungen werden dringend empfohlen. Weltkorruption, versehentliches Griefing oder fehlgeschlagene Mod-Updates können alle zu Datenverlust führen. Sichern Sie Ihre Welt, bevor Sie wesentliche Änderungen vornehmen, wie z. B. die Spielversion aktualisieren, Mods hinzufügen oder entfernen oder Welteinstellungen ändern.

Die Welt zurücksetzen

Um eine komplett neue Welt zu starten:

Stoppen Sie den Server über den GPanel-Tab Console.
Sichern Sie die bestehenden Weltdaten, wenn Sie sie behalten möchten (siehe oben).
Navigieren Sie zum Verzeichnis data/ im GPanel-Dateimanager und löschen Sie die Weltspeicherdateien.
Aktualisieren Sie optional den WorldSeed in serverconfig.json, um ein anderes Weltlayout zu generieren.
Starten Sie den Server. Eine neue Welt wird von Grund auf mit Ihren aktuellen Konfigurationseinstellungen generiert.

Das Löschen von Weltdateien ist dauerhaft. Einmal gelöscht, kann die Welt nicht wiederhergestellt werden, es sei denn, Sie haben eine Sicherung. Laden Sie immer eine Sicherung herunter, bevor Sie einen Welt-Reset durchführen.

Brauchen Sie Hilfe?

Wenn Sie auf ein Problem stoßen, das in dieser Anleitung nicht behandelt wird, eröffnen Sie ein Support-Ticket und geben Sie die IP-Adresse Ihres Servers, eine Beschreibung des Problems und relevante Konsolenausgaben aus GPanel an.

Vintage Story Server-Einrichtungsanleitung - Wissensdatenbank

Support

Kategorien

Vintage Story Server-Einrichtungsanleitung