Questa guida copre la configurazione admin, i comandi da console, il supporto mod, la gestione dei giocatori, i wipe del server e la risoluzione dei problemi per il tuo server dedicato CryoFall. CryoFall è un gioco di sopravvivenza e colonizzazione sci-fi su un pianeta alieno ostile, con alberi tecnologici, agricoltura, crafting e gameplay PvP/PvE. Per la configurazione iniziale del server, la configurazione e le istruzioni di connessione, consulta Guida alla Configurazione del Server CryoFall.

1. Configurazione Admin

CryoFall utilizza un modello di operatore del server in cui i privilegi di amministrazione vengono concessi tramite file di configurazione anziché comandi in gioco.

Aggiunta di Operatori del Server

Per concedere l'accesso admin ai giocatori sul tuo server:

1. Ferma il server da GPanel.
2. Apri il file della lista operatori nella directory Data/ tramite la scheda Files o SFTP.
3. Aggiungi il nome account o l'ID CryoFall del giocatore alla lista operatori.
4. Salva il file e riavvia il server.

Gli operatori del server hanno accesso agli strumenti admin inclusa la possibilità di espellere, bannare e gestire il mondo dall'interno del gioco.

2. Comandi da Console

CryoFall fornisce comandi da console accessibili tramite la console di GPanel e in gioco per gli operatori. Di seguito i comandi principali per la gestione del server.

3. Supporto Mod (ModsConfig.xml)

CryoFall supporta mod lato server che possono modificare il gameplay, aggiungere contenuti o cambiare il comportamento del server.

Installazione dei Mod

1. Ferma il server da GPanel.
2. Scarica i mod desiderati dalla community di modding di CryoFall o dallo Steam Workshop.
3. Carica i file dei mod nella directory Mods/ del server tramite SFTP. Consulta Come Caricare File tramite SFTP per le istruzioni.
4. Modifica il file ModsConfig.xml nella directory Data/ per registrare i mod.
5. Avvia il server. Controlla la console per la conferma che i mod siano stati caricati con successo.

Formato di ModsConfig.xml

<ModsConfig>
  <Mods>
    <Mod>ModFolderName1</Mod>
    <Mod>ModFolderName2</Mod>
  </Mods>
</ModsConfig>

Ogni voce <Mod> corrisponde a un nome di cartella all'interno della directory Mods/. L'ordine di caricamento segue l'ordine elencato nel file XML.

4. Gestione dei Giocatori

Espulsione e Ban

• Usa /player.kick <name> per rimuovere immediatamente un giocatore problematico.
• Usa /player.ban <name> per impedire permanentemente a un giocatore di riconnettersi.
• Usa /player.unban <name> per annullare un ban.
• La lista dei ban persiste tra i riavvii del server.

Protezione con Password

Per server privati, abilita la protezione con password in ServerSettings.yml:

IsPasswordProtected: true
ServerPassword: "YourSecretPassword"

Condividi la password solo con giocatori fidati. Riavvia il server dopo aver modificato le impostazioni della password.

5. Wipe del Server

I server PvP traggono spesso beneficio da wipe periodici per resettare l'economia e dare a tutti i giocatori un nuovo inizio.

Eseguire un Wipe Completo

1. Ferma il server da GPanel.
2. Effettua il backup della directory Data/ tramite SFTP (nel caso volessi ripristinare in seguito).
3. Elimina i file di salvataggio del mondo dalla directory Data/. Conserva i file di configurazione come ServerSettings.yml e ModsConfig.xml se vuoi preservare le tue impostazioni.
4. Avvia il server. Un nuovo mondo verrà generato con la tua configurazione esistente.

Wipe Programmati

Per wipe ricorrenti, stabilisci un programma e comunicalo ai tuoi giocatori:

• I programmi comuni sono settimanali (PvP competitivo) o bisettimanali (equilibrato).
• Annuncia le date dei wipe nella descrizione del tuo server o attraverso un Discord della community.
• Effettua i wipe durante le ore di bassa attività per minimizzare i disagi.

6. Risoluzione dei Problemi

Il Server Crasha all'Avvio

• Controlla la console di GPanel per i messaggi di errore. Le cause comuni includono sintassi YAML malformata (indentazione errata, due punti mancanti o caratteri di tabulazione invece di spazi).
• Se hai aggiunto mod di recente, prova a rimuoverli da ModsConfig.xml per verificare se un mod sta causando il crash.
• Elimina ServerSettings.yml e riavvia per rigenerare una configurazione predefinita.
• 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 e controlla la console per eventuali errori.
• Conferma che il giocatore stia usando l'IP e la porta corretti dalla scheda Network di GPanel.
• Controlla che la password del server sia corretta se la protezione con password è abilitata.
• Assicurati che sia il server che il client stiano eseguendo la stessa versione di CryoFall.
• Se usi mod, conferma che il giocatore abbia installato i mod lato client richiesti.

Crash Relativi ai Mod

• Rimuovi i mod aggiunti di recente uno alla volta per identificare quello problematico.
• Verifica la compatibilità dei mod con la tua versione attuale di CryoFall.
• Assicurati che il file ModsConfig.xml abbia una sintassi XML valida senza errori di battitura nei nomi delle cartelle dei mod.
• Ripristina da un backup pre-mod se il mondo si è corrotto.

Problemi di Prestazioni

• Riduci MaxPlayers se il server ha difficoltà con molti giocatori simultanei.
• Un gran numero di strutture e rivendicazioni territoriali dei giocatori può influire sulle prestazioni nel tempo. I wipe programmati aiutano a resettare questo aspetto.
• Verifica se i mod installati sono noti per causare problemi di prestazioni.
• Se le prestazioni rimangono scarse, contatta il supporto per informazioni sull'upgrade del tuo piano server.

Articoli Correlati

• Guida alla Configurazione del Server CryoFall
• 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 CryoFall 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 rilevante dalla console di GPanel.