Questa guida copre i problemi comuni con i server dedicati Icarus e come risolverli, inclusi errori di avvio del server, problemi di connessione, problemi di caricamento dei Prospect, ottimizzazione delle prestazioni ed errori di mismatch delle versioni. Per la configurazione iniziale del server, consulta Guida alla Configurazione del Server Icarus.

Problemi di Avvio del Server

Se il tuo server Icarus non riesce ad avviarsi o crasha immediatamente dopo l'avvio, segui questi passaggi per diagnosticare e risolvere il problema.

Il Server si Spegne Immediatamente Dopo l'Avvio

La causa più comune dello spegnimento di un server Icarus poco dopo l'avvio è l'impostazione ShutdownIfNotJoinedFor. Per impostazione predefinita, è impostata su 300 secondi (5 minuti), il che significa che il server si spegnerà automaticamente se nessun giocatore entra entro 5 minuti dall'avvio.

Soluzione:

1. Ferma il server dalla scheda Console in GPanel.
2. Apri ServerSettings.ini situato in Icarus/Saved/Config/WindowsServer/ServerSettings.ini tramite la scheda Files di GPanel o SFTP.
3. Imposta i seguenti valori per prevenire lo spegnimento automatico:

   ShutdownIfNotJoinedFor=-1
   ShutdownIfEmptyFor=-1

4. Salva il file e avvia il server.

Il Server Non si Avvia (Crash all'Avvio)

Se il server crasha durante l'avvio con messaggi di errore nella console:

1. Controlla i file corrotti: Prova a reinstallare il server. In GPanel, usa l'opzione di reinstallazione per riscaricare tutti i file del server da Steam.
2. Controlla la sintassi del file di configurazione: Un ServerSettings.ini malformato può impedire l'avvio. Verifica che il file segua il formato INI corretto:

   [/Script/Icarus.DedicatedServerSettings]
   SessionName=My Server
   JoinPassword=
   MaxPlayers=8

3. Controlla i dati del Prospect mancanti: Se LoadProspect o LastProspectName fanno riferimento a un Prospect che non esiste più, il server potrebbe non avviarsi. Cancella questi campi e imposta temporaneamente ResumeProspect=False.
4. Controlla i log del server: Esamina i file di log in Icarus/Saved/Logs/ per messaggi di errore specifici che indicano la causa del crash.

Il Server si Avvia ma Non Appare nel Browser

Se il server si avvia correttamente ma non appare nel browser dei server in gioco:

• Attendi 2-5 minuti. I nuovi server hanno bisogno di tempo per registrarsi nella lista dei server master di Steam.
• Controlla -SteamServerName. L'impostazione SessionName in ServerSettings.ini non controlla il nome nel browser. Il parametro da riga di comando -SteamServerName deve essere impostato tramite la scheda Startup di GPanel.
• Verifica le porte. Assicurati che la porta di gioco e la porta di query siano assegnate correttamente. Controlla che la porta di query (predefinita 27015) sia accessibile.
• Usa la connessione diretta. Mentre il server si registra nel browser, puoi connetterti direttamente usando IP:PORT (es. 192.168.1.100:17777).

I Giocatori Non Riescono a Connettersi

Se i giocatori non riescono a connettersi al tuo server, segui questi passaggi di risoluzione dei problemi.

Timeout della Connessione / Server Non Risponde

1. Verifica che il server sia in esecuzione. Controlla la scheda Console di GPanel per confermare che il server è online e non è in stato di crash o fermo.
2. Controlla l'IP e la porta corretti. I giocatori devono usare la porta di gioco (predefinita 17777), non la porta di query. Trova l'IP e la porta del tuo server dalla scheda Console di GPanel. Per istruzioni dettagliate, consulta Come Trovare l'IP e la Porta del Tuo Server.
3. Controlla la password. Se è impostata una JoinPassword, i giocatori devono inserirla al momento della connessione. Verifica che la password sia corretta e condivisa con i tuoi giocatori.
4. Controlla il numero di giocatori. Se il server è pieno (massimo 8 giocatori per impostazione predefinita), altri giocatori non possono entrare fino a quando qualcuno non esce.
5. Riavvia il server. Se il server è in esecuzione da molto tempo, un riavvio può risolvere problemi di connessione causati da sessioni obsolete.

Schermata "Connessione in corso..." Infinita

Se i giocatori rimangono bloccati su una schermata "Connessione in corso..." infinita nel menu principale:

1. Fai aprire al giocatore il Prompt dei comandi come Amministratore ed eseguire i seguenti comandi:

   netsh winsock reset
   netsh int ip reset
   ipconfig /flushdns

2. Riavvia il computer dopo aver eseguito questi comandi.
3. Avvia nuovamente Icarus e prova a connetterti.

Errore Client: "Invalid Prospect Information - 001"

Questo errore indica un mismatch di versione tra il client e il server. Consulta la sezione Mismatch delle Versioni qui sotto per i passaggi di risoluzione.

Problemi di Caricamento dei Prospect

I problemi con il caricamento, la creazione o la ripresa dei Prospect sono tra i più comuni nei server Icarus.

Schermata di Caricamento Infinita Quando si Carica un Prospect

Se il gioco rimane bloccato su una schermata di caricamento infinita quando si tenta di caricare un Prospect:

1. Verifica che il file del Prospect esista. Controlla che il file di salvataggio del Prospect sia presente in Icarus/Saved/PlayerData/DedicatedServer/Prospects/.
2. Controlla i dati di salvataggio corrotti. Se il file del Prospect è corrotto, potrebbe non caricarsi correttamente. Prova a caricare un Prospect diverso o a crearne uno nuovo.
3. Cancella la cache del client. Sul computer del giocatore, verifica la cache del gioco tramite Steam:
   • Clicca con il tasto destro su Icarus nella Libreria Steam
   • Seleziona Proprietà > File installati
   • Clicca su Verifica integrità dei file di gioco
4. Riavvia il server. Ferma e riavvia il server da GPanel. Questo forza il server a rileggere i dati del Prospect.

Impossibile Creare o Avviare un Nuovo Prospect

Se i giocatori o gli admin non riescono a creare nuovi Prospect:

• Controlla i permessi. Se AllowNonAdminsToLaunchProspects è impostato su False, solo i giocatori autenticati come admin possono creare Prospect. Modifica questa impostazione su True oppure fai autenticare il giocatore come admin prima con /AdminLogin [password].
• Controlla il formato di CreateProspect. Assicurati che il comando o l'impostazione nella configurazione usi il formato corretto: CreateProspect [ProspectType] [Difficulty] [Hardcore] [SaveName]. Un nome di tipo Prospect errato fallirà silenziosamente.
• Controlla se esiste un Prospect attivo. Se un Prospect è già caricato, potrebbe essere necessario terminarlo o eliminarlo prima di crearne uno nuovo.

Il Prospect Non Riprende Dopo il Riavvio del Server

Se il server si riavvia ma non riprende il Prospect precedente:

1. Verifica che ResumeProspect=True sia impostato in ServerSettings.ini.
2. Controlla che LastProspectName contenga il nome corretto del Prospect. Questo viene compilato automaticamente ma può corrompersi se il server non si è spento correttamente.
3. Se il nome del Prospect è mancante, imposta manualmente LoadProspect=[name] al file del Prospect che vuoi caricare.

Ottimizzazione delle Prestazioni

Se il tuo server Icarus presenta lag, stuttering o prestazioni scadenti, prova questi passaggi di ottimizzazione.

Ottimizzazione Lato Server

• Riduci MaxPlayers. Se riscontri lag con il massimo di 8 giocatori, prova a ridurre a 4-6 per alleggerire il carico.
• Riavvia regolarmente. Programma riavvii regolari del server per liberare la memoria e lo stato accumulato. Un riavvio ogni 12-24 ore è raccomandato per i server attivi.
• Monitora l'utilizzo delle risorse. Controlla l'utilizzo di CPU e RAM del server in GPanel. Se le risorse sono costantemente al massimo, considera l'upgrade del tuo piano di hosting.
• Riduci la densità delle costruzioni. Basi grandi e complesse con molti oggetti piazzati influiscono significativamente sulle prestazioni del server. Incoraggia i giocatori a costruire in modo efficiente.

Ottimizzazione Lato Client

Se singoli giocatori riscontrano prestazioni scadenti, consiglia queste regolazioni delle impostazioni:

• Aumenta il campo visivo (FOV). Un FOV più alto può paradossalmente migliorare il frame rate in alcuni scenari.
• Riduci la qualità delle ombre. Le ombre sono una delle impostazioni grafiche più esigenti in termini di prestazioni.
• Usa DirectX 11. DirectX 12 è utile solo con illuminazione RTX su GPU Nvidia di fascia alta. La maggior parte dei giocatori otterrà prestazioni migliori con DX11.
• Abilita DLSS (Nvidia) o FSR (AMD). DLSS offre un miglioramento significativo delle prestazioni sulle schede Nvidia. FSR funziona sia su schede AMD che Nvidia (anche se DLSS è preferibile su Nvidia).
• Riduci la distanza di visualizzazione. Ridurre la distanza di rendering diminuisce il numero di oggetti che il client deve elaborare.

Mismatch delle Versioni

Gli errori di mismatch delle versioni si verificano quando il client e il server eseguono versioni diverse di Icarus. Questo è uno dei problemi di connessione più comuni, specialmente dopo gli aggiornamenti del gioco.

Errore: "Host is running newer Version than Client" / "Invalid prospect information - 001"

Questi errori indicano che il server è stato aggiornato ma il client del giocatore no (o viceversa).

Correzione del Mismatch di Versione del Client:

1. Chiudi completamente Icarus.
2. Apri Steam e controlla gli aggiornamenti del gioco. Gli aggiornamenti di Icarus dovrebbero scaricarsi automaticamente.
3. Se non appare nessun aggiornamento, clicca con il tasto destro su Icarus nella Libreria Steam > Proprietà > File installati > Verifica integrità dei file di gioco.
4. Riavvia Steam se l'aggiornamento non appare ancora.
5. Una volta aggiornato, avvia Icarus e prova a connetterti nuovamente.

Correzione del Mismatch di Versione del Server:

1. Se il server esegue una versione obsoleta, riavvialo da GPanel. Il server dovrebbe aggiornarsi automaticamente all'ultima versione quando si avvia.
2. Se il server non si aggiorna automaticamente, prova l'opzione di reinstallazione in GPanel per forzare un nuovo download dei file del server.
3. Dopo il completamento dell'aggiornamento, verifica che la versione del server corrisponda a quella del client.

Messaggi di Errore Comuni

Riferimento rapido per i messaggi di errore comuni e le relative soluzioni:

Checklist Generale di Risoluzione dei Problemi

Quando risolvi qualsiasi problema con il tuo server Icarus, segui questa checklist:

1. Controlla lo stato del server in GPanel. Conferma che il server sia in esecuzione e non sia in stato di crash o fermo.
2. Esamina la console del server. Cerca messaggi di errore o avvisi nella scheda Console di GPanel.
3. Controlla i log del server. Naviga fino a Icarus/Saved/Logs/ per l'output dettagliato dei log.
4. Verifica la sintassi del file di configurazione. Assicurati che ServerSettings.ini sia formattato correttamente senza errori di battitura o caratteri extra.
5. Verifica che le versioni corrispondano. Sia il client che il server devono eseguire la stessa versione di Icarus.
6. Prova un riavvio del server. Molti problemi transitori si risolvono con un riavvio pulito da GPanel.
7. Verifica i file di gioco sul client. Fai verificare ai giocatori l'integrità dei file di gioco tramite Steam.
8. Controlla ShutdownIfNotJoinedFor. Assicurati che sia impostato su -1 per prevenire lo spegnimento automatico.
9. Prova una reinstallazione completa. Come ultima risorsa, reinstalla il server tramite GPanel per ottenere file del server nuovi.

Articoli Correlati

• Guida alla Configurazione del Server Icarus
• Come Trovare l'IP e la Porta del Tuo Server
• Come Caricare File tramite SFTP
• Guida Introduttiva al Tuo Nuovo Server

Hai Bisogno di Aiuto?

Se hai provato i passaggi sopra indicati e riscontri ancora problemi con il tuo server Icarus, apri un ticket di supporto e il nostro team sarà lieto di assisterti.