Questa guida copre la configurazione admin, la gestione dei giocatori, i comandi della console del server, la gestione della rotazione delle mappe, il cambio della modalità di gioco, il supporto modding e la risoluzione dei problemi per il tuo server dedicato Mount & Blade II: Bannerlord. Per la configurazione iniziale del server, la configurazione della modalità di gioco, la selezione della mappa, le impostazioni delle fazioni e le istruzioni di connessione, vedi Guida alla Configurazione del Server Mount and Blade II Bannerlord.

1. Configurazione Admin

Impostazione della Password Admin

La password admin viene impostata tramite la variabile di avvio ADMIN_PASSWORD in GPanel, o nel file di configurazione utilizzando il comando AdminPassword:

AdminPassword YourAdminPassword

Questa password è richiesta sia per l'interfaccia web admin che per l'accesso admin in-game.

Accesso al Pannello Web Admin

Bannerlord include un pannello web admin integrato alimentato dal modulo DedicatedCustomServerHelper.

1. Trova l'indirizzo IP e la porta del tuo server nella scheda Network di GPanel.
2. Apri un browser web e naviga a:

   http://<your-server-ip>:<port>

   Il pannello web viene eseguito sulla stessa porta del server di gioco (predefinito UDP 7210). Controlla la scheda Network di GPanel per la porta esatta.

3. Inserisci la tua password admin quando richiesto.

Accesso Admin In-Game

1. Unisciti al tuo server come giocatore normale.
2. Apri la console di gioco con Alt + ~ (tasto tilde).
3. Digita Help per vedere i comandi disponibili.
4. Potresti dover autenticarti con la password admin tramite il menu admin in-game se richiesto.

2. Comandi della Console del Server

I seguenti comandi possono essere utilizzati nella console del server (console di GPanel) o nel pannello web admin. Digita Help o list nella console per vedere tutti i comandi disponibili.

Comandi di Gestione del Server

3. Gestione dei Giocatori

Espulsione dei Giocatori

Per rimuovere un giocatore dal server:

• Web Admin: Naviga alla sezione Players nel pannello web admin, trova il giocatore e clicca su Kick.
• Comando di chat: Apri la chat in-game e digita:

  !kick <playername>

I giocatori espulsi possono rientrare immediatamente a meno che non li banni anche o imposti una password del server.

Ban dei Giocatori

Per impedire permanentemente a un giocatore di unirsi:

• Web Admin: Utilizza l'opzione ban nella sezione Players del pannello web admin.
• Comando di chat: Apri la chat in-game e digita:

  !ban <playername>

I ban persistono attraverso i riavvii del server.

Rimozione del Ban dei Giocatori

Per rimuovere un ban e consentire a un giocatore di rientrare:

!unban <playername>

Silenziamento dei Giocatori

Per impedire a un giocatore di utilizzare la chat in-game:

• Utilizza l'opzione mute nel pannello web admin.
• I giocatori silenziati possono ancora giocare ma non possono inviare messaggi in chat.

4. Gestione della Rotazione delle Mappe

Cambio della Mappa Corrente

Per cambiare la mappa durante il gameplay, utilizza il pannello web admin o modifica il file di configurazione e riavvia il server. Le mappe devono corrispondere alla modalità di gioco corrente.

Modifica della Rotazione delle Mappe

La rotazione delle mappe è definita nel file di configurazione della tua modalità di gioco. Per cambiarla:

1. Arresta il server da GPanel.
2. Apri il file di configurazione (es. Modules/Native/siege_config.txt).
3. Modifica le righe add_map_to_automated_battle_pool per aggiungere o rimuovere mappe.
4. Assicurati che enable_automated_battle_switching sia presente se vuoi la rotazione automatica.
5. Salva e riavvia il server.

Modalità a Mappa Singola

Per eseguire una singola mappa senza rotazione, includi solo una riga add_map_to_automated_battle_pool e ometti enable_automated_battle_switching. La stessa mappa si ripeterà ad ogni round.

5. Cambio della Modalità di Gioco

Il cambio della modalità di gioco richiede l'aggiornamento sia dell'impostazione GameType che del pool di mappe, poiché le mappe sono specifiche per modalità.

1. Arresta il server da GPanel.
2. Apri il file di configurazione e cambia la riga GameType:

   GameType Siege

3. Sostituisci le righe add_map_to_automated_battle_pool con mappe compatibili con la nuova modalità. Vedi la Guida alla Configurazione per gli elenchi delle mappe.
4. Salva il file e avvia il server.

6. Supporto Modding

Bannerlord supporta moduli personalizzati (mod) sui server dedicati. Le mod possono aggiungere nuove mappe, modalità di gioco, armi, tipi di truppe e meccaniche di gameplay.

Installazione delle Mod

1. Arresta il server da GPanel.
2. Connettiti al tuo server tramite SFTP. Vedi Come Caricare File tramite SFTP per le istruzioni.
3. Naviga alla directory Modules/.
4. Carica la cartella della mod in Modules/. Ogni mod dovrebbe trovarsi nella propria directory con un file SubModule.xml.
5. Aggiorna il comando di avvio del server o il file batch per includere la mod nell'elenco dei moduli. Il parametro _MODULES_ nella configurazione di avvio deve fare riferimento a tutti i moduli attivi:

   Native*Multiplayer*DedicatedCustomServerHelper*YourModName

   I moduli sono separati da asterischi (*). L'ordine di caricamento è importante -- posiziona le mod dipendenti dopo i loro prerequisiti.

6. Avvia il server.

Mod di Steam Workshop

Bannerlord supporta Steam Workshop per la distribuzione delle mod. Per installare mod del Workshop su un server dedicato:

1. Iscriviti alla mod su Steam Workshop da un'installazione regolare di Bannerlord.
2. Individua la cartella della mod scaricata nella directory Modules/ della tua installazione locale di Bannerlord.
3. Carica la cartella della mod nella directory Modules/ del tuo server dedicato tramite SFTP.
4. Aggiungi il nome del modulo all'elenco dei moduli di avvio.

Modulo DedicatedCustomServerHelper

Questo modulo integrato fornisce il pannello web admin. Deve essere sempre incluso nell'elenco dei moduli. Se incontri errori di mancata corrispondenza della versione dopo un aggiornamento di gioco:

1. Arresta il server.
2. Naviga a Modules/DedicatedCustomServerHelper/.
3. Apri SubModule.xml.
4. Aggiorna il valore Version per corrispondere alla versione di gioco corrente.
5. Aggiorna di conseguenza i valori di versione di qualsiasi DependedModule.
6. Salva e riavvia il server.

7. Risoluzione dei Problemi

Il Server si Blocca all'Avvio

• Controlla l'output della console per messaggi di errore. Le cause comuni includono:
  • Token di autenticazione mancante o scaduto -- contatta il supporto se vedi errori di token.
  • Configurazione AdminPassword non valida -- assicurati che la riga AdminPassword esista e abbia un valore.
  • Sintassi del file di configurazione malformata -- ogni comando deve essere sulla propria riga senza caratteri finali.
  • Mancata corrispondenza della versione del modulo dopo un aggiornamento di gioco -- aggiorna i numeri di versione di SubModule.xml.
• Prova a rimuovere tutte le mod personalizzate e ad eseguire solo con i moduli predefiniti (Native*Multiplayer*DedicatedCustomServerHelper).
• Elimina il file di configurazione e lascia che il server rigeneri i predefiniti per escludere problemi di configurazione.

I Giocatori Non Possono Connettersi

• Verifica che il server sia in esecuzione in GPanel.
• Conferma che il giocatore stia utilizzando l'IP e la porta corretti dalla scheda Network di GPanel.
• Controlla che la password di gioco sia corretta (sensibile a maiuscole/minuscole).
• Assicurati che il giocatore abbia la stessa versione di gioco e le stesse mod installate.
• Se utilizzi mod, verifica che il giocatore abbia esattamente le stesse versioni del modulo.
• Controlla la console per messaggi "player rejected" che potrebbero indicare il motivo specifico.

Il Server Non Appare nel Browser

• Conferma che il server sia completamente avviato e che la console mostri che sta accettando connessioni.
• Controlla che il file di configurazione includa start_game o start_game_and_mission -- senza questo, il server non si registrerà nell'elenco principale dei server.
• Il browser dei server potrebbe impiegare diversi minuti per aggiornarsi. Prova la connessione diretta mentre aspetti.
• Se il token di autenticazione è scaduto, il server potrebbe avviarsi ma non apparire nel browser. Contatta il supporto per il rinnovo del token.

Conflitti tra Mod

• Se il server si blocca dopo l'aggiunta di una mod, rimuovila e testa di nuovo per confermare che sia la causa.
• Controlla che il SubModule.xml della mod elenchi le dipendenze corrette e che l'ordine di caricamento nel tuo elenco di moduli sia corretto.
• Verifica che la mod sia compatibile con la versione corrente di Bannerlord. Le mod da versioni più vecchie potrebbero causare crash.
• Alcune mod sono in conflitto tra loro. Controlla la documentazione della mod e i forum della community per incompatibilità note.
• Pulisci la cache shader del server e i file temporanei se riscontri problemi grafici o errori di caricamento dopo modifiche alle mod.

Desync dei Giocatori

• Il desync si verifica quando lo stato di gioco di un giocatore diverge dal server. I sintomi includono giocatori che sembrano teletrasportarsi, colpi che non si registrano o rubber-banding.
• La causa più comune è un'elevata latenza. Incoraggia i giocatori interessati a controllare la loro connessione internet.
• Le mod che modificano le meccaniche di gameplay (velocità di movimento, fisica, statistiche delle armi) hanno maggiori probabilità di causare desync.
• Se il desync è diffuso, prova a ridurre MaxNumberOfPlayers o a passare a una modalità di gioco più leggera (Duel o Skirmish invece di Siege).
• Il riavvio del server può risolvere problemi di desync persistenti.

Problemi del Token di Autenticazione

• Bannerlord richiede un token di autenticazione valido per eseguire un server dedicato. I token scadono dopo circa 3 mesi.
• Se vedi errori relativi al token nella console, è probabile che il token necessiti di rinnovo.
• Apri un ticket di supporto per far aggiornare il token di autenticazione del tuo server.

8. File di Log

I log del server Bannerlord sono utili per diagnosticare crash, problemi di connessione e attività dei giocatori.

• I file di log sono archiviati nella directory di log del server, tipicamente accessibili tramite la scheda Files di GPanel o tramite SFTP.
• Controlla i file di log per messaggi di errore dettagliati quando l'output della console da solo non è sufficiente.
• Includi estratti di log pertinenti quando apri un ticket di supporto per una risoluzione più rapida.

Articoli Correlati

• Guida alla Configurazione del Server Mount and Blade II Bannerlord
• 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 con il tuo server Bannerlord che non sono coperti qui, apri un ticket di supporto e includi l'IP del tuo server, la modalità di gioco che stai eseguendo, eventuali mod installate e i messaggi di errore pertinenti dalla console di GPanel o dai file di log.