Questa guida copre i controlli admin e host per il tuo server dedicato Portal Knights, inclusa la gestione dei giocatori, la gestione del mondo e la risoluzione dei problemi comuni. Per la configurazione iniziale del server, consulta Guida alla Configurazione del Server Portal Knights.

1. Privilegi Admin / Host

In Portal Knights, il proprietario del server (l'account che ha creato il mondo) ha privilegi a livello di host. Su un server dedicato, i controlli admin sono gestiti tramite:

• File di configurazione del server: Controlla le impostazioni a livello di server come PvP, difficoltà e numero massimo di giocatori.
• Console GPanel: Avvia, arresta e riavvia il server; visualizza log e output.
• Menu host in-game: Il giocatore host può espellere giocatori e gestire le impostazioni di base della sessione.

Configurazione dell'Accesso Admin

Il primo giocatore a unirsi al server dopo la creazione di un nuovo mondo viene tipicamente assegnato come host. Per assicurarti di avere accesso admin:

1. Avvia il server da GPanel.
2. Sii il primo giocatore a connetterti al server.
3. Avrai i controlli a livello di host nel menu di pausa in-game.

2. Gestione dei Giocatori

Espellere Giocatori

In qualità di host, puoi rimuovere giocatori dirompenti dal tuo server:

1. Apri il menu di pausa in-game mentre sei connesso al tuo server.
2. Naviga nell'elenco dei giocatori.
3. Seleziona il giocatore che vuoi rimuovere.
4. Scegli Kick per rimuoverlo dalla sessione.

Utilizzo di una Password del Server

Il modo più efficace per controllare chi può unirsi al tuo server è tramite una password. Impostala nella scheda Startup di GPanel o nel file di configurazione del server:

"admins": { "credentials": { "password": "YourSecretPassword" } }

Solo i giocatori che conoscono la password possono connettersi. Cambia la password e riavvia il server per bloccare immediatamente i giocatori indesiderati.

Giocatori Massimi

Portal Knights supporta fino a 4 giocatori in co-op. Controlla il numero di giocatori tramite:

"users": { "credentials": { "password": "user_password" } }

Imposta questo valore più basso se desideri una dimensione del gruppo più controllata (ad es., 2 per il gioco in coppia).

3. Gestione del Mondo

Cambio Mondi

Puoi eseguire più mondi sullo stesso server modificando l'impostazione world_name:

1. Arresta il server da GPanel.
2. Vai alla scheda Startup e cambia la variabile WORLD_NAME, oppure modifica il file di configurazione:

   "basicServerData": { "saveFolderPath": "./my_new_world_saves" }

3. Avvia il server. Se il mondo non esiste, ne verrà creato uno nuovo automaticamente.

Reset di un Mondo

Per resettare completamente il tuo mondo e ricominciare da capo:

1. Arresta il server da GPanel.
2. Connettiti tramite SFTP (consulta Come Caricare File tramite SFTP).
3. Naviga nella directory dedicated_server/savedata/.
4. Elimina o rinomina la cartella del mondo che corrisponde alla tua impostazione world_name.
5. Avvia il server. Un nuovo mondo verrà generato automaticamente.

Backup dei Mondi

1. Arresta il server da GPanel.
2. Connettiti tramite SFTP e naviga in dedicated_server/savedata/.
3. Scarica l'intera cartella del mondo sul tuo computer locale.
4. Conserva il backup in un luogo sicuro con un nome descrittivo (ad es., default_backup_2026-02-26).

Ripristinare un Backup

1. Arresta il server da GPanel.
2. Connettiti tramite SFTP e naviga in dedicated_server/savedata/.
3. Carica la tua cartella di backup, assicurandoti che il nome della cartella corrisponda all'impostazione world_name.
4. Avvia il server da GPanel.

4. Impostazioni di Difficoltà e PvP

Cambiare la Difficoltà

La difficoltà del mondo viene impostata al momento della creazione. Per cambiare la difficoltà, devi creare un nuovo mondo:

Attivazione/Disattivazione del PvP

La modalità di gioco può essere modificata aggiornando la variabile di avvio GAMEMODE in GPanel. Le opzioni sono Adventure e Creative:

"gameplayMode": "Creative"

Imposta su false per disabilitare il danno giocatore contro giocatore. Riavvia il server dopo aver apportato modifiche.

5. Monitoraggio del Server

Output della Console

La scheda Console di GPanel visualizza l'output del server in tempo reale incluso:

• Connessioni e disconnessioni dei giocatori
• Eventi di salvataggio del mondo
• Messaggi di errore e avvisi
• Modifiche dello stato del server

Riavviare il Server

Se il server non risponde o devi applicare modifiche alla configurazione:

1. Vai alla scheda Console in GPanel.
2. Clicca Stop e attendi che il server si spenga completamente.
3. Clicca Start per riportare il server online.

6. Risoluzione dei Problemi

I Giocatori Non Possono Connettersi

• Verifica che il server sia in esecuzione in GPanel.
• Controlla che la password del server non sia stata cambiata inaspettatamente.
• Conferma l'IP e la porta del server dalla scheda Network di GPanel. Consulta Come Trovare l'IP e la Porta del Tuo Server.
• Assicurati che il server non abbia raggiunto il limite di max_players.

Crash del Server

• Controlla la console di GPanel per i messaggi di errore prima del crash.
• Prova a eliminare il file di configurazione e riavviare per rigenerare i valori predefiniti.
• Se il crash è correlato a un mondo corrotto, prova a caricare un mondo diverso o ripristina da un backup.
• Se i crash persistono, apri un ticket di supporto con i messaggi di errore dalla console.

Privilegi di Host Persi

• Riavvia il server e sii il primo giocatore a connetterti.
• Se il problema persiste, arresta il server, verifica che il tuo file di configurazione sia corretto e avvia di nuovo il server.

Articoli Correlati

• Guida alla Configurazione del Server Portal Knights
• 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 incontri problemi non trattati qui, apri un ticket di supporto e includi l'IP del tuo server, una descrizione del problema e qualsiasi messaggio di errore dalla console di GPanel.