Starbound Server Installatiehandleiding
Deze handleiding behandelt het instellen en configureren van je Starbound dedicated server op Legion Hosting, inclusief Steam-authenticatievereisten, eerste opstart, serverconfiguratie, universum-instellingen, spelers verbinden en savebeheer. Voor mod-installatie, zie Starbound Mod Installatie. Voor admin-commando's en -rechten, zie Starbound Admin Commando's.
Vereisten
Voordat je je Starbound-server start, moet je het volgende hebben:
- Een Steam-account dat Starbound bezit. Het serverbestand is niet beschikbaar voor anonieme download -- het account dat je opgeeft moet Starbound in de bibliotheek hebben.
- Steam Guard-overwegingen. Als je Steam-account Steam Guard (tweefactorauthenticatie) ingeschakeld heeft, moet je de authenticatiecode opgeven via de opstartvariabele
STEAM_AUTHtijdens de eerste installatie. Na de initiële authenticatie slaat SteamCMD de sessie op en volgende starts zouden de code niet meer nodig moeten hebben, tenzij de cache verloopt. - Afzonderlijk Steam-account aanbevolen. Voor de veiligheid kun je overwegen een apart Steam-account te gebruiken dat Starbound bezit, uitsluitend voor serverhosting. Dit voorkomt het delen van je primaire accountgegevens en voorkomt conflicten als je tegelijkertijd op hetzelfde account wilt spelen.
Eerste opstart
Nadat je je Starbound-server bij Legion Hosting hebt aangeschaft, volg je deze stappen om deze voor de eerste keer te starten:
- Log in op GPanel en selecteer je Starbound-server.
- Ga naar het tabblad Startup.
- Vul de vereiste Steam-inloggegevens in:
- STEAM_USER -- Je Steam-accountgebruikersnaam (vereist).
- STEAM_PASS -- Je Steam-accountwachtwoord (vereist).
- STEAM_AUTH -- Je Steam Guard 2FA-code, indien gevraagd (optioneel, alleen nodig bij eerste installatie of wanneer de opgeslagen sessie verloopt).
- Ga naar het tabblad Console en klik op Start.
- De server zal de Starbound dedicated serverbestanden downloaden via SteamCMD. Dit kan enkele minuten duren bij de eerste start.
- Zodra de download is voltooid, genereert de server een standaard universum en begint te luisteren naar verbindingen.
STEAM_AUTH in en herstart de server. Controleer je e-mail of authenticator-app voor de code. Je hoeft dit meestal maar één keer te doen -- SteamCMD slaat de sessie op voor toekomstige starts.
GPanel opstartvariabelen
| Variabele | Vereist | Beschrijving |
|---|---|---|
STEAM_USER |
Ja | Steam-accountgebruikersnaam. Moet Starbound bezitten. Kan niet anonymous zijn. |
STEAM_PASS |
Ja | Steam-accountwachtwoord voor bovenstaande gebruikersnaam. |
STEAM_AUTH |
Nee | Steam Guard tweefactorauthenticatiecode. Alleen nodig tijdens de eerste installatie of wanneer de opgeslagen sessie verloopt. |
WORKSHOP |
Nee | Stel in op 1 om Steam Workshop mod-ondersteuning in te schakelen, of 0 om uit te schakelen. Standaard is 0. Zie Starbound Mod Installatie voor details. |
starbound_server.config
Het primaire serverconfigurtatiebestand bevindt zich op:
storage/starbound_server.config
Dit bestand gebruikt JSON-formaat. Bewerk het via de Bestandsbeheerder in GPanel of via SFTP. De server moet gestopt zijn voordat je het bewerkt, aangezien wijzigingen worden geladen bij het opstarten.
Belangrijke serverinstellingen
| Instelling | Standaard | Beschrijving |
|---|---|---|
serverName |
"A Starbound Server" |
De naam die wordt weergegeven in de serverbrowser en wanneer spelers verbinding maken. |
maxPlayers |
8 |
Maximaal aantal spelers dat gelijktijdig verbonden kan zijn. |
gameServerPort |
21025 |
De port waarop de gameserver luistert. Op Legion Hosting wordt dit automatisch ingesteld -- wijzig dit niet tenzij support dit aangeeft. |
gameServerBind |
"::" |
De netwerkinterface om aan te binden. De standaardwaarde "::" bindt aan alle interfaces (IPv4 en IPv6). Laat dit ongewijzigd. |
serverPassword |
"" |
Wachtwoord vereist om de server te joinen. Laat leeg voor geen wachtwoord (openbare toegang). |
allowAnonymousConnections |
true |
Wanneer true, kunnen spelers verbinding maken zonder een Starbound-account. Stel in op false om accountauthenticatie voor alle spelers te vereisen. |
allowAssetsMismatch |
true |
Wanneer true, kunnen spelers met verschillende modsets nog steeds verbinding maken. Stel in op false om overeenkomende assets tussen server en client af te dwingen (aanbevolen voor gemodde servers). |
maxTeamSize |
4 |
Maximaal aantal spelers per groep/team. |
clientIPJoinable |
false |
Of de server kan worden gejoind via direct IP. Moet true zijn voor dedicated servers. |
clientP2PJoinable |
false |
Of peer-to-peer-verbindingen zijn toegestaan. Meestal false voor dedicated servers. |
Voorbeeld 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"
}
}
}
Wereld- en universum-instellingen
Starbound gebruikt een procedureel gegenereerd universum. Elke keer dat een speler een nieuw sterrenstelsel of planeet bezoekt, genereert het spel dit op basis van een universumseed en coördinatensysteem. De universumgegevens van de server worden opgeslagen in:
storage/universe/
Deze map bevat alle gegenereerde wereldgegevens, inclusief planeten, ruimtestations en door spelers gebouwde structuren die in de wereld zijn geplaatst.
Universumconfiguratie
Universumgeneratieparameters kunnen worden aangepast in het bestand starbound_server.config of via universum-gerelateerde assetbestanden. Belangrijke concepten:
| Concept | Beschrijving |
|---|---|
| Universe Seed | Het universum wordt procedureel gegenereerd op basis van coördinaten. Alle servers met dezelfde gameversie genereren identieke planeten op dezelfde coördinaten, maar door spelers geplaatste objecten en aanpassingen zijn uniek per server. |
| Startplaneet | Nieuwe spelers spawnen op een procedureel geselecteerde startplaneet. De startwereld is een tuintype planeet geschikt voor vroege spelprogressie. |
| Wereldbestanden | Elke bezochte planeet genereert een .world-bestand in storage/universe/. Deze bestanden bevatten terreinwijzigingen, geplaatste objecten en tegelaanpassingen gemaakt door spelers. |
| Celestiale gegevens | De bestanden universe.chunks en universe.dat in de universummap slaan de algehele status van de universumkaart op. |
storage/universe/. Wees je ervan bewust dat dit alle gegenereerde werelden verwijdert, inclusief alle door spelers gebouwde structuren. Maak altijd een back-up voordat je dit doet.
Verbinding maken
Spelers maken verbinding met je Starbound-server via het in-game multiplayer-menu.
Directe verbinding via IP
- Start Starbound.
- Klik vanuit het hoofdmenu op Multiplayer.
- Selecteer je personage.
- Voer in het veld Server Address het IP-adres en de port van je server in het formaat:
IP:Port - Als de server een wachtwoord heeft ingesteld, voer dan de Account Name en het Password in die overeenkomen met een
serverUsers-vermelding in de serverconfiguratie. AlsallowAnonymousConnectionsis ingesteld optrueen er geen serverwachtwoord is ingesteld, kunnen deze velden leeg worden gelaten. - Klik op Join Server.
Steam-vrienden (niet van toepassing)
De Steam "Join Game"-functie is voor peer-to-peer gehoste games, niet voor dedicated servers. Spelers moeten de hierboven beschreven directe IP-verbindingsmethode gebruiken om je Legion Hosting-server te joinen.
- De server draait en is volledig opgestart (controleer de GPanel-console op "Info: Server listened on").
- Het juiste IP en de juiste port worden gebruikt.
- Als je een serverwachtwoord gebruikt, moet de speler de juiste
serverUsers-inloggegevens invoeren. - Als
allowAssetsMismatchis ingesteld opfalse, moeten de geïnstalleerde mods van de speler exact overeenkomen met de mods van de server. - Zowel de server als de client draaien dezelfde versie van Starbound.
Savebeheer
Starbound slaat alle servergegevens op in de map storage/. Het begrijpen van de bestandsstructuur helpt bij back-ups, overdrachten en probleemoplossing.
Belangrijke opslagmappen en -bestanden
| Pad | Beschrijving |
|---|---|
storage/universe/ |
Bevat alle gegenereerde wereldgegevens -- planeten, ruimtestations en speleraanpassingen aan werelden. Elke bezochte planeet heeft een .world-bestand. |
storage/player/ |
Bevat spelersavebestanden. Elke speler heeft een .player-bestand waarin hun inventaris, voortgang, queststatus en schipgegevens worden opgeslagen. |
storage/starbound_server.config |
Het hoofdconfiguratiebestand van de server. |
storage/starbound_server.log |
Serverlogbestand. Nuttig voor het diagnosticeren van crashes, fouten en verbindingsproblemen. |
Back-ups maken
Regelmatige back-ups beschermen het universum, de spelersgegevens en de configuratie van je server tegen onbedoeld verlies of beschadiging.
- Stop je server in GPanel om ervoor te zorgen dat alle gegevens naar schijf zijn geschreven.
- Maak verbinding met je server via SFTP of gebruik de Bestandsbeheerder.
- Download de hele map
storage/naar je lokale computer. - Sla de back-up op op een veilige locatie met een datumlabel (bijv.
storage-backup-2026-02-26).
storage/universe/ en storage/player/. Deze bevatten alle wereld- en spelersvoortgangsgegevens. Je moet ook starbound_server.config back-uppen om je serverinstellingen te bewaren.
Herstellen vanaf back-up
- Stop je server.
- Upload je back-upbestanden naar de corresponderende locaties in de map
storage/, waarbij je de bestaande bestanden overschrijft. - Start de server.
Een wereld overzetten vanaf een andere server
Om je Starbound-universum over te zetten vanaf een andere server of een lokaal spel:
- Stop zowel de bron- als de doelserver.
- Kopieer de map
storage/universe/van de bronserver naar de doelserver. - Kopieer optioneel
storage/player/als je ook spelersgegevens wilt overzetten. - Kopieer je
starbound_server.configom serverinstellingen te bewaren. - Start de doelserver en controleer of de wereld correct wordt geladen.
Gerelateerde artikelen
- Starbound Mod Installatie
- Starbound Admin Commando's
- Hoe je je server-IP en port vindt
- Bestanden uploaden via SFTP
- Server Opstarthandleiding
Hulp nodig?
Als je problemen ondervindt die niet in deze handleiding worden behandeld, staat ons supportteam klaar om je te helpen. Open een ticket op legionhosting.net/submitticket.php met je servergegevens en een beschrijving van het probleem.