Starbound Server-Einrichtungsanleitung
Diese Anleitung behandelt die Einrichtung und Konfiguration Ihres Starbound Dedicated Servers bei Legion Hosting, einschließlich Steam-Authentifizierungsvoraussetzungen, Erststart, Serverkonfiguration, Universumseinstellungen, Spielerverbindungen und Speicherverwaltung. Für die Mod-Installation siehe Starbound Mod-Installation. Für Admin-Befehle und Berechtigungen siehe Starbound Admin-Befehle.
Voraussetzungen
Bevor Sie Ihren Starbound-Server starten, müssen folgende Voraussetzungen erfüllt sein:
- Ein Steam-Account, der Starbound besitzt. Die Server-Binärdatei ist nicht für anonymen Download verfügbar -- der angegebene Account muss Starbound in seiner Bibliothek haben.
- Steam Guard-Hinweise. Wenn Ihr Steam-Account Steam Guard (Zwei-Faktor-Authentifizierung) aktiviert hat, müssen Sie den Authentifizierungscode über die
STEAM_AUTH-Startvariable bei der ersten Installation angeben. Nach der erstmaligen Authentifizierung speichert SteamCMD die Sitzung zwischen, und nachfolgende Starts sollten den Code nicht erneut erfordern, es sei denn, der Cache läuft ab. - Separater Steam-Account empfohlen. Aus Sicherheitsgründen sollten Sie einen separaten Steam-Account verwenden, der Starbound ausschließlich für das Server-Hosting besitzt. Dies vermeidet die Weitergabe Ihrer Hauptkonto-Anmeldedaten und verhindert Konflikte, wenn Sie gleichzeitig mit demselben Account spielen möchten.
Erststart
Nach dem Kauf Ihres Starbound-Servers bei Legion Hosting befolgen Sie diese Schritte, um ihn zum ersten Mal zu starten:
- Melden Sie sich bei GPanel an und wählen Sie Ihren Starbound-Server aus.
- Gehen Sie zum Tab Startup.
- Geben Sie die erforderlichen Steam-Anmeldedaten ein:
- STEAM_USER -- Ihr Steam-Account-Benutzername (erforderlich).
- STEAM_PASS -- Ihr Steam-Account-Passwort (erforderlich).
- STEAM_AUTH -- Ihr Steam Guard 2FA-Code, falls angefordert (optional, nur bei der Erstinstallation oder wenn die zwischengespeicherte Sitzung abläuft).
- Gehen Sie zum Tab Console und klicken Sie auf Start.
- Der Server lädt die Starbound Dedicated-Server-Dateien über SteamCMD herunter. Dies kann beim ersten Start mehrere Minuten dauern.
- Sobald der Download abgeschlossen ist, generiert der Server ein Standard-Universum und beginnt, auf Verbindungen zu warten.
STEAM_AUTH ein und starten Sie den Server neu. Prüfen Sie Ihre E-Mail oder Authenticator-App für den Code. Dies ist normalerweise nur einmal erforderlich -- SteamCMD speichert die Sitzung für zukünftige Starts zwischen.
GPanel Startvariablen
| Variable | Erforderlich | Beschreibung |
|---|---|---|
STEAM_USER |
Ja | Steam-Account-Benutzername. Muss Starbound besitzen. Kann nicht anonymous sein. |
STEAM_PASS |
Ja | Steam-Account-Passwort für den oben genannten Benutzernamen. |
STEAM_AUTH |
Nein | Steam Guard Zwei-Faktor-Authentifizierungscode. Nur bei der Ersteinrichtung oder wenn die zwischengespeicherte Sitzung abläuft erforderlich. |
WORKSHOP |
Nein | Auf 1 setzen, um Steam Workshop Mod-Unterstützung zu aktivieren, oder 0 zum Deaktivieren. Standard ist 0. Siehe Starbound Mod-Installation für Details. |
starbound_server.config
Die primäre Serverkonfigurationsdatei befindet sich unter:
storage/starbound_server.config
Diese Datei verwendet das JSON-Format. Bearbeiten Sie sie über den Dateimanager in GPanel oder per SFTP. Der Server muss gestoppt sein, bevor Sie Änderungen vornehmen, da diese beim Start geladen werden.
Wichtige Servereinstellungen
| Einstellung | Standard | Beschreibung |
|---|---|---|
serverName |
"A Starbound Server" |
Der Name, der im Server-Browser und beim Verbinden der Spieler angezeigt wird. |
maxPlayers |
8 |
Maximale Anzahl der gleichzeitig verbundenen Spieler. |
gameServerPort |
21025 |
Der Port, auf dem der Spielserver lauscht. Bei Legion Hosting wird dieser automatisch festgelegt -- ändern Sie ihn nicht, es sei denn, der Support weist Sie an. |
gameServerBind |
"::" |
Die Netzwerkschnittstelle, an die gebunden wird. Der Standard "::" bindet an alle Schnittstellen (IPv4 und IPv6). Lassen Sie dies unverändert. |
serverPassword |
"" |
Passwort, das zum Beitreten des Servers erforderlich ist. Leer lassen für kein Passwort (öffentlicher Zugang). |
allowAnonymousConnections |
true |
Wenn true, können Spieler ohne Starbound-Account verbinden. Auf false setzen, um Account-Authentifizierung für alle Spieler zu erfordern. |
allowAssetsMismatch |
true |
Wenn true, können Spieler mit unterschiedlichen Mod-Sets trotzdem verbinden. Auf false setzen, um übereinstimmende Assets zwischen Server und Client zu erzwingen (empfohlen für gemoddte Server). |
maxTeamSize |
4 |
Maximale Anzahl der Spieler pro Gruppe/Team. |
clientIPJoinable |
false |
Ob dem Server über direkte IP beigetreten werden kann. Sollte für Dedicated Server true sein. |
clientP2PJoinable |
false |
Ob Peer-to-Peer-Verbindungen erlaubt sind. Typischerweise false für Dedicated Server. |
Beispiel starbound_server.config
{
"serverName" : "My Legion Starbound Server",
"maxPlayers" : 8,
"gameServerBind" : "::",
"serverPassword" : "",
"allowAnonymousConnections" : true,
"allowAssetsMismatch" : true,
"maxTeamSize" : 4,
"clientIPJoinable" : true,
"clientP2PJoinable" : false,
"allowAdminCommands" : true,
"allowAdminCommandsFromAnyone" : false,
"serverUsers" : {
"YourUsername" : {
"admin" : true,
"password" : "your-admin-password"
}
}
}
Welt- und Universumseinstellungen
Starbound verwendet ein prozedural generiertes Universum. Jedes Mal, wenn ein Spieler ein neues Sternensystem oder einen Planeten besucht, generiert das Spiel diesen basierend auf einem Universums-Seed und einem Koordinatensystem. Die Universumsdaten des Servers werden gespeichert in:
storage/universe/
Dieses Verzeichnis enthält alle generierten Weltdaten, einschließlich Planeten, Raumstationen und von Spielern gebauten Strukturen in der Welt.
Universumskonfiguration
Parameter der Universumsgenerierung können in der Datei starbound_server.config oder über universumsbezogene Asset-Dateien angepasst werden. Wichtige Konzepte:
| Konzept | Beschreibung |
|---|---|
| Universums-Seed | Das Universum wird prozedural basierend auf Koordinaten generiert. Alle Server mit derselben Spielversion generieren identische Planeten an denselben Koordinaten, aber von Spielern platzierte Objekte und Änderungen sind für jeden Server einzigartig. |
| Startplanet | Neue Spieler spawnen auf einem prozedural ausgewählten Startplaneten. Die Startwelt ist ein gartenartiger Planet, der für den frühen Spielfortschritt geeignet ist. |
| Weltdateien | Jeder besuchte Planet generiert eine .world-Datei in storage/universe/. Diese Dateien enthalten Geländeänderungen, platzierte Objekte und von Spielern vorgenommene Kacheländerungen. |
| Himmelskörperdaten | Die Dateien universe.chunks und universe.dat im Universumsverzeichnis speichern den Gesamtzustand der Universumskarte. |
storage/universe/ um. Beachten Sie, dass dies alle generierten Welten entfernt, einschließlich aller von Spielern gebauten Strukturen. Erstellen Sie immer vorher ein Backup.
Verbindung herstellen
Spieler verbinden sich mit Ihrem Starbound-Server über das Mehrspieler-Menü im Spiel.
Direktverbindung über IP
- Starten Sie Starbound.
- Klicken Sie im Hauptmenü auf Multiplayer.
- Wählen Sie Ihren Charakter aus.
- Geben Sie im Feld Server Address die IP-Adresse und den Port Ihres Servers im Format ein:
IP:Port - Wenn der Server ein Passwort gesetzt hat, geben Sie den Account Name und das Password ein, die einem
serverUsers-Eintrag in der Serverkonfiguration entsprechen. WennallowAnonymousConnectionsauftruegesetzt ist und kein Serverpasswort gesetzt ist, können diese Felder leer gelassen werden. - Klicken Sie auf Join Server.
Steam-Freunde (nicht zutreffend)
Die Steam-Funktion "Spiel beitreten" ist für Peer-to-Peer-gehostete Spiele gedacht, nicht für Dedicated Server. Spieler müssen die oben beschriebene direkte IP-Verbindungsmethode verwenden, um Ihrem Legion Hosting Server beizutreten.
- Der Server läuft und ist vollständig gestartet (prüfen Sie die GPanel-Konsole auf "Info: Server listened on").
- Die korrekte IP und der korrekte Port werden verwendet.
- Bei Verwendung eines Serverpassworts gibt der Spieler die korrekten
serverUsers-Anmeldedaten ein. - Wenn
allowAssetsMismatchauffalsegesetzt ist, müssen die installierten Mods des Spielers exakt mit den Server-Mods übereinstimmen. - Sowohl Server als auch Client verwenden dieselbe Version von Starbound.
Speicherverwaltung
Starbound speichert alle Serverdaten im Verzeichnis storage/. Das Verständnis der Dateistruktur hilft bei Backups, Übertragungen und der Fehlerbehebung.
Wichtige Speicherverzeichnisse und Dateien
| Pfad | Beschreibung |
|---|---|
storage/universe/ |
Enthält alle generierten Weltdaten -- Planeten, Raumstationen und Spieleränderungen an Welten. Jeder besuchte Planet hat eine .world-Datei. |
storage/player/ |
Enthält Spieler-Speicherdateien. Jeder Spieler hat eine .player-Datei, die Inventar, Fortschritt, Quest-Status und Schiffsdaten speichert. |
storage/starbound_server.config |
Die Haupt-Serverkonfigurationsdatei. |
storage/starbound_server.log |
Server-Logdatei. Nützlich zur Diagnose von Abstürzen, Fehlern und Verbindungsproblemen. |
Backups erstellen
Regelmäßige Backups schützen das Universum, die Spielerdaten und die Konfiguration Ihres Servers vor versehentlichem Verlust oder Beschädigung.
- Stoppen Sie Ihren Server in GPanel, um sicherzustellen, dass alle Daten auf die Festplatte geschrieben werden.
- Verbinden Sie sich per SFTP mit Ihrem Server oder verwenden Sie den Dateimanager.
- Laden Sie das gesamte Verzeichnis
storage/auf Ihren lokalen Computer herunter. - Speichern Sie das Backup an einem sicheren Ort mit einer Datumsbezeichnung (z.B.
storage-backup-2026-02-26).
storage/universe/ und storage/player/. Diese enthalten alle Welt- und Spielerfortschrittsdaten. Sie sollten auch starbound_server.config sichern, um Ihre Servereinstellungen zu bewahren.
Aus Backup wiederherstellen
- Stoppen Sie Ihren Server.
- Laden Sie Ihre Backup-Dateien an die entsprechenden Stellen im Verzeichnis
storage/hoch und überschreiben Sie die vorhandenen Dateien. - Starten Sie den Server.
Eine Welt von einem anderen Server übertragen
Um Ihr Starbound-Universum von einem anderen Server oder einem lokalen Spiel zu übertragen:
- Stoppen Sie sowohl den Quell- als auch den Zielserver.
- Kopieren Sie das Verzeichnis
storage/universe/vom Quell- zum Zielserver. - Optional können Sie
storage/player/kopieren, wenn Sie auch die Spielerdaten übertragen möchten. - Kopieren Sie Ihre
starbound_server.config, um die Servereinstellungen zu bewahren. - Starten Sie den Zielserver und überprüfen Sie, ob die Welt korrekt geladen wird.
Verwandte Artikel
- Starbound Mod-Installation
- Starbound Admin-Befehle
- So finden Sie Ihre Server-IP und Ihren Port
- Dateien per SFTP hochladen
- Server-Startanleitung
Brauchen Sie Hilfe?
Wenn Sie Probleme haben, die in dieser Anleitung nicht behandelt werden, steht Ihnen unser Support-Team zur Verfügung. Eröffnen Sie ein Ticket unter legionhosting.net/submitticket.php mit Ihren Serverdetails und einer Beschreibung des Problems.