Guida alla Configurazione del Server Starbound
Questa guida copre la configurazione del tuo server dedicato Starbound su Legion Hosting, inclusi i prerequisiti di autenticazione Steam, il primo avvio, la configurazione del server, le impostazioni dell'universo, la connessione dei giocatori e la gestione dei salvataggi. Per l'installazione delle mod, consulta Installazione Mod Starbound. Per i comandi e i privilegi admin, consulta Comandi Admin Starbound.
Prerequisiti
Prima di avviare il tuo server Starbound, devi avere quanto segue:
- Un account Steam che possiede Starbound. Il binario del server non è disponibile per il download anonimo -- l'account che fornisci deve avere Starbound nella sua libreria.
- Considerazioni su Steam Guard. Se il tuo account Steam ha Steam Guard (autenticazione a due fattori) abilitato, dovrai fornire il codice di autenticazione tramite la variabile di avvio
STEAM_AUTHdurante la prima installazione. Dopo l'autenticazione iniziale, SteamCMD memorizza nella cache la sessione e gli avvii successivi non dovrebbero richiedere nuovamente il codice a meno che la cache non scada. - Account Steam dedicato consigliato. Per sicurezza, considera l'utilizzo di un account Steam separato che possiede Starbound esclusivamente per l'hosting del server. Questo evita di condividere le credenziali del tuo account principale e previene conflitti se vuoi giocare contemporaneamente sullo stesso account.
Primo Avvio
Dopo aver acquistato il tuo server Starbound da Legion Hosting, segui questi passaggi per farlo funzionare per la prima volta:
- Accedi a GPanel e seleziona il tuo server Starbound.
- Vai alla scheda Startup.
- Compila le credenziali Steam richieste:
- STEAM_USER -- Il nome utente del tuo account Steam (obbligatorio).
- STEAM_PASS -- La password del tuo account Steam (obbligatoria).
- STEAM_AUTH -- Il tuo codice 2FA di Steam Guard, se richiesto (opzionale, necessario solo alla prima installazione o quando la sessione memorizzata nella cache scade).
- Vai alla scheda Console e clicca su Start.
- Il server scaricherà i file del server dedicato Starbound tramite SteamCMD. Questo può richiedere diversi minuti al primo avvio.
- Una volta completato il download, il server genererà un universo predefinito e inizierà ad ascoltare le connessioni.
STEAM_AUTH e riavvia il server. Controlla la tua email o l'app di autenticazione per il codice. Di solito devi farlo solo una volta -- SteamCMD memorizzerà nella cache la sessione per gli avvii futuri.
Variabili di Avvio GPanel
| Variabile | Obbligatoria | Descrizione |
|---|---|---|
STEAM_USER |
Sì | Nome utente dell'account Steam. Deve possedere Starbound. Non può essere anonymous. |
STEAM_PASS |
Sì | Password dell'account Steam per il nome utente sopra. |
STEAM_AUTH |
No | Codice di autenticazione a due fattori Steam Guard. Necessario solo durante la configurazione iniziale o quando la sessione memorizzata nella cache scade. |
WORKSHOP |
No | Imposta su 1 per abilitare il supporto mod Steam Workshop, o 0 per disabilitare. Il valore predefinito è 0. Consulta Installazione Mod Starbound per i dettagli. |
starbound_server.config
Il file di configurazione principale del server si trova in:
storage/starbound_server.config
Questo file utilizza il formato JSON. Modificalo tramite il File Manager in GPanel o tramite SFTP. Il server deve essere arrestato prima della modifica, poiché le modifiche vengono caricate all'avvio.
Impostazioni Chiave del Server
| Impostazione | Predefinito | Descrizione |
|---|---|---|
serverName |
"A Starbound Server" |
Il nome visualizzato nel browser del server e quando i giocatori si connettono. |
maxPlayers |
8 |
Numero massimo di giocatori che possono essere connessi contemporaneamente. |
gameServerPort |
21025 |
La porta su cui il server di gioco è in ascolto. Su Legion Hosting, questa viene impostata automaticamente -- non modificarla a meno che non sia richiesto dal supporto. |
gameServerBind |
"::" |
L'interfaccia di rete a cui collegarsi. Il valore predefinito "::" si collega a tutte le interfacce (IPv4 e IPv6). Lascia come è. |
serverPassword |
"" |
Password richiesta per unirsi al server. Lascia vuoto per nessuna password (accesso pubblico). |
allowAnonymousConnections |
true |
Quando true, i giocatori possono connettersi senza un account Starbound. Imposta su false per richiedere l'autenticazione dell'account a tutti i giocatori. |
allowAssetsMismatch |
true |
Quando true, i giocatori con set di mod differenti possono comunque connettersi. Imposta su false per imporre la corrispondenza degli asset tra server e client (consigliato per server moddati). |
maxTeamSize |
4 |
Numero massimo di giocatori per gruppo/squadra. |
clientIPJoinable |
false |
Se il server può essere raggiunto tramite IP diretto. Dovrebbe essere true per i server dedicati. |
clientP2PJoinable |
false |
Se le connessioni peer-to-peer sono consentite. In genere false per i server dedicati. |
Esempio 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"
}
}
}
Impostazioni del Mondo e dell'Universo
Starbound utilizza un universo generato proceduralmente. Ogni volta che un giocatore visita un nuovo sistema stellare o pianeta, il gioco lo genera in base a un seme di universo e a un sistema di coordinate. I dati dell'universo del server sono memorizzati in:
storage/universe/
Questa directory contiene tutti i dati dei mondi generati, inclusi pianeti, stazioni spaziali e strutture costruite dai giocatori e collocate nel mondo.
Configurazione dell'Universo
I parametri di generazione dell'universo possono essere regolati nel file starbound_server.config o tramite i file degli asset relativi all'universo. Concetti chiave:
| Concetto | Descrizione |
|---|---|
| Seme dell'Universo | L'universo è generato proceduralmente in base alle coordinate. Tutti i server con la stessa versione del gioco genereranno pianeti identici alle stesse coordinate, ma gli oggetti posizionati dai giocatori e le modifiche sono unici per ogni server. |
| Pianeta di Partenza | I nuovi giocatori appaiono su un pianeta di partenza selezionato proceduralmente. Il mondo iniziale è un pianeta di tipo giardino adatto alla progressione nelle prime fasi del gioco. |
| File dei Mondi | Ogni pianeta visitato genera un file .world in storage/universe/. Questi file contengono modifiche al terreno, oggetti posizionati e cambiamenti delle tile effettuati dai giocatori. |
| Dati Celesti | I file universe.chunks e universe.dat nella directory dell'universo memorizzano lo stato complessivo della mappa dell'universo. |
storage/universe/. Tieni presente che questo rimuove tutti i mondi generati, comprese eventuali strutture costruite dai giocatori. Esegui sempre un backup prima di farlo.
Come Connettersi
I giocatori si connettono al tuo server Starbound utilizzando il menu multiplayer in-game.
Connessione Diretta tramite IP
- Avvia Starbound.
- Dal menu principale, clicca su Multiplayer.
- Seleziona il tuo personaggio.
- Nel campo Server Address, inserisci l'indirizzo IP e la porta del tuo server nel formato:
IP:Port - Se il server ha una password impostata, inserisci l'Account Name e la Password corrispondenti a una voce
serverUsersnella configurazione del server. SeallowAnonymousConnectionsètruee non è impostata alcuna password del server, questi campi possono essere lasciati vuoti. - Clicca su Join Server.
Amici Steam (Non Applicabile)
La funzione "Join Game" di Steam è per giochi ospitati peer-to-peer, non per server dedicati. I giocatori devono utilizzare il metodo di connessione IP diretta descritto sopra per unirsi al tuo server Legion Hosting.
- Il server è in esecuzione e completamente avviato (controlla la console GPanel per "Info: Server listened on").
- Vengono utilizzati l'IP e la porta corretti.
- Se si utilizza una password del server, il giocatore sta inserendo le credenziali
serverUserscorrette. - Se
allowAssetsMismatchèfalse, le mod installate del giocatore devono corrispondere esattamente alle mod del server. - Sia il server che il client eseguono la stessa versione di Starbound.
Gestione dei Salvataggi
Starbound memorizza tutti i dati del server all'interno della directory storage/. Comprendere la struttura dei file aiuta con backup, trasferimenti e risoluzione dei problemi.
Directory e File di Archiviazione Chiave
| Percorso | Descrizione |
|---|---|
storage/universe/ |
Contiene tutti i dati dei mondi generati -- pianeti, stazioni spaziali e modifiche dei giocatori ai mondi. Ogni pianeta visitato ha un file .world. |
storage/player/ |
Contiene i file di salvataggio dei giocatori. Ogni giocatore ha un file .player che memorizza il proprio inventario, progresso, stato delle missioni e dati della nave. |
storage/starbound_server.config |
Il file di configurazione principale del server. |
storage/starbound_server.log |
File di log del server. Utile per diagnosticare crash, errori e problemi di connessione. |
Creazione di Backup
I backup regolari proteggono l'universo del tuo server, i dati dei giocatori e la configurazione da perdite accidentali o corruzione.
- Arresta il tuo server in GPanel per assicurarti che tutti i dati siano scritti su disco.
- Connettiti al tuo server tramite SFTP o usa il File Manager.
- Scarica l'intera directory
storage/sul tuo computer locale. - Conserva il backup in una posizione sicura con un'etichetta di data (es.
storage-backup-2026-02-26).
storage/universe/ e storage/player/. Queste contengono tutti i dati del mondo e di progresso dei giocatori. Dovresti anche eseguire il backup di starbound_server.config per preservare le impostazioni del tuo server.
Ripristino da Backup
- Arresta il tuo server.
- Carica i tuoi file di backup nelle posizioni corrispondenti nella directory
storage/, sovrascrivendo i file esistenti. - Avvia il server.
Trasferimento di un Mondo da un Altro Server
Per spostare il tuo universo Starbound da un altro server o da una partita locale:
- Arresta sia il server di origine che quello di destinazione.
- Copia la directory
storage/universe/dal server di origine a quello di destinazione. - Opzionalmente, copia
storage/player/se vuoi trasferire anche i dati dei giocatori. - Copia il tuo
starbound_server.configper preservare le impostazioni del server. - Avvia il server di destinazione e verifica che il mondo si carichi correttamente.
Articoli Correlati
- Installazione Mod Starbound
- Comandi Admin Starbound
- Come Trovare l'IP e la Porta del Tuo Server
- Come Caricare File tramite SFTP
- Guida all'Avvio del Server
Hai Bisogno di Aiuto?
Se riscontri problemi non trattati in questa guida, il nostro team di supporto è disponibile per assisterti. Apri un ticket su legionhosting.net/submitticket.php con i dettagli del tuo server e una descrizione del problema.