Starboundin palvelimen asennusopas
Tämä opas käsittelee Starbound-pelipalvelimesi asentamista ja konfigurointia Legion Hostingilla, mukaan lukien Steam-todennuksen edellytykset, ensimmäinen käynnistys, palvelimen konfigurointi, universumiasetukset, pelaajien yhdistäminen ja tallennusten hallinta. Modien asennusta varten katso Starbound-modien asennus. Ylläpitäjäkomentoja ja -oikeuksia varten katso Starboundin ylläpitäjäkomennot.
Edellytykset
Ennen Starbound-palvelimesi käynnistämistä sinulla on oltava seuraavat:
- Steam-tili, joka omistaa Starboundin. Palvelimen binaaria ei ole saatavilla anonyymiin lataukseen -- antamasi tilin on oltava Starbound kirjastossaan.
- Steam Guard -huomioita. Jos Steam-tililläsi on Steam Guard (kaksivaiheinen todennus) käytössä, sinun on annettava todennuskoodi
STEAM_AUTH-käynnistysmuuttujan kautta ensimmäisen asennuksen aikana. Alkuperäisen todennuksen jälkeen SteamCMD tallentaa istunnon välimuistiin, eivätkä myöhemmät käynnistykset vaadi koodia uudelleen, ellei välimuisti vanhene. - Erillinen Steam-tili suositeltava. Turvallisuuden vuoksi harkitse erillisen Starboundin omistavan Steam-tilin käyttöä yksinomaan palvelimen isännöintiin. Tämä välttää ensisijaisen tilisi tunnistetietojen jakamisen ja estää ristiriidat, jos haluat pelata samalla tilillä samanaikaisesti.
Ensimmäinen käynnistys
Kun olet ostanut Starbound-palvelimesi Legion Hostingilta, seuraa näitä vaiheita saadaksesi sen käyntiin ensimmäistä kertaa:
- Kirjaudu GPaneliin ja valitse Starbound-palvelimesi.
- Siirry Startup-välilehdelle.
- Täytä vaaditut Steam-tunnistetiedot:
- STEAM_USER -- Steam-tilisi käyttäjänimi (pakollinen).
- STEAM_PASS -- Steam-tilisi salasana (pakollinen).
- STEAM_AUTH -- Steam Guard 2FA -koodisi, jos sitä pyydetään (valinnainen, tarvitaan vain ensimmäisellä asennuksella tai kun välimuistissa oleva istunto vanhenee).
- Siirry Console-välilehdelle ja napsauta Start.
- Palvelin lataa Starboundin pelipalvelintiedostot SteamCMD:n kautta. Tämä voi kestää useita minuutteja ensimmäisellä käynnistyksellä.
- Kun lataus on valmis, palvelin luo oletusuniversumin ja alkaa kuunnella yhteyksiä.
STEAM_AUTH-kenttään ja käynnistä palvelin uudelleen. Tarkista koodi sähköpostistasi tai todennussovelluksestasi. Yleensä sinun tarvitsee tehdä tämä vain kerran -- SteamCMD tallentaa istunnon välimuistiin tulevia käynnistyksiä varten.
GPanelin käynnistysmuuttujat
| Muuttuja | Pakollinen | Kuvaus |
|---|---|---|
STEAM_USER |
Kyllä | Steam-tilin käyttäjänimi. On omistettava Starbound. Ei voi olla anonymous. |
STEAM_PASS |
Kyllä | Yllä olevan käyttäjänimen Steam-tilin salasana. |
STEAM_AUTH |
Ei | Steam Guard -kaksivaiheisen todennuksen koodi. Tarvitaan vain alkuasennuksen aikana tai kun välimuistissa oleva istunto vanhenee. |
WORKSHOP |
Ei | Aseta arvoon 1 ottaaksesi käyttöön Steam Workshop -modituen tai 0 poistaaksesi sen käytöstä. Oletus on 0. Katso lisätietoja kohdasta Starbound-modien asennus. |
starbound_server.config
Ensisijainen palvelimen konfiguraatiotiedosto sijaitsee osoitteessa:
storage/starbound_server.config
Tämä tiedosto käyttää JSON-muotoa. Muokkaa sitä GPanelin tiedostonhallinnan kautta tai SFTP:n kautta. Palvelin on pysäytettävä ennen muokkausta, koska muutokset ladataan käynnistyksen yhteydessä.
Tärkeimmät palvelinasetukset
| Asetus | Oletus | Kuvaus |
|---|---|---|
serverName |
"A Starbound Server" |
Palvelinselaimessa ja pelaajien yhdistäessä näytettävä nimi. |
maxPlayers |
8 |
Samanaikaisesti yhdistettyjen pelaajien enimmäismäärä. |
gameServerPort |
21025 |
Portti, jota pelipalvelin kuuntelee. Legion Hostingilla tämä asetetaan automaattisesti -- älä muuta sitä, ellei tuki niin ohjeista. |
gameServerBind |
"::" |
Verkkoliitäntä, johon sidotaan. Oletus "::" sitoo kaikkiin liitäntöihin (IPv4 ja IPv6). Jätä tämä ennalleen. |
serverPassword |
"" |
Palvelimelle liittymiseen vaadittava salasana. Jätä tyhjäksi, jos salasanaa ei haluta (julkinen pääsy). |
allowAnonymousConnections |
true |
Kun true, pelaajat voivat yhdistää ilman Starbound-tiliä. Aseta arvoon false vaatiaksesi tilitodennuksen kaikilta pelaajilta. |
allowAssetsMismatch |
true |
Kun true, pelaajat eri modisarjoilla voivat silti yhdistää. Aseta arvoon false pakottaaksesi resurssien täsmäämisen palvelimen ja asiakkaan välillä (suositeltavaa modatuille palvelimille). |
maxTeamSize |
4 |
Pelaajien enimmäismäärä ryhmää/tiimiä kohden. |
clientIPJoinable |
false |
Voiko palvelimelle liittyä suoran IP:n kautta. Pitäisi olla true pelipalvelimille. |
clientP2PJoinable |
false |
Sallitaanko vertaisverkkoyhteydet (peer-to-peer). Yleensä false pelipalvelimille. |
Esimerkki 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"
}
}
}
Maailman ja universumin asetukset
Starbound käyttää proseduraalisesti generoitua universumia. Joka kerta kun pelaaja vierailee uudessa tähtijärjestelmässä tai planeetalla, peli generoi sen universumin siemenen ja koordinaattijärjestelmän perusteella. Palvelimen universumidata tallennetaan kohteeseen:
storage/universe/
Tämä hakemisto sisältää kaiken generoidun maailmadatan, mukaan lukien planeetat, avaruusasemat ja pelaajien rakentamat rakenteet maailmassa.
Universumin konfigurointi
Universumin generointiparametreja voidaan säätää starbound_server.config-tiedostossa tai universumiin liittyvien resurssitiedostojen kautta. Keskeiset käsitteet:
| Käsite | Kuvaus |
|---|---|
| Universumin siemen | Universumi generoidaan proseduraalisesti koordinaattien perusteella. Kaikki saman peliversion palvelimet generoivat identtiset planeetat samoissa koordinaateissa, mutta pelaajien sijoittamat objektit ja muokkaukset ovat ainutlaatuisia kullekin palvelimelle. |
| Aloitusplaneetta | Uudet pelaajat ilmestyvät proseduraalisesti valitulle aloitusplaneetalle. Aloitusmaailma on puutarhatyyppinen planeetta, joka soveltuu alkupelin etenemiseen. |
| Maailmatiedostot | Jokainen vierailtu planeetta generoi .world-tiedoston kohteeseen storage/universe/. Nämä tiedostot sisältävät maaston muokkaukset, sijoitetut objektit ja pelaajien tekemät tile-muutokset. |
| Taivaankappaledata | Universumihakemiston universe.chunks- ja universe.dat-tiedostot tallentavat universumikartan kokonaistilan. |
storage/universe/-hakemisto. Huomaa, että tämä poistaa kaikki generoidut maailmat, mukaan lukien mahdolliset pelaajien rakentamat rakenteet. Varmuuskopioi aina ennen tämän tekemistä.
Kuinka yhdistää
Pelaajat yhdistävät Starbound-palvelimeesi pelin sisäisen moninpelivalikon kautta.
Suora yhteys IP:n kautta
- Käynnistä Starbound.
- Napsauta päävalikosta Multiplayer.
- Valitse hahmosi.
- Syötä Server Address -kenttään palvelimesi IP-osoite ja portti muodossa:
IP:Port - Jos palvelimelle on asetettu salasana, syötä Account Name ja Password, jotka vastaavat palvelimen konfiguraation
serverUsers-merkintää. JosallowAnonymousConnectionsontrueeikä palvelimen salasanaa ole asetettu, nämä kentät voidaan jättää tyhjiksi. - Napsauta Join Server.
Steam-kaverit (ei sovellu)
Steamin "Join Game" -ominaisuus on tarkoitettu vertaisverkossa (peer-to-peer) isännöityihin peleihin, ei pelipalvelimiin. Pelaajien on käytettävä yllä kuvattua suoran IP-yhteyden menetelmää liittyäkseen Legion Hosting -palvelimeesi.
- Palvelin on käynnissä ja täysin käynnistynyt (tarkista GPanelin konsolista "Info: Server listened on").
- Oikeaa IP:tä ja porttia käytetään.
- Jos käytössä on palvelimen salasana, pelaaja syöttää oikeat
serverUsers-tunnistetiedot. - Jos
allowAssetsMismatchonfalse, pelaajan asennettujen modien on täsmättävä tarkalleen palvelimen modeihin. - Sekä palvelin että asiakas käyttävät samaa Starboundin versiota.
Tallennusten hallinta
Starbound tallentaa kaiken palvelindatan storage/-hakemistoon. Tiedostorakenteen ymmärtäminen auttaa varmuuskopioinnissa, siirroissa ja vianmäärityksessä.
Tärkeimmät tallennushakemistot ja -tiedostot
| Polku | Kuvaus |
|---|---|
storage/universe/ |
Sisältää kaiken generoidun maailmadatan -- planeetat, avaruusasemat ja pelaajien tekemät maailmamuokkaukset. Jokaisella vierailtulla planeetalla on .world-tiedosto. |
storage/player/ |
Sisältää pelaajien tallennustiedostot. Jokaisella pelaajalla on .player-tiedosto, joka tallentaa heidän inventaarionsa, etenemisensä, tehtävätilansa ja alusdatansa. |
storage/starbound_server.config |
Palvelimen pääkonfiguraatiotiedosto. |
storage/starbound_server.log |
Palvelimen lokitiedosto. Hyödyllinen kaatumisten, virheiden ja yhteysongelmien diagnosoinnissa. |
Varmuuskopioiden luominen
Säännölliset varmuuskopiot suojaavat palvelimesi universumia, pelaajadataa ja konfiguraatiota tahattomalta katoamiselta tai vioittumiselta.
- Pysäytä palvelimesi GPanelissa varmistaaksesi, että kaikki data kirjoitetaan levylle.
- Yhdistä palvelimeesi SFTP:n kautta tai käytä tiedostonhallintaa.
- Lataa koko
storage/-hakemisto paikalliselle tietokoneellesi. - Säilytä varmuuskopio turvallisessa paikassa päivämääräleimalla (esim.
storage-backup-2026-02-26).
storage/universe/- ja storage/player/-hakemistot. Ne sisältävät kaiken maailman ja pelaajien etenemisdatan. Sinun tulisi myös varmuuskopioida starbound_server.config säilyttääksesi palvelinasetuksesi.
Palauttaminen varmuuskopiosta
- Pysäytä palvelimesi.
- Lähetä varmuuskopiotiedostosi vastaaviin sijainteihin
storage/-hakemistossa korvaten olemassa olevat tiedostot. - Käynnistä palvelin.
Maailman siirtäminen toiselta palvelimelta
Siirtääksesi Starbound-universumisi toiselta palvelimelta tai paikallisesta pelistä:
- Pysäytä sekä lähde- että kohdepalvelimet.
- Kopioi
storage/universe/-hakemisto lähteestä kohdepalvelimelle. - Valinnaisesti kopioi
storage/player/, jos haluat siirtää myös pelaajadatan. - Kopioi
starbound_server.configsäilyttääksesi palvelinasetukset. - Käynnistä kohdepalvelin ja varmista, että maailma latautuu oikein.
Aiheeseen liittyvät artikkelit
- Starbound-modien asennus
- Starboundin ylläpitäjäkomennot
- Kuinka löytää palvelimesi IP ja portti
- Kuinka lähettää tiedostoja SFTP:n kautta
- Palvelimen käynnistysopas
Tarvitsetko apua?
Jos kohtaat ongelmia, joita tämä opas ei kata, tukitiimimme on käytettävissäsi. Avaa tiketti osoitteessa legionhosting.net/submitticket.php ja kerro palvelimesi tiedot sekä kuvaus ongelmasta.