Questa guida copre la configurazione admin, la gestione dei giocatori, l'utilizzo della console del server, la gestione del mondo e la risoluzione dei problemi per il tuo server dedicato Foundry. Foundry è un gioco di costruzione di fabbriche basato su voxel in cui i giocatori costruiscono e automatizzano linee di produzione complesse in un mondo generato proceduralmente. Per la configurazione iniziale del server, la configurazione, la generazione del mondo e le istruzioni di connessione, consulta Guida alla Configurazione del Server Foundry.

1. Controlli Admin e Host

I server dedicati Foundry utilizzano un modello di permessi basato sull'host. L'operatore del server gestisce il server attraverso una combinazione del file di configurazione App.cfg e dei controlli host in gioco.

Accesso dell'Operatore del Server

Come operatore del server, gestisci il tuo server Foundry attraverso:

• Console GPanel: La console del server in GPanel visualizza l'output del server, gli eventi di connessione e i messaggi di errore. Questo è il tuo strumento di monitoraggio principale.
• File di configurazione: Il file App.cfg controlla tutte le impostazioni del server. Modificalo tramite la scheda Files in GPanel o tramite SFTP. Consulta Guida alla Configurazione del Server Foundry per i dettagli.
• Controlli in gioco: Quando connesso al server, il giocatore host ha accesso a opzioni di gestione aggiuntive tramite il menu in gioco.

Protezione con Password del Server

Per limitare chi può unirsi al tuo server, imposta una password in App.cfg:

server_password=YourSecretPassword

I giocatori devono inserire questa password quando si connettono. Per rendere il server nuovamente pubblico, cancella il valore della password:

server_password=

Nascondere il Server dal Browser

Se vuoi un server privato che non appaia nel browser dei server Steam, imposta:

server_is_public=false

I giocatori possono comunque unirsi tramite connessione diretta usando il tuo IP e la porta, ma il server non sarà scopribile tramite navigazione.

2. Gestione dei Giocatori

Espulsione dei Giocatori

Per rimuovere un giocatore problematico dal server:

• In gioco: Apri la lista dei giocatori dal menu in gioco, seleziona il giocatore e usa l'opzione di espulsione. Questa è disponibile per il giocatore host.
• Riavvio del server: Come ultima risorsa, riavviare il server da GPanel disconnetterà tutti i giocatori. Al giocatore problematico può essere impedito di rientrare impostando una password del server.

Bannare i Giocatori

Per impedire permanentemente a un giocatore di unirsi al tuo server:

• Usa l'opzione di ban in gioco quando disponibile tramite il menu di gestione dei giocatori.
• I giocatori bannati vengono tracciati tramite il loro Steam ID e verranno rifiutati nei futuri tentativi di connessione.
• La lista dei ban persiste tra i riavvii del server.

Gestione del Numero di Giocatori

Controlla quanti giocatori possono essere online simultaneamente:

server_max_players=16

Il massimo predefinito è 32. Abbassare questo valore è consigliato se il tuo piano server ha risorse limitate, o se riscontri problemi di prestazioni con molti giocatori connessi. Ogni giocatore connesso carica chunk aggiuntivi intorno alla propria posizione, aumentando il carico di elaborazione del server.

3. Console del Server

La console GPanel visualizza l'output del server in tempo reale, inclusi:

• Eventi di connessione e disconnessione dei giocatori
• Conferme di salvataggio del mondo
• Messaggi di errore e avvisi
• Stato di avvio e spegnimento del server

Lettura dell'Output della Console

Monitora la console per messaggi importanti:

4. Gestione del Mondo

Passare tra i Mondi

Foundry supporta mondi multipli tramite l'impostazione server_world_name. Ogni nome di mondo corrisponde a una directory di salvataggio separata con la propria fabbrica, terreno e dati dei giocatori.

1. Ferma il server da GPanel.
2. Apri App.cfg e cambia server_world_name con un nome diverso:

   server_world_name=NewFactory

3. Se vuoi un nuovo mondo con un terreno specifico, imposta anche un nuovo valore di map_seed.
4. Avvia il server. Se il nome del mondo non esiste già, verrà generato un nuovo mondo.

Reset di un Mondo

Per resettare completamente un mondo e ricominciare con una nuova fabbrica:

1. Ferma il server da GPanel.
2. Connettiti tramite SFTP e naviga nella directory serverfiles/.
3. Elimina o rinomina la cartella del mondo (es. rinomina MyFoundry in MyFoundry_backup).
4. Opzionalmente cambia il map_seed in App.cfg se vuoi un terreno diverso.
5. Avvia il server. Verrà generato un mondo nuovo utilizzando il seed configurato.

Ripristino di un Backup

1. Ferma il server da GPanel.
2. Connettiti tramite SFTP.
3. Carica la cartella del mondo di backup nella directory serverfiles/, sostituendo quella attuale.
4. Assicurati che il nome della cartella corrisponda al server_world_name in App.cfg.
5. Avvia il server. Il mondo di backup verrà caricato.

5. Configurazione del Salvataggio Automatico

Il sistema di salvataggio automatico di Foundry scrive l'intero stato del mondo su disco a intervalli regolari. Configuralo in App.cfg:

6. Risoluzione dei Problemi

Il Server Crasha all'Avvio

• Controlla la console GPanel per messaggi di errore. Le cause comuni includono una sintassi App.cfg malformata (valori mancanti, spazi extra intorno al segno =).
• Verifica che i valori delle porte non siano stati modificati manualmente. Le porte devono corrispondere a quelle assegnate da GPanel.
• Prova a eliminare App.cfg e riavviare per rigenerare una configurazione pulita con i valori predefiniti.
• Se il crash è legato a un mondo specifico, prova a passare a un nuovo server_world_name per verificare se il problema è legato al salvataggio.
• Se il crash persiste, apri un ticket di supporto con l'IP del tuo server e l'output completo della console.

I Giocatori Non Riescono a Connettersi

• Verifica che il server sia in esecuzione in GPanel. Controlla la console per errori durante l'avvio.
• Conferma che il giocatore stia usando l'IP e la porta corretti dalla scheda Network di GPanel.
• Verifica che la password del server sia corretta (le password distinguono tra maiuscole e minuscole).
• Assicurati che il server non abbia raggiunto il limite di server_max_players.
• Verifica che sia il server che il giocatore stiano utilizzando la stessa versione di Foundry. Gli aggiornamenti del gioco possono temporaneamente interrompere la compatibilità.

Il Server Non Appare nel Browser

• Conferma che server_is_public=true sia impostato in App.cfg.
• Il browser dei server Steam può impiegare diversi minuti per indicizzare un nuovo server. Prova la connessione diretta nel frattempo.
• Riavvia il server se è in esecuzione da molto tempo senza apparire. A volte la connessione al master server Steam può interrompersi.

Degrado delle Prestazioni con Fabbriche Grandi

• Costruzioni di fabbriche grandi con migliaia di macchine e nastri trasportatori aumentano il tempo di tick del server. Questo è un comportamento previsto in Foundry.
• Riduci server_max_players per diminuire il numero di chunk caricati.
• Abilita pause_server_when_empty=true così il server non simula la fabbrica quando nessuno è online.
• Ottimizza il layout della tua fabbrica consolidando le linee di produzione e riducendo il routing non necessario dei nastri trasportatori.
• Aumenta autosave_interval se i salvataggi causano picchi di lag periodici su mondi molto grandi.
• Se le prestazioni rimangono scarse dopo l'ottimizzazione, considera di contattare il supporto per un upgrade del tuo piano server.

Corruzione del Salvataggio

• Se il server crasha durante un salvataggio automatico, il file di salvataggio potrebbe corrompersi.
• Ripristina da un backup manuale SFTP se disponibile. Consulta Guida alla Configurazione del Server Foundry per le istruzioni di ripristino.
• Se non esiste un backup, prova a passare a un nuovo server_world_name per ricominciare da zero mantenendo il salvataggio corrotto nel caso un futuro aggiornamento possa recuperarlo.
• I backup regolari tramite SFTP sono la migliore protezione contro la corruzione dei salvataggi. Esegui il backup della cartella del mondo almeno una volta per sessione di gioco.

Articoli Correlati

• Guida alla Configurazione del Server Foundry
• 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 con il tuo server Foundry non coperti qui, apri un ticket di supporto e includi l'IP del tuo server, una descrizione del problema e qualsiasi messaggio di errore rilevante dalla console GPanel.