Questa guida spiega come configurare il tuo server dedicato Foundry su Legion Hosting, impostare le variabili di avvio, modificare il file delle impostazioni del server, configurare la generazione del mondo, connettersi al server e gestire salvataggi e backup. Foundry è un gioco di costruzione di fabbriche basato su voxel in cui i giocatori estraggono risorse, costruiscono linee di produzione automatizzate ed espandono enormi fabbriche in un mondo generato proceduralmente. Per i controlli di amministrazione, la gestione dei giocatori e la risoluzione dei problemi, consulta Foundry Admin and Server Management.

1. Primo Avvio

1. Accedi a GPanel e seleziona il tuo server Foundry.
2. Vai alla scheda Startup e controlla le variabili configurabili (vedi la tabella nella Sezione 2).
3. Imposta SERVER_NAME con un nome per il tuo server. Questo appare nel browser dei server di Steam.
4. Imposta SRV_PW se vuoi limitare l'accesso. Lascialo vuoto per un server pubblico.
5. Opzionalmente imposta un MAP_SEED per controllare la generazione del mondo. Lascia vuoto per un seed casuale.
6. Torna alla scheda Console e clicca Start.
7. Attendi che la console confermi l'avvio del server. Il primo avvio potrebbe richiedere un paio di minuti mentre il server genera il mondo e crea i file di configurazione iniziali.

2. Variabili di Avvio di GPanel

Le seguenti variabili sono disponibili nella scheda Startup di GPanel. Queste vengono passate al server ad ogni avvio.

3. File di Configurazione del Server

Per impostazioni avanzate oltre a quelle offerte dalle variabili di avvio, puoi modificare direttamente il file di configurazione del server. Ferma il server prima di apportare modifiche.

Posizione del File

App.cfg

Apri questo file usando la scheda Files in GPanel o connettiti tramite SFTP. Il file utilizza un semplice formato key=value con un'impostazione per riga. Se il file non esiste, avvia e ferma il server una volta per generarlo.

Impostazioni Principali in App.cfg

Esempio di Configurazione

server_name=My Legion Factory
server_password=
server_world_name=MyFoundry
server_max_players=16
server_is_public=true
server_port=3724
server_query_port=27015
map_seed=48293175
autosave_interval=300
pause_server_when_empty=true

4. Generazione del Mondo

Foundry utilizza la generazione procedurale del mondo per creare il suo terreno voxel. Il mondo è generato da un numero seed, che determina il layout del terreno, i depositi di minerali e i biomi.

Seed della Mappa

• Imposta il valore map_seed in App.cfg o la variabile di avvio MAP_SEED su qualsiasi numero intero.
• Usare lo stesso seed produce sempre lo stesso layout del mondo, il che è utile se vuoi condividere un mondo specifico con altri o ricreare un mondo dopo un reset.
• Lascia il seed vuoto o omettilo completamente per lasciare che il server generi un mondo casuale.
• Il seed influisce solo sulla generazione iniziale del mondo. Cambiare il seed su un mondo esistente non ha effetto -- devi creare un nuovo mondo (cambiare server_world_name) affinché un nuovo seed abbia effetto.

Nome del Mondo e Mondi Multipli

L'impostazione server_world_name determina quale cartella di salvataggio usa il server. Puoi mantenere più mondi passando da un nome del mondo all'altro:

• Ogni server_world_name univoco crea un mondo separato con i propri dati di salvataggio, stato della fabbrica e progressi dei giocatori.
• Per cambiare mondo, ferma il server, modifica il server_world_name in App.cfg e riavvia.
• I mondi precedenti vengono conservati e possono essere caricati nuovamente tornando al loro nome.

Pausa Quando Vuoto

L'opzione pause_server_when_empty controlla se la tua fabbrica continua a funzionare quando nessun giocatore è online:

• true (predefinito) -- Il mondo si mette in pausa quando tutti i giocatori si disconnettono. Le fabbriche smettono di produrre, le risorse smettono di essere consumate. Ideale per risparmiare risorse del server e mantenere lo stato di gioco prevedibile.
• false -- La fabbrica continua a funzionare 24/7. Le linee di produzione continuano, le risorse si accumulano e il mondo progredisce anche quando nessuno sta giocando. Può aumentare l'utilizzo delle risorse del server.

5. Come Connettersi

Opzione A -- Browser dei Server di Steam

1. Avvia Foundry.
2. Dal menu principale, seleziona Multiplayer.
3. Clicca Join Game per aprire il browser dei server.
4. Usa la barra di ricerca per trovare il tuo server per nome.
5. Seleziona il tuo server e clicca Join. Inserisci la password del server se ne è stata impostata una.

Opzione B -- Connessione Diretta

1. Avvia Foundry.
2. Dal menu principale, seleziona Multiplayer.
3. Scegli l'opzione Direct Connect.
4. Inserisci l'indirizzo IP e la porta del tuo server dalla scheda Network di GPanel:

   <your-server-ip>:<port>

5. Inserisci la password del server se richiesto e clicca Connect.

6. Gestione dei Salvataggi

Salvataggio Automatico

Il server salva automaticamente all'intervallo specificato da autosave_interval in App.cfg (predefinito: ogni 300 secondi / 5 minuti). I salvataggi automatici di Foundry non sono invasivi e non causano rallentamenti evidenti per la maggior parte delle dimensioni delle fabbriche.

Posizione dei File di Salvataggio

I file di salvataggio sono memorizzati sul server nel percorso specificato da server_persistent_data_override_folder in App.cfg. Il percorso predefinito è:

serverfiles/

Questa directory contiene l'intero stato del mondo incluse le modifiche al terreno, le strutture posizionate, le macchine della fabbrica, i nastri trasportatori e gli inventari dei giocatori.

Backup Manuali tramite SFTP

1. Ferma il server da GPanel per assicurarti che tutti i dati siano scritti su disco.
2. Connettiti al tuo server tramite SFTP. Consulta How to Upload Files via SFTP per le istruzioni.
3. Scarica l'intera directory di salvataggio del tuo mondo (es. serverfiles/).
4. Conserva il backup in un luogo sicuro sul tuo computer.

Ripristino di un Salvataggio

1. Ferma il server da GPanel.
2. Connettiti tramite SFTP e naviga alla directory serverfiles/.
3. Carica la directory del mondo di cui hai fatto il backup, sostituendo quella esistente.
4. Assicurati che il nome della cartella corrisponda al server_world_name in App.cfg.
5. Avvia il server da GPanel. Il server caricherà il salvataggio ripristinato.

7. Suggerimenti per le Prestazioni

Foundry è un gioco di costruzione di fabbriche e le prestazioni del server sono direttamente influenzate dalla complessità della fabbrica. Tieni a mente questi suggerimenti man mano che la tua fabbrica cresce:

• Complessità della fabbrica: Grandi quantità di macchine, nastri trasportatori e reti logistiche aumentano il carico di tick del server. Se noti rallentamenti, considera di consolidare o ottimizzare le catene di produzione.
• Caricamento dei chunk: Il server elabora tutti i chunk caricati. Più aree attive della fabbrica distribuite sulla mappa significano più chunk da simulare. Mantenere la fabbrica compatta riduce il numero di chunk che il server deve tracciare.
• Numero di giocatori: Più giocatori connessi significano più chunk caricati intorno a ciascun giocatore. Se le prestazioni si degradano con molti giocatori, considera di ridurre server_max_players.
• Frequenza del salvataggio automatico: Salvataggi automatici molto frequenti (sotto i 60 secondi) su mondi grandi possono causare rallentamenti periodici. Il valore predefinito di 300 secondi è generalmente adeguato, ma puoi aumentarlo se necessario.
• Pausa quando vuoto: Abilitare pause_server_when_empty=true previene simulazioni non necessarie quando nessuno sta giocando, il che aiuta a mantenere prestazioni costanti durante le sessioni di gioco attive.

Articoli Correlati

• Foundry Admin and Server Management
• How to Find Your Server IP and Port
• How to Upload Files via SFTP
• Server Startup Guide

Hai Bisogno di Aiuto?

Se riscontri problemi con il tuo server Foundry che non sono trattati qui, apri un ticket di supporto e includi l'IP del tuo server, una descrizione del problema e qualsiasi messaggio di errore pertinente dalla console di GPanel.