Guia de configuració del servidor de Starbound
Aquesta guia cobreix la configuració del vostre servidor dedicat de Starbound a Legion Hosting, incloent-hi els prerequisits d'autenticació de Steam, el primer inici, la configuració del servidor, els paràmetres de l'univers, la connexió de jugadors i la gestió de partides guardades. Per a la instal·lació de mods, consulteu Starbound Mod Installation. Per a comandes d'administrador i privilegis, consulteu Starbound Admin Commands.
Prerequisits
Abans d'iniciar el vostre servidor de Starbound, heu de tenir el següent:
- Un compte de Steam que posseeixi Starbound. El binari del servidor no està disponible per a descàrrega anònima -- el compte que proporcioneu ha de tenir Starbound a la seva biblioteca.
- Consideracions sobre Steam Guard. Si el vostre compte de Steam té Steam Guard (autenticació de dos factors) habilitat, haureu de proporcionar el codi d'autenticació mitjançant la variable d'inici
STEAM_AUTHdurant la primera instal·lació. Després de l'autenticació inicial, SteamCMD emmagatzema la sessió en memòria cau i els inicis posteriors no haurien de requerir el codi de nou, tret que la memòria cau expiri. - Es recomana un compte de Steam dedicat. Per seguretat, considereu utilitzar un compte de Steam separat que posseeixi Starbound exclusivament per a l'allotjament del servidor. Això evita compartir les credencials del vostre compte principal i prevé conflictes si voleu jugar amb el mateix compte simultàniament.
Primer inici
Després de comprar el vostre servidor de Starbound a Legion Hosting, seguiu aquests passos per posar-lo en marxa per primera vegada:
- Inicieu sessió a GPanel i seleccioneu el vostre servidor de Starbound.
- Aneu a la pestanya Startup.
- Empleneu les credencials de Steam requerides:
- STEAM_USER -- El nom d'usuari del vostre compte de Steam (obligatori).
- STEAM_PASS -- La contrasenya del vostre compte de Steam (obligatori).
- STEAM_AUTH -- El vostre codi 2FA de Steam Guard, si se us demana (opcional, només necessari a la primera instal·lació o quan la sessió en memòria cau expiri).
- Aneu a la pestanya Console i feu clic a Start.
- El servidor descarregarà els fitxers del servidor dedicat de Starbound mitjançant SteamCMD. Això pot trigar diversos minuts al primer llançament.
- Un cop completada la descàrrega, el servidor generarà un univers per defecte i començarà a escoltar connexions.
STEAM_AUTH i reinicieu el servidor. Comproveu el vostre correu electrònic o l'aplicació d'autenticació per obtenir el codi. Normalment només cal fer-ho un cop -- SteamCMD emmagatzemarà la sessió en memòria cau per a futurs inicis.
Variables d'inici de GPanel
| Variable | Obligatori | Descripció |
|---|---|---|
STEAM_USER |
Sí | Nom d'usuari del compte de Steam. Ha de posseir Starbound. No pot ser anonymous. |
STEAM_PASS |
Sí | Contrasenya del compte de Steam per al nom d'usuari anterior. |
STEAM_AUTH |
No | Codi d'autenticació de dos factors de Steam Guard. Només necessari durant la configuració inicial o quan la sessió en memòria cau expiri. |
WORKSHOP |
No | Establiu a 1 per habilitar el suport de mods de Steam Workshop, o 0 per desactivar-lo. Per defecte és 0. Consulteu Starbound Mod Installation per a més detalls. |
starbound_server.config
El fitxer de configuració principal del servidor es troba a:
storage/starbound_server.config
Aquest fitxer utilitza el format JSON. Editeu-lo mitjançant el gestor de fitxers de GPanel o a través de SFTP. El servidor ha d'estar aturat abans d'editar, ja que els canvis es carreguen a l'inici.
Configuracions clau del servidor
| Configuració | Per defecte | Descripció |
|---|---|---|
serverName |
"A Starbound Server" |
El nom que es mostra al navegador de servidors i quan els jugadors es connecten. |
maxPlayers |
8 |
Nombre màxim de jugadors que poden estar connectats simultàniament. |
gameServerPort |
21025 |
El port en què escolta el servidor de joc. A Legion Hosting, s'estableix automàticament -- no el canvieu tret que el suport us ho indiqui. |
gameServerBind |
"::" |
La interfície de xarxa a la qual vincular-se. El valor per defecte "::" es vincula a totes les interfícies (IPv4 i IPv6). Deixeu-ho tal com està. |
serverPassword |
"" |
Contrasenya necessària per unir-se al servidor. Deixeu-ho buit per no requerir contrasenya (accés públic). |
allowAnonymousConnections |
true |
Quan és true, els jugadors poden connectar-se sense un compte de Starbound. Establiu a false per requerir autenticació de compte per a tots els jugadors. |
allowAssetsMismatch |
true |
Quan és true, els jugadors amb conjunts de mods diferents poden connectar-se igualment. Establiu a false per forçar la coincidència d'assets entre servidor i client (recomanat per a servidors amb mods). |
maxTeamSize |
4 |
Nombre màxim de jugadors per grup/equip. |
clientIPJoinable |
false |
Si el servidor es pot unir mitjançant IP directa. Hauria de ser true per a servidors dedicats. |
clientP2PJoinable |
false |
Si es permeten connexions peer-to-peer. Normalment false per a servidors dedicats. |
Exemple de 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"
}
}
}
Configuració del món i l'univers
Starbound utilitza un univers generat proceduralment. Cada vegada que un jugador visita un nou sistema estel·lar o planeta, el joc el genera basant-se en una llavor d'univers i un sistema de coordenades. Les dades de l'univers del servidor s'emmagatzemen a:
storage/universe/
Aquest directori conté totes les dades del món generat, incloent-hi planetes, estacions espacials i estructures construïdes pels jugadors col·locades al món.
Configuració de l'univers
Els paràmetres de generació de l'univers es poden ajustar al fitxer starbound_server.config o mitjançant fitxers d'assets relacionats amb l'univers. Conceptes clau:
| Concepte | Descripció |
|---|---|
| Llavor de l'univers | L'univers es genera proceduralment basant-se en coordenades. Tots els servidors amb la mateixa versió del joc generaran planetes idèntics a les mateixes coordenades, però els objectes col·locats pels jugadors i les modificacions són únics per a cada servidor. |
| Planeta inicial | Els nous jugadors apareixen en un planeta inicial seleccionat proceduralment. El món inicial és un planeta de tipus jardí adequat per a la progressió de les primeres etapes del joc. |
| Fitxers del món | Cada planeta visitat genera un fitxer .world a storage/universe/. Aquests fitxers contenen modificacions del terreny, objectes col·locats i canvis de rajoles fets pels jugadors. |
| Dades celestes | Els fitxers universe.chunks i universe.dat al directori de l'univers emmagatzemen l'estat general del mapa de l'univers. |
storage/universe/. Tingueu en compte que això elimina tots els mons generats, incloent-hi qualsevol estructura construïda pels jugadors. Feu sempre una còpia de seguretat abans de fer-ho.
Com connectar-se
Els jugadors es connecten al vostre servidor de Starbound utilitzant el menú multijugador del joc.
Connexió directa per IP
- Inicieu Starbound.
- Des del menú principal, feu clic a Multiplayer.
- Seleccioneu el vostre personatge.
- Al camp Server Address, introduïu l'adreça IP i el port del vostre servidor en el format:
IP:Port - Si el servidor té una contrasenya establerta, introduïu el nom del compte i la contrasenya que coincideixin amb una entrada de
serverUsersa la configuració del servidor. SiallowAnonymousConnectionséstruei no s'ha establert cap contrasenya del servidor, aquests camps es poden deixar buits. - Feu clic a Join Server.
Amics de Steam (no aplicable)
La funció "Join Game" de Steam és per a jocs allotjats peer-to-peer, no per a servidors dedicats. Els jugadors han d'utilitzar el mètode de connexió directa per IP descrit més amunt per unir-se al vostre servidor de Legion Hosting.
- El servidor està en funcionament i completament iniciat (comproveu la consola de GPanel per "Info: Server listened on").
- S'estan utilitzant la IP i el port correctes.
- Si s'utilitza una contrasenya del servidor, el jugador està introduint les credencials correctes de
serverUsers. - Si
allowAssetsMismatchésfalse, els mods instal·lats del jugador han de coincidir exactament amb els mods del servidor. - Tant el servidor com el client estan executant la mateixa versió de Starbound.
Gestió de partides guardades
Starbound emmagatzema totes les dades del servidor dins del directori storage/. Entendre l'estructura de fitxers ajuda amb les còpies de seguretat, les transferències i la resolució de problemes.
Directoris i fitxers d'emmagatzematge clau
| Ruta | Descripció |
|---|---|
storage/universe/ |
Conté totes les dades del món generat -- planetes, estacions espacials i modificacions dels jugadors als mons. Cada planeta visitat té un fitxer .world. |
storage/player/ |
Conté els fitxers de partides guardades dels jugadors. Cada jugador té un fitxer .player que emmagatzema el seu inventari, progrés, estat de missions i dades de la nau. |
storage/starbound_server.config |
El fitxer de configuració principal del servidor. |
storage/starbound_server.log |
Fitxer de registre del servidor. Útil per diagnosticar bloquejos, errors i problemes de connexió. |
Crear còpies de seguretat
Les còpies de seguretat regulars protegeixen l'univers, les dades dels jugadors i la configuració del vostre servidor contra pèrdues o corrupció accidentals.
- Atureu el vostre servidor a GPanel per assegurar-vos que totes les dades s'han escrit al disc.
- Connecteu-vos al vostre servidor via SFTP o utilitzeu el gestor de fitxers.
- Descarregueu tot el directori
storage/al vostre ordinador local. - Emmagatzemeu la còpia de seguretat en un lloc segur amb una etiqueta de data (p. ex.,
storage-backup-2026-02-26).
storage/universe/ i storage/player/. Aquests contenen totes les dades de progrés del món i dels jugadors. També hauríeu de fer una còpia de seguretat de starbound_server.config per preservar la configuració del servidor.
Restaurar des d'una còpia de seguretat
- Atureu el vostre servidor.
- Pugeu els fitxers de la còpia de seguretat a les ubicacions corresponents dins del directori
storage/, sobreescrivint els fitxers existents. - Inicieu el servidor.
Transferir un món des d'un altre servidor
Per moure el vostre univers de Starbound des d'un altre servidor o d'una partida local:
- Atureu tant el servidor d'origen com el de destinació.
- Copieu el directori
storage/universe/de l'origen al servidor de destinació. - Opcionalment, copieu
storage/player/si voleu transferir també les dades dels jugadors. - Copieu el vostre
starbound_server.configper preservar la configuració del servidor. - Inicieu el servidor de destinació i verifiqueu que el món es carrega correctament.
Articles relacionats
- Starbound Mod Installation
- Starbound Admin Commands
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Server Startup Guide
Necessiteu ajuda?
Si teniu problemes no coberts en aquesta guia, el nostre equip de suport està disponible per ajudar-vos. Obriu un tiquet a legionhosting.net/submitticket.php amb els detalls del vostre servidor i una descripció del problema.