Qui trovi i messaggi che compaiono nel log del server in relazione ai giocatori Bedrock. Hanno due origini: su un server Java il plugin Geyser traduce la connessione dei giocatori Bedrock e Floodgate consente loro di entrare senza un account Java. Su un server Bedrock nativo (Bedrock Dedicated Server), invece, i messaggi provengono perlopiù dagli add-on, cioè dai pacchetti di comportamento e di risorse.
Ogni sezione tratta un solo messaggio. Il testo completo si trova nella Console e, sui server Java, anche in File, in logs/latest.log. Leggi anche le righe immediatamente successive, perché spesso indicano il pacchetto interessato o la vera causa.
Prima di modificare file di configurazione, add-on o file del mondo, crea un backup in Backup. Così potrai tornare in qualsiasi momento allo stato precedente.
«Unable to load Geyser locale map»: file di lingua di Geyser non caricato
Ecco come appare il messaggio:
Could not pass event PlayerJoinEvent to Geyser-Spigot v<Version>
java.lang.AssertionError: Unable to load Geyser locale map for de_DE
Caught previously unhandled exception in Paper Async Command Builder Thread Pool - <Nummer>
Qual è la causa: Geyser non riesce a caricare i dati di lingua necessari. Di conseguenza, quando un giocatore Bedrock entra, l'accesso non va a buon fine (Could not pass event PlayerJoinEvent). Se l'errore compare in Paper Async Command Builder Thread Pool, cioè durante la creazione dei comandi, possono mancare i suggerimenti dei comandi, mentre il server continua a funzionare. Di solito il download dei file di lingua di Minecraft non è riuscito all'avvio oppure i dati di lingua salvati sono danneggiati.
Come risolvere:
- Riavvia completamente il server e segui l'avvio nella Console.
- Controlla se compare anche «Unable to download and extract … locale». Questo messaggio riguarda il download dei file di lingua di Minecraft; più avanti trovi una sezione dedicata.
- Se l'errore persiste, arresta il server e fai un backup dei file di Geyser. Controlla in Plugins se è disponibile una versione aggiornata e compatibile di Geyser e sostituisci il file del plugin a server fermo.
- In caso di ulteriori errori di download o di cache, in File fai un backup dei dati di lingua scaricati interessati e rimuovili da
plugins/Geyser-Spigot/localeso dalla cartella.cachedi Geyser. Conserva le tue personalizzazioni econfig.yml. - Riavvia e prova sia l'accesso da Bedrock sia i suggerimenti dei comandi. Se il messaggio persiste, apri un ticket e indica l'ora in cui è comparso.
«Exception caught in session …»: connessione Geyser di un giocatore Bedrock disturbata
Ecco come appare il messaggio:
[Geyser-Spigot] Exception caught in session of <Spieler>
java.io.IOException: Sending on the reliable data channel failed
[Geyser-Spigot] Error thrown in <Spieler>'s event loop!
Qual è la causa: Geyser traduce la connessione di ogni giocatore Bedrock verso il server Java in una sessione separata. In caso di errore, di solito viene disconnesso solo quel giocatore, mentre il server e gli altri giocatori continuano a funzionare normalmente. Sending on the reliable data channel failed significa che Geyser non è riuscito a inviare dati attraverso questo canale di connessione. «pre-login» indica un'interruzione avvenuta prima dell'accesso; ReadTimeoutException indica che i dati attesi non sono arrivati, mentre un IllegalAccessError nei moduli può riguardare l'accesso tra Geyser e Floodgate.
Come risolvere:
- Annota l'ora, il giocatore coinvolto e la sua ultima azione, ad esempio l'apertura di un menu o un cambio di mondo.
- Arresta il server e aggiorna Geyser e Floodgate in Plugins. Se hai caricato i file manualmente, sostituisci i vecchi file JAR in
plugins/invece di affiancarvi quelli nuovi. - Avvia il server e fai ripetere l'azione al giocatore.
- Se l'errore si ripresenta con lo stesso giocatore o la stessa azione, segnalalo sul Discord del progetto Geyser, allegando la riga di errore e quelle successive.
Buono a sapersi: puoi ignorare un singolo messaggio «pre-login» se nessuno ha segnalato problemi di connessione.
«LocationInUnloadedChunkError» / «InvalidEntityError»: errore di script nell'add-on Bedrock
Ecco come appare il messaggio:
[Scripting] [<Add-on>] LocationInUnloadedChunkError: Trying to access location (<x>, <y>, <z>) which is not in a chunk currently loaded and ticking.
[Scripting] [<Add-on>] InvalidEntityError: Failed to get property 'dimension' due to Entity being invalid (has the Entity been removed?).
Qual è la causa: gli add-on Bedrock includono script propri nel pacchetto di comportamento. L'errore è nell'add-on: ad esempio, tenta di accedere a un'entità che non esiste più o a un'area non caricata. Il server continua a funzionare e di solito smette di funzionare solo una funzione dell'add-on. Se i messaggi sono moltissimi, l'add-on può ridurre le prestazioni.
Come risolvere:
- Leggi il nome dell'add-on nella seconda coppia di parentesi quadre.
- Confronta la versione di Bedrock indicata in Versione con le versioni supportate dall'add-on.
- Crea un backup in Backup. Installa una versione più recente e compatibile seguendo le istruzioni del creatore.
- Se l'add-on continua a disturbare il gioco, arresta il server e disattivalo per prova. In File, rimuovi la sua voce da
worlds/<Welt>/world_behavior_packs.jsone riavvia.
Buono a sapersi: quando disattivi l'add-on, i suoi contenuti possono sparire dal mondo. Conserva quindi il backup. Le righe di errore e le successive righe «at» aiutano il creatore a correggere il problema.
«The following issues were found when loading packs»: add-on Bedrock difettoso
Ecco come appare il messaggio:
The following issues were found when loading packs:
Provided 'pack.name' element has an invalid value in pack manifest; Defaulting to resource pack.
The property '/header/min_engine_version' has a version of '<Version>' which is too high. The highest value we accept is '<Version>'.
Qual è la causa: ogni pacchetto add-on ha un file descrittivo manifest.json. Contiene, tra le altre cose, il nome, l'identificatore, la versione e la versione minima di Bedrock richiesta dal pacchetto. Se all'avvio il server vi trova degli errori, li elenca con un rientro sotto questa riga: prima il pacchetto, poi sotto il motivo. A seconda dell'errore, non carica affatto il pacchetto oppure lo carica in modo diverso dal previsto, ad esempio come pacchetto di risorse anziché di comportamento («Defaulting to resource pack»).
Come risolvere:
- Leggi le righe rientrate sotto il messaggio. Indicano il pacchetto e il motivo.
- Se compare «too high», l'add-on richiede una versione di Bedrock più recente di quella del tuo server. Usa una versione precedente dell'add-on oppure attendi che la versione adatta sia disponibile in Versione o Aggiornamenti.
- Per altri motivi, di solito basta la versione più recente dell'add-on fornita dal creatore.
- Se hai modificato
manifest.jsonmanualmente, controllalo in File. Deve essere un JSON valido (parentesi, virgole, virgolette) e contenere tutti i campi obbligatori, ad esempioformat_version,headerconname,uuideversion, oltre amodules. - Riavvia e controlla che l'elenco sia sparito.
«Failed to read/create config.yml»: configurazione di Geyser non leggibile
Ecco come appare il messaggio:
[Geyser-Spigot] Failed to read/create config.yml! Make sure it's up to date and/or readable+writable!
org.geysermc.geyser.platform.spigot.shaded.org.spongepowered.configurate.loader.ParsingException: …
Qual è la causa: Geyser legge le sue impostazioni da plugins/Geyser-Spigot/config.yml. YAML è un formato di testo in cui la struttura è determinata dai rientri con spazi e dai due punti; una ParsingException indica un errore durante la lettura. Anche un file obsoleto, non leggibile o non scrivibile può causare problemi. Senza una configurazione valida, Geyser di norma non si avvia e i giocatori Bedrock non possono entrare; i giocatori Java possono continuare a giocare.
Come risolvere:
- Arresta il server e, in File, apri il file
plugins/Geyser-Spigot/config.yml. Prima di apportare modifiche, salvane una copia. - Controlla il punto segnalato e le righe precedenti: cerca tabulazioni, rientri fuori posto, due punti mancanti o virgolette non chiuse.
- Se non trovi l'errore, rinomina il file in
config.yml.alt. Avvia il server per far generare a Geyser un file predefinito, poi arrestalo di nuovo. - Trasferisci solo i valori necessari dal vecchio file. La porta Bedrock deve corrispondere alla porta UDP che il pannello assegna al tuo server.
- Avvia il server e controlla nella Console che Geyser si avvii senza errori.
Buono a sapersi: se Geyser continua a non riuscire a leggere o creare il file, controlla i permessi di lettura e scrittura. Se non riesci a risolvere, apri un ticket e indica l'ora del messaggio.
«Duplicate handler name: floodgate-init»: Floodgate è caricato due volte
Ecco come appare il messaggio:
java.lang.IllegalArgumentException: Duplicate handler name: floodgate-init
Qual è la causa: all'avvio, Floodgate si aggancia alla connessione di rete del server per poter riconoscere i giocatori Bedrock. Questo aggancio può avvenire una sola volta. Il messaggio indica che Floodgate è stato caricato una seconda volta. Di solito nella cartella plugins/ ci sono due file di Floodgate, ad esempio una versione vecchia e una nuova. A volte è un altro plugin a includere Floodgate. In questi casi i giocatori Bedrock possono non riuscire a entrare.
Come risolvere:
- Arresta il server. In File, apri la cartella
plugins/e cerca tutti i file che contengono «floodgate» nel nome e terminano con.jar. - Tieni solo una build adatta al software del tuo server ed elimina le altre.
- Controlla se i plugin installati di recente includono Floodgate secondo la loro descrizione. In tal caso ti basta una sola delle due fonti.
- Riavvia il server e fai entrare un giocatore Bedrock.
Buono a sapersi: la cartella plugins/floodgate non è un secondo plugin. Contiene le impostazioni e la chiave di Floodgate e non va eliminata.
«unknown child schema option type»: l'add-on Bedrock contiene voci non valide
Ecco come appare il messaggio:
[Recipes] recipes/<Datei>.json | <Add-on>:<Rezept> | Recipe: <Add-on>:<Rezept> has an invalid unlock ingredient
[Json] behavior_packs/<Paket> | minecraft:damage_sensor | triggers | deals_damage | unknown child schema option type. Allowed types: 'string'
[FeatureRegistry] Feature rule <Add-on>:<Eintrag> can't place internal feature type.
Qual è la causa: gli add-on descrivono creature, oggetti, ricette e parti della generazione del mondo in file propri. Il server Bedrock non riesce a elaborare alcune voci, ad esempio un ingrediente non valido per sbloccare una ricetta o un campo con un tipo di dato errato. Questa parte dell'add-on non funziona o funziona solo in parte, mentre il resto e il server continuano a girare. Di solito l'add-on è stato creato per un'altra versione di Bedrock.
Come risolvere:
- Individua il pacchetto interessato. La parte prima dei due punti è di solito la sigla dell'add-on, mentre altre righe indicano il percorso
behavior_packs/…. - In Versione, controlla quale versione di Bedrock usa il tuo server.
- Crea un backup, scarica dal sito dell'autore la versione dell'add-on adatta a quella del server e sostituisci il vecchio pacchetto.
- Riavvia e controlla che le righe siano sparite.
Buono a sapersi: dopo un aggiornamento del server Bedrock, righe di questo tipo compaiono spesso in gran numero, finché gli autori non aggiornano i loro add-on.
«Auth-type set to Floodgate but Floodgate is not installed»: Geyser si arresta
Ecco come appare il messaggio:
[Geyser-Spigot] Auth-type set to Floodgate but Floodgate is not installed! Disabling...
Qual è la causa: nella configurazione di Geyser è impostato floodgate come metodo di accesso, che permette ai giocatori Bedrock di entrare senza un account Java aggiuntivo. Per funzionare, però, il plugin Floodgate deve essere installato e attivo. Se manca, Geyser si disattiva e i giocatori Bedrock non possono entrare nel server. I giocatori Java non sono interessati dal problema.
Come risolvere:
- Controlla in Plugin o nella cartella
plugins/se Floodgate è presente e se all'avvio segnala un errore proprio. - Arresta il server prima di modificare i file. Se Floodgate manca, installalo nella cartella
plugins/dalla stessa fonte di Geyser, scegliendo la versione adatta al software del tuo server. - Se non vuoi usare Floodgate, imposta invece il valore
auth-typesuonlineinplugins/Geyser-Spigot/config.yml. In questo caso i giocatori Bedrock avranno bisogno anche di un account Java. - Riavvia il server e prova a entrare con Bedrock.
Approfondimento: configurare il crossplay Bedrock con Geyser e Floodgate
Geyser non riesce a scaricare i file di lingua
Ecco come appare il messaggio:
[Geyser-Spigot] Unable to download and extract <Sprache> locale!
Qual è la causa: all'avvio, Geyser scarica da Mojang i file di lingua di Minecraft. In questo caso la connessione si è interrotta e di solito sotto compare «Connection reset». Fino al prossimo avvio riuscito, i giocatori Bedrock vedono testi non tradotti o non riescono proprio a entrare. Il server e i giocatori Java non sono interessati dal problema.
Come risolvere:
- Riavvia il server. Spesso il download riesce al tentativo successivo.
- Durante l'avvio, controlla nella Console se il messaggio ricompare.
- Se il messaggio persiste, arresta il server e, in File, elimina la cartella
plugins/Geyser-Spigot/localesoppure la cartella.cachedi Geyser. - Avvia di nuovo il server e prova a entrare con Bedrock.
Buono a sapersi: se al momento dell'accesso compare il messaggio «Unable to load Geyser locale map», di solito è una conseguenza di questo download non riuscito. Se il download fallisce per più avvii, apri un ticket e indica l'ora del messaggio.
Geyser non riesce a raggiungere un servizio di rete necessario
Ecco come appare il messaggio:
[Geyser-Spigot] Got an error
java.net.ConnectException: Connection refused
Qual è la causa: per funzionare, Geyser stabilisce connessioni con altri punti, ad esempio con un host remoto configurato o con servizi esterni. In questo caso una di queste connessioni non è riuscita. La riga immediatamente sotto ne indica il motivo: ConnectException significa che l'host remoto ha rifiutato la connessione, spesso perché lì non è in esecuzione nulla. NoRouteToHostException significa che l'indirizzo non è raggiungibile. Le funzioni che smettono di andare dipendono dall'host remoto.
Come risolvere:
- Leggi per intero le righe sotto «Got an error». Spesso riportano l'indirizzo che Geyser cercava di raggiungere.
- Se hai modificato un indirizzo di destinazione o una porta in
plugins/Geyser-Spigot/config.yml, confrontali con i dati nel pannello e correggili. - Se la destinazione si trova su un altro server, controlla che sia attivo e raggiungibile.
- Aggiorna Geyser in Plugin e riavvia il server.
Buono a sapersi: se il messaggio compare una sola volta e i giocatori Bedrock continuano a entrare nel server, puoi limitarti a tenerlo d'occhio invece di intervenire subito.
Geyser non riesce ad aprire la sua porta Bedrock
Ecco come appare il messaggio:
[Geyser-Spigot] Failed to start Geyser on <IP>:<Port>
Cosa c'è dietro: Geyser accetta le connessioni Bedrock attraverso una propria porta UDP. UDP è il protocollo di rete che Bedrock usa per la connessione. Geyser non è riuscito ad aprire questa porta: o è già occupata da un altro servizio, oppure non è assegnata al tuo server e quindi non può essere usata. In questo caso le connessioni Bedrock non funzionano, mentre i giocatori Java possono continuare a entrare nel server.
Come risolvere:
- Controlla nel pannello quale porta Bedrock (UDP) è assegnata al tuo server.
- In File apri il file
plugins/Geyser-Spigot/config.ymle controlla il valoreportnella sezionebedrock. Deve corrispondere esattamente alla porta assegnata. - Verifica se un altro servizio UDP usa la stessa porta, ad esempio la query (
query.portinserver.properties) o un plugin di chat vocale. Ognuno di questi servizi ha bisogno di una propria porta. - Salva, riavvia il server e prova a entrare con Bedrock.
Per approfondire: Crossplay con Bedrock: Geyser, Floodgate e porta UDP
Lo script di un add-on si è bloccato ed è stato interrotto
Ecco come appare il messaggio:
[Watchdog] Unhandled critical exception of type '<Typ>' in behavior pack '<Add-on>'
Cosa c'è dietro: Il server Bedrock sorveglia gli script degli add-on con un sistema di controllo chiamato Watchdog. Se uno script impiega troppo tempo, il server lo interrompe per evitare che l'intero mondo si blocchi. Il nome dell'add-on è indicato nel messaggio dopo «behavior pack». In quel momento il server può avere un breve scatto e alcune funzioni dell'add-on smettono di funzionare. Il server in sé continua a girare.
Come risolvere:
- Leggi il nome dell'add-on nel messaggio.
- Verifica presso l'autore se esiste una versione più recente per la versione Bedrock del tuo server (vedi Versione) e installala dopo aver creato un backup.
- Fai attenzione se il messaggio compare durante un'azione specifica, ad esempio quando entri in una certa zona o quando ci sono molte creature nello stesso punto.
- Se compare spesso, disattiva l'add-on per prova e osserva se gli scatti spariscono.
Buono a sapersi: Un singolo messaggio non è motivo di preoccupazione. Ciò che conta è se si ripete.
«xuid or permission missing»: voce incompleta in permissions.json
Ecco come appare il messaggio:
xuid or permission missing from permissions file: permissions.json
Cosa c'è dietro: Su un server Bedrock, permissions.json definisce i livelli di permesso, ad esempio operatore. Ogni voce ha bisogno dello XUID, cioè l'identificativo fisso dell'account Xbox o Microsoft, e di un livello di permesso. Se manca uno dei due dati, il server non applica la voce. Il server continua a girare, ma quel permesso non ha effetto.
Come risolvere:
- Crea un backup in Backup e arresta il server prima di modificare il file.
- In File apri il file
permissions.json. - Rimuovi la voce incompleta se non ti serve, oppure aggiungi lo XUID mancante o il livello di permesso previsto. Assicurati che
xuidepermissionsiano presenti e che la struttura JSON, con le sue parentesi e virgole, resti intatta. - Riavvia il server e controlla la Console e il permesso del giocatore interessato.
Buono a sapersi: Se il giocatore deve diventare operatore, puoi usare invece op <Spieler> nella Console mentre è online. In questo modo il server inserisce lo XUID da solo. Il solo nome del giocatore non sostituisce lo XUID.
Floodgate interrompe la configurazione dei propri componenti interni
Ecco come appare il messaggio:
Unable to create injector, see the following errors:
IllegalStateException: Couldn't create lambda for: "MethodHandle(PlayerLinkHolder,ShutdownEvent)void"
Cosa c'è dietro: L'injector si occupa di configurare i componenti interni del plugin. In questo caso Floodgate non riesce a creare un gestore di eventi per il collegamento degli account. Per questo motivo Floodgate non si avvia completamente e l'accesso Bedrock, che richiede Floodgate, non è disponibile.
Come risolvere:
- Leggi l'intero rapporto di errore nella Console o in File, nel file
logs/latest.log. - Annota il software del server e le versioni di Java, Geyser e Floodgate indicate nel log di avvio.
- Controlla gli ambienti supportati dal progetto Floodgate. Installa versioni compatibili di Floodgate e Geyser; se usi un software ibrido, verifica espressamente che sia supportato.
- Riavvia completamente il server e prova a entrare con Bedrock. Se l'errore persiste, segnalalo al progetto Floodgate allegando il rapporto completo.
Bedrock non riesce a leggere l'elenco dei permessi
Ecco come appare il messaggio:
Malformed permissions file. Top level needs to be an array [], with inner levels nested in {}
Cosa c'è dietro: Il server Bedrock non riesce a leggere il proprio elenco dei permessi. Il file usa JSON, un formato di testo strutturato. All'esterno deve esserci un elenco tra parentesi quadre e, al suo interno, ogni voce di permesso tra parentesi graffe. Una struttura diversa impedisce che queste voci vengano applicate.
Come risolvere:
- Arresta il server. In File crea una copia di sicurezza del file
permissions.jsonesistente prima di modificarlo. - Ripristina una versione funzionante o correggi la struttura: all'esterno
[e], all'interno i singoli oggetti con{e}. Separa più oggetti con le virgole. - Conserva le voci esistenti e usa le virgolette doppie per i nomi dei campi e i valori di testo. Rimuovi le virgole in eccesso e chiudi tutte le parentesi.
- Salva il file, riavvia il server e controlla la Console. Verifica poi che i permessi previsti siano di nuovo attivi.
Buono a sapersi: Un elenco vuoto rimuove i permessi speciali registrati. Non usarlo come alternativa alla riparazione delle voci esistenti.
Geyser: la segnalazione esterna non ottiene un endpoint ICE UDP
Ecco come appare il messaggio:
[Geyser-Spigot] Could not start the external signaling service
java.lang.IllegalStateException: Cannot acquire ICE UDP mux endpoint
Failed to register pending ICE UDP mux listener
Cosa c'è dietro: ICE organizza la creazione di una connessione dati. Il multiplexer UDP distribuisce i pacchetti di rete attraverso un endpoint comune. In questo caso non è possibile configurare il suo listener. Di conseguenza, in Geyser la segnalazione esterna per le nuove connessioni non è disponibile; il server di gioco continua a girare.
Come risolvere:
- Leggi nella Console gli errori di rete che precedono il messaggio. Cerca altri messaggi relativi all'inizializzazione o al binding della porta UDP.
- In File controlla le impostazioni di Geyser per trasporto, segnalazione e porta UDP confrontandole con la documentazione aggiornata di Geyser.
- In Plugin verifica se è disponibile un aggiornamento adatto di Geyser. Cambia il tipo di segnalazione solo se è coerente con la configurazione di connessione che hai previsto.
- Dopo la correzione, esegui un riavvio completo e prova una nuova connessione. Se l'errore persiste, apri un ticket indicando l'orario e tutti i messaggi correlati.
Geyser non riesce a rispondere alla richiesta di accesso Java
Ecco come appare il messaggio:
Cannot reply to ClientboundHelloPacket without profile and access token.
Cosa c'è dietro: Geyser fa da tramite tra i giocatori Bedrock e il server Java. A questa richiesta di accesso Java mancano un profilo e un token di accesso, cioè le credenziali necessarie. Il giocatore Bedrock interessato non può entrare; il server Java continua a funzionare. Controlla l'accesso con un account Java o il collegamento Floodgate configurato.
Come risolvere:
- Leggi nella Console i messaggi di Geyser e Floodgate immediatamente precedenti all'interruzione. Controlla le impostazioni coinvolte in File.
- Con l'accesso online diretto, Geyser deve autenticarsi con un account Java valido. Se usi Floodgate, controlla che le impostazioni di Geyser e Floodgate siano coerenti tra loro seguendo la relativa guida alla configurazione.
- Aggiorna Geyser ed eventualmente Floodgate in modo che corrispondano alla Versione del server, esegui un riavvio completo e prova di nuovo a entrare da Bedrock. Non disattivare la verifica online in modo generalizzato.
Il tuo messaggio non è tra questi?
Leggi l'intero messaggio nella Console o in logs/latest.log, comprese le righe immediatamente precedenti. Se segue uno stacktrace, cioè un elenco di righe che iniziano con „at“, indica dove si è verificato l'errore. I nomi al suo interno, come Geyser-Spigot.jar o floodgate, rivelano il plugin interessato. Sui server Bedrock, le parentesi quadre o i percorsi sotto behavior_packs/ indicano l'add-on. Crea un backup prima di modificare qualsiasi cosa. Se non riesci a venirne a capo, apri un ticket e indica l'ora del messaggio.