Quando un plugin o una mod incontra un errore di programma durante il funzionamento, Java scrive nel log un messaggio di errore con lo stack trace. Lo stack trace è l'elenco delle righe «at» sotto la riga di errore. Mostra quale parte del programma era in esecuzione e di solito rivela così il plugin o la mod responsabile. La maggior parte di questi errori non blocca il server, ma una funzione smette di funzionare e gli errori ripetuti riempiono la console.

Ogni sezione qui sotto tratta un messaggio: che aspetto ha, cosa c'è dietro e cosa puoi fare. Trovi il messaggio completo nella Console oppure in File in logs/latest.log. Leggi anche le righe immediatamente precedenti e successive. Prima di modificare file di configurazione o del mondo o di sostituire plugin, crea un backup in Backup. È meglio sostituire i file dei plugin a server fermo.

NullPointerException: un plugin o una mod accede a un valore mancante

Ecco come appare il messaggio:

Failed to handle packet <Paket>, suppressing error
java.lang.NullPointerException: Cannot invoke "com.google.gson.JsonObject.entrySet()" because "jsonobject" is null
java.lang.NullPointerException: Cannot invoke "com.google.gson.JsonElement.getAsBoolean()" because the return value of "com.google.gson.JsonObject.get(String)" is null

Cosa c'è dietro: un plugin o una mod accede a un oggetto mancante; Java chiama questo valore «null». Dopo «Cannot invoke» trovi il metodo, dopo «because» il valore mancante. Può succedere anche durante la lettura di un file di lingua o di una configurazione. L'azione interessata si interrompe; con «Skipped language file» il file di lingua viene saltato. Con «Failed to handle packet … suppressing error» il server scarta solo quella singola azione di un giocatore e continua a funzionare. All'avvio, l'errore può anche interrompere la procedura di avvio.

Come risolvere:

  1. Apri il messaggio completo nella Console o in logs/latest.log. Leggi anche le righe precedenti: un file di lingua o di configurazione citato aiuta a individuare il responsabile.
  2. Le righe «at» si chiamano stack trace: la catena di chiamate fino all'errore. Leggi dalla prima riga fino al plugin o alla mod coinvolti; la prima può citare Minecraft stesso.
  3. Aggiorna il plugin individuato in Plugin o la mod in Mod a una versione adatta a quella del server. Ferma il server prima di sostituire i file e poi riavvialo.
  4. Se viene citata una configurazione, salvala e confronta le impostazioni richieste con le indicazioni dell'autore. Se l'errore persiste, invia all'autore il messaggio completo e descrivi l'azione che lo provoca.

Buono a sapersi: pl:mixin:APP:<Mod>.mixins.json indica una mod con un mixin, cioè un intervento nei processi di gioco.

«Could not pass event»: un plugin va in crash durante un evento di gioco

Ecco come appare il messaggio:

Could not pass event <Ereignis> to <Plugin> v<Version>
java.lang.NoSuchMethodError: …
io.netty.channel.unix.Errors$NativeIoException: bind(..) failed with error(-99): Cannot assign requested address

Cosa c'è dietro: i plugin reagiscono a eventi come l'ingresso di un giocatore, un clic nell'inventario o un danno. Se in quel momento un plugin genera un'eccezione, cioè un errore Java, la sua elaborazione si interrompe. Dopo «to» trovi plugin e versione, prima l'evento. «NoSuchMethodError» o «NoSuchFieldError» indicano una versione del server non compatibile. «IllegalArgumentException» può indicare, ad esempio, un valore di colore non valido o un tipo di dato non adatto. «bind(..) failed» con «Cannot assign requested address» significa che il plugin, spesso Geyser, non riesce a occupare l'indirizzo di rete configurato. Il server continua a funzionare, ma la funzione del plugin interessata non viene eseguita per quell'evento.

Come risolvere:

  1. Nella Console, leggi il nome e la versione del plugin dopo «to» e la riga di errore sottostante.
  2. In Versione, controlla quale versione del server è in uso e cerca nella pagina del plugin una release che la supporti.
  3. Ferma il server, installa la release adatta in Plugin e riavvia.
  4. In caso di «bind(..) failed», controlla in File indirizzo e porta nella configurazione del plugin. Il plugin non può occupare un indirizzo che non appartiene al server.
  5. Se l'errore persiste, segnalalo all'autore del plugin indicando l'azione che lo provoca e il messaggio di errore completo.

Buono a sapersi: approfondimento su «NoSuchMethodError» e «NoSuchFieldError»: Il plugin non è compatibile con la versione del server.

«Task … generated an exception»: un'attività del plugin fallisce in background

Ecco come appare il messaggio:

[<Plugin>] Task #<Nummer> for <Plugin> v<Version> generated an exception
java.lang.IllegalArgumentException: missing required data class org.bukkit.Color
java.lang.IllegalStateException: Cannot modify read-only score

Cosa c'è dietro: un'attività pianificata del plugin (task), ad esempio per particelle o ologrammi, si è interrotta con un errore Java, cioè un'eccezione. Gli errori ripetuti indicano spesso un'incompatibilità con la versione del server, ad esempio dopo un aggiornamento. Possono causarli anche valori non validi o accessi a punteggi di sola lettura. Il server continua a funzionare, ma una funzione del plugin non è disponibile e gli errori ripetuti riempiono la console.

Come risolvere:

  1. Leggi il nome del plugin dopo «for» e la riga di errore sottostante.
  2. In Plugin, controlla se esiste una release più recente adatta alla versione del tuo server. Ferma il server, installala e riavvia.
  3. Se non esiste una release adatta, ferma il server e, in File, sposta il file .jar da plugins/ in una cartella separata. Poi riavvia. Gli errori continui possono rallentare il server.
  4. Controlla nella Console che il messaggio non compaia più. Se compare anche con la release aggiornata, segnalalo all'autore.

Buono a sapersi: «missing required data class» indica dati mancanti per le particelle, in questo caso un colore. «Cannot modify read-only score» riguarda un punteggio di sola lettura; l'accesso deve essere corretto nel plugin. «NoSuchMethodError» o «NoSuchFieldError» indicano un'incompatibilità di versione.

«Error executing task» / «Command … failed»: un'attività o un comando si interrompe

Ecco come appare il messaggio:

[Essentials] Command <Befehl> failed:
[<Plugin>] Plugin <Plugin> v<Version> generated an exception while executing task <Nummer>
Error executing task on Server

Cosa c'è dietro: un comando o un'attività pianificata si è interrotta con un'eccezione, cioè un errore Java. In caso di errore di un plugin, il server continua a funzionare mentre la funzione interessata non è disponibile; «Error executing task on Server» compare anche per attività del server stesso. MissingResourceException indica una risorsa o una voce di lingua mancante, sectionPos out of bounds una posizione di sezione non valida. La causa si trova sotto il messaggio e, in caso di errori annidati, dopo «Caused by».

Come risolvere:

  1. Leggi la riga «Caused by» o la prima riga di errore subito sotto il messaggio.
  2. Individua il plugin dal messaggio o dalle righe at …, la catena di chiamate fino all'errore. Lì possono essere citati anche eventuali plugin aggiuntivi necessari.
  3. In Plugin, aggiorna il plugin e le dipendenze interessate a release compatibili tra loro e con la versione del tuo server. Ferma il server prima di sostituire i file e poi riavvialo.
  4. Ripeti l'azione. Se l'errore persiste, segnalalo all'autore del plugin con il messaggio completo. Se la catena di chiamate cita solo classi di Minecraft, apri un ticket indicando l'azione e l'orario.

Buono a sapersi: NoSuchMethodError o NoSuchFieldError indicano metodi o campi mancanti: controlla la versione del server supportata e le dipendenze.

ClassCastException: una mod o un plugin si aspetta un altro tipo di dato

Ecco come appare il messaggio:

Failed to clear dangling mod jars
java.lang.ClassCastException: Cannot cast <PaketA>.<KlasseA> to <PaketB>.<KlasseB>
java.lang.ClassCastException: class net.minecraft.block.AirBlock cannot be cast to class net.minecraft.block.AbstractBannerBlock

Cosa c'è dietro: una mod o un plugin si aspetta un tipo di dato diverso da quello fornito da un altro componente coinvolto. Succede, ad esempio, quando una mod è stata aggiornata e una mod da essa dipendente no. L'errore può verificarsi anche durante la lettura della configurazione di una mod. Spesso smette di funzionare solo la funzione interessata, come il caricamento dei dati dei blocchi o la pulizia dei file delle mod caricate.

Come risolvere:

  1. Leggi il messaggio completo in logs/latest.log nella sezione File. I nomi dei pacchetti prima dei nomi delle classi aiutano a individuare le mod o i plugin coinvolti; java.lang.String indica invece il tipo di dato Java per il testo.
  2. Controlla quale componente è stato aggiornato per ultimo. Porta le mod o i plugin coinvolti a versioni compatibili tra loro: aggiornali insieme o riportali allo stato precedente.
  3. Se usi un modpack, aggiorna l'intero modpack invece delle singole mod.
  4. Se viene citata una voce di configurazione, controllala con la documentazione della versione della mod installata.
  5. Riavvia e ripeti l'operazione.

Per saperne di più sui conflitti tra mod: Errori delle mod su Forge, NeoForge e Fabric.

ArrayIndexOutOfBoundsException: accesso a una voce inesistente di una lista

Ecco come appare il messaggio:

java.lang.ArrayIndexOutOfBoundsException: Index 3 out of bounds for length 3
[DonateCase] Error occurred while loading item: <Eintrag>
java.lang.ArrayIndexOutOfBoundsException: Index 45 out of bounds for length 45

Cosa c'è dietro: un plugin o una mod accede a una posizione non valida di un array, cioè una lista di lunghezza fissa. Java conta a partire da 0: con lunghezza 3 esistono solo le posizioni da 0 a 2; anche le posizioni negative non sono valide. Spesso mancano argomenti di un comando o valori di configurazione, un plugin datato legge male la versione del server oppure una voce di menu si trova fuori dalle dimensioni del menu, come in DonateCase. A seconda del punto in cui si verifica l'errore, smette di funzionare una funzione oppure l'avvio non riesce.

Come risolvere:

  1. Leggi le righe di errore nella Console o in logs/latest.log nella sezione File. Le righe «at» sottostanti mostrano la catena delle chiamate, detta anche stacktrace; cerca lì il plugin o la mod interessati.
  2. Se si tratta di un comando, controlla gli argomenti richiesti. Confronta i valori di configurazione con il modello o con un backup. In caso di errori nei menu, verifica che le posizioni impostate siano compatibili con le dimensioni del menu.
  3. Aggiorna il plugin interessato nella sezione Plugin o la mod nella sezione Mod a una versione compatibile con il server e con il loader. Il loader è il programma che carica le mod. Riavvia.
  4. Se l'errore persiste, segnala all'autore il messaggio di errore, la catena delle chiamate e ciò che lo ha causato.

Il file di configurazione di un plugin contiene errori.

NumberFormatException: un testo doveva essere un numero

Ecco come appare il messaggio:

[DeluxeMenus-Modern] Input for comparison requirement is an invalid number: %statistic_hours_played%
java.lang.NumberFormatException: For input string: "%statistic_hours_played%"
java.lang.NumberFormatException: For input string: "craftbukkit"

Cosa c'è dietro: il gioco, una mod o un plugin ha cercato di leggere un valore di testo come numero, ma il testo non era un numero. Le virgolette mostrano il valore; la causa può essere una configurazione, un dato inatteso oppure un errore di versione o del programma. Un segnaposto con il simbolo di percentuale non è stato sostituito, ad esempio durante il controllo numerico in DeluxeMenus; spesso manca l'estensione adatta per PlaceholderAPI, il plugin che compila questi segnaposto, oppure il plugin che fornisce il valore. Una parola come craftbukkit può indicare che un plugin datato legge male la versione del server.

Come risolvere:

  1. Controlla lo stacktrace completo, cioè la catena delle chiamate sotto il messaggio di errore, e aggiorna il componente indicato.
  2. Se si tratta di un segnaposto: verifica in gioco con /papi parse me <Platzhalter> se restituisce un valore. In caso contrario, controlla il plugin che dovrebbe fornirlo e installa l'estensione PlaceholderAPI adatta con /papi ecloud download <Name>. Caricala con /papi reload.
  3. Se il messaggio cita un file o un'impostazione, confronta il valore con la configurazione predefinita del plugin.
  4. Riavvia e ripeti l'azione che ha causato l'errore.

ArrayIndexOutOfBoundsException senza ulteriori dettagli

Ecco come appare il messaggio:

[<Plugin>] Error occurred while loading item: 2
java.lang.ArrayIndexOutOfBoundsException

Cosa c'è dietro: un plugin o una mod ha usato un indice di lista non valido, come nella sezione precedente. Qui però mancano l'indice e la lunghezza. Succede quando lo stesso errore si ripete molto spesso: in tal caso Java omette i dettagli per motivi di prestazioni. La riga precedente rivela spesso quale plugin stava facendo cosa, nell'esempio il caricamento di una voce. La prima riga dello stacktrace sottostante, se presente, indica il responsabile.

Come risolvere:

  1. Leggi la riga immediatamente prima del messaggio. Spesso lì trovi il plugin tra parentesi quadre.
  2. Leggi la prima riga dello stacktrace sotto il messaggio.
  3. Se mancano entrambe, cerca più in alto in logs/latest.log la prima occorrenza. Di solito lì l'errore è ancora completo. I log più vecchi si trovano compressi nella cartella logs/.
  4. Aggiorna il plugin o la mod citati per primi. Se la riga precedente cita una voce specifica, controllala nella configurazione del plugin.
  5. Se l'errore persiste, segnalalo all'autore.

ExceptionInInitializerError: impossibile inizializzare una classe di un plugin o di una mod

Ecco come appare il messaggio:

Exception in thread "ForkJoinPool-3-worker-1" java.lang.ExceptionInInitializerError
Caused by: <Fehlerart>: <Meldung>

Cosa c'è dietro: Java inizializza una sola volta ogni classe, cioè ogni componente di un programma, al primo utilizzo. Proprio in quel momento una classe di un plugin o di una mod è andata in crash. Da quel punto resta inutilizzabile per tutta la sessione del server, perciò spesso seguono altri errori come «NoClassDefFoundError» con lo stesso nome di classe. La catena «Caused by» sottostante indica la vera causa e di solito anche il plugin o la mod interessati. A seconda di dove si verifica il problema, smette di funzionare una funzione oppure il plugin o la mod non si caricano affatto.

Come risolvere:

  1. Leggi nella Console o in logs/latest.log la prima riga «Caused by» sotto il messaggio.
  2. Individua il plugin o la mod dalle righe «at» sottostanti, ad esempio dal nome del file con .jar.
  3. Aggiornalo o sostituiscilo con una versione compatibile con la versione e il software del tuo server.
  4. Riavvia il server. La classe viene inizializzata di nuovo solo all'avvio successivo.

Per le questioni di versione può esserti utile: Il plugin non è compatibile con la versione del server.

«location-candidate error» / «Failed to save a model»: un'attività del plugin non riesce

Ecco come appare il messaggio:

[OlEncounters] First unexpected location-candidate error during this search
com.olencounters.location.LocationFinder$UngeneratedChunkException: Location search refused to generate a chunk
[OpenAudioMc] WARNING: Failed to save a model. This is a error. (ClientDataStore) (IllegalArgumentException/java.lang.ArithmeticException: long overflow)

Cosa c'è dietro: un plugin ha riscontrato un errore durante una propria attività, ad esempio durante il salvataggio, l'elaborazione di un messaggio, l'avvio o la ricerca di un luogo. In questo caso OlEncounters incontra un chunk, cioè una sezione del mondo, non ancora generato e ne rifiuta la generazione durante la ricerca. OpenAudioMc non riesce a salvare i dati a causa di un overflow numerico: il risultato di un calcolo non rientra nel tipo numerico utilizzato. A seconda dell'errore, viene meno solo quell'azione oppure il plugin si disattiva; degli errori di salvataggio dovresti occuparti al più presto, così da non perdere dati.

Come risolvere:

  1. Leggi nella Console il nome del plugin e le righe subito sotto il messaggio.
  2. Aggiorna il plugin in Plugin e riavvia.
  3. Se l'errore persiste, crea un backup, rimuovi il plugin per prova a server fermo e, dopo l'avvio, controlla se il messaggio scompare.
  4. Segnala l'errore all'autore del plugin, indicando le righe della console e l'azione durante la quale si verifica.

Se il salvataggio fallisce ripetutamente: Il plugin non riesce a salvare il database o i file.

Report di errore di Skript con #!#!: uno script non si carica

Ecco come appare il messaggio:

#!#! Current node: <Zeile aus der .sk-Datei>
#!#! End of Error.

Cosa c'è dietro: Skript è un plugin con cui puoi scrivere funzioni per il server in semplici file di testo con estensione .sk. Se rileva un errore grave durante il caricamento di uno script o di un addon, scrive un report in cui tutte le righe iniziano con #!#!. Cause frequenti: un addon come skript-reflect o SkBee non è compatibile con la versione di Skript installata, oppure un file di plugin è stato sostituito a server acceso. In quel caso nel report compare «zip file closed». Lo script interessato non funziona, ma il server continua a girare.

Come risolvere:

  1. Leggi nel report la riga «Current node» (indica il file .sk interessato) e la riga «Caused by».
  2. Controlla sulle pagine dei progetti quali versioni degli addon sono compatibili con la tua versione di Skript e porta Skript e gli addon a versioni compatibili tra loro.
  3. Sostituisci i file dei plugin solo a server fermo e poi riavvia il server.
  4. Carica lo script con /sk reload <datei> e leggi l'output nella Console.

Buono a sapersi: gli script si trovano in File, nella cartella plugins/Skript/scripts/. Fai un backup di un file prima di modificarlo.

IndexOutOfBoundsException: «must be less than size»

Ecco come appare il messaggio:

Caused by: java.lang.IndexOutOfBoundsException: index (1) must be less than size (1)

Cosa c'è dietro: il gioco, una mod o un plugin ha richiesto una voce di una lista che non esiste. «index (1) must be less than size (1)» significa che la lista contiene esattamente una voce, con il numero 0, mentre è stato richiesto il numero 1. Può essere coinvolta una configurazione, ma il messaggio da solo non lo dimostra. Se è preceduto da «Caused by:», è la causa di un errore segnalato più in alto. È quel messaggio più in alto a indicare che cosa smette di funzionare.

Come risolvere:

  1. Leggi lo stack trace completo in logs/latest.log, compreso il messaggio di errore sopra di esso.
  2. Cerca la prima riga «at» che nomina un componente esterno, cioè un plugin o una mod anziché Java o una libreria come java.base o com.google.common.
  3. Aggiorna quel componente e riavvia.
  4. Solo se il contesto rimanda a una lista specifica, ad esempio voci di menu o ricompense, controlla nella sua configurazione se ci sono voci mancanti o vuote.

«Asynchronous Save Players»: Paper attende il salvataggio dei dati dei giocatori

Ecco come appare il messaggio:

Asynchronous Save Players! Blocking thread until it returns
java.lang.IllegalStateException: null
at org.bukkit.craftbukkit.util.ServerShutdownThread.run(ServerShutdownThread.java:<Zeile>)

Cosa c'è dietro: un plugin può avviare il salvataggio dei dati di tutti i giocatori da un thread in background, cioè da un flusso di lavoro parallelo al thread principale che calcola il mondo. Paper blocca questo thread finché il salvataggio non è terminato; nel frattempo possono verificarsi brevi scatti. La variante con ServerShutdownThread si presenta durante lo spegnimento. Durante il normale funzionamento, il server continua a girare dopo il salvataggio; durante lo spegnimento, il messaggio fa parte della procedura di arresto già in corso.

Come risolvere:

  1. Leggi per intero le righe «at» sotto il messaggio. Mostrano le parti del programma coinvolte; le prime appartengono spesso a Paper o a Minecraft.
  2. Se una di queste righe nomina un plugin, aggiornalo in Plugin e riavvia. Se l'avviso persiste, segnalalo all'autore del plugin allegando lo stack delle chiamate completo.
  3. Se lo stack mostra solo parti del server e ServerShutdownThread, leggi nella Console anche le righe precedenti allo spegnimento. Controlla se il server è stato appena arrestato come previsto.
  4. Se l'avviso si ripete senza un plugin riconoscibile o se si verificano problemi di salvataggio, apri un ticket e indica l'ora del messaggio.

«Unhandled exception executing command»: il comando del plugin si interrompe

Ecco come appare il messaggio:

org.bukkit.command.CommandException: Unhandled exception executing command '<befehl>' in plugin <Plugin> v<Version>
Caused by: <Fehlerart>: <Meldung>

Cosa c'è dietro: un plugin ha generato un errore durante l'esecuzione di uno dei suoi comandi. Il comando e il plugin sono indicati nel messaggio. Di solito il plugin non è compatibile con la versione del server o con un altro plugin da cui dipende. Chi ha inserito il comando di solito vede in chat solo un avviso generico di errore interno. Il comando non è stato eseguito, ma il server continua a girare.

Come risolvere:

  1. Leggi la riga «Caused by» sotto il messaggio.
  2. Controlla in Versione la versione del tuo server e aggiorna il plugin in Plugin a una release adatta.
  3. Se la riga di errore nomina un altro plugin da cui il plugin dipende, porta anche quello a una versione compatibile.
  4. Riavvia e prova il comando. Se l'errore persiste, segnalalo all'autore del plugin indicando questa riga.

Per saperne di più sulle dipendenze: Il plugin richiede un altro plugin.

Errore di comando con «[ACF]» nel log

Ecco come appare il messaggio:

[<Plugin>] [ACF] Exception in command: <befehl>
[<Plugin>] [ACF] java.lang.NoSuchMethodError: <Methode>

Cosa c'è dietro: molti plugin creano i propri comandi con una libreria già pronta, l'Aikar Command Framework (ACF). Se un comando si interrompe con un'eccezione, ACF mostra l'errore con il relativo stack trace, anteponendo a ogni riga il nome del plugin. Il nome nella prima parentesi è quindi quello del plugin interessato, non ACF. Se nell'output compare «IncompatibleClassChangeError» o «NoSuchMethod», il plugin non è compatibile con la versione del server. Il comando non è stato eseguito, ma il server continua a girare.

Come risolvere:

  1. Leggi il nome del plugin nella prima parentesi quadra e la prima riga di errore con «Exception» o «Error».
  2. Aggiorna il plugin in Plugin a una versione adatta alla versione del tuo server.
  3. Riavvia e prova il comando.
  4. Se l'errore persiste, segnalalo all'autore del plugin indicando la prima riga di errore.

Buono a sapersi: non devi installare né aggiornare ACF da solo. È già incluso nel rispettivo plugin.

GravesX: errore in un'attività in background

Ecco come appare il messaggio:

[GravesX] Async task for GravesX v<Version> generated an exception
java.lang.NullPointerException: Cannot invoke "<Methode>" because "version2" is null

Cosa c'è dietro: quando un giocatore muore, GravesX crea una tomba con i suoi oggetti. Il plugin genera una NullPointerException in un'attività in background, ad esempio durante il confronto tra due numeri di versione, quando manca un valore (“version2”). Si tratta di un errore del plugin stesso, non di un problema del server o dell'hosting. Il server continua a funzionare normalmente.

Come risolvere:

  1. Aggiorna GravesX all'ultima versione in Plugin e riavvia.
  2. Controlla nella Console se il messaggio si ripresenta.
  3. Se l'errore persiste, segnalalo al progetto GravesX allegando il messaggio completo.
  4. Se vuoi disattivare temporaneamente il plugin per fare una prova in attesa della correzione, fai prima svuotare le tombe ancora aperte. Senza il plugin non si possono aprire come al solito.

FastAsyncWorldEdit: errore interno durante un comando

Ecco come appare il messaggio:

An unexpected error while handling a FastAsyncWorldEdit command
java.lang.NullPointerException

Cosa c'è dietro: FastAsyncWorldEdit (FAWE) è una variante veloce di WorldEdit che ti permette di modificare grandi aree in un colpo solo. Durante un comando, FAWE ha incontrato un valore mancante. L'operazione non è stata completata, quindi la modifica potrebbe essere stata applicata al mondo solo in parte. Il server continua a funzionare.

Come risolvere:

  1. Controlla nel gioco cosa ha modificato il comando. Con //undo puoi annullare l'ultimo passaggio, se necessario.
  2. Aggiorna FAWE in Plugin a una versione adatta a quella del tuo server e riavvia.
  3. Esegui di nuovo il comando.
  4. Se l'errore persiste, segnala agli sviluppatori di FAWE lo stacktrace completo e il comando esatto.

Le basi per annullare le modifiche: WorldEdit: costruire e annullare le modifiche.

Buono a sapersi: non installare FAWE insieme al normale WorldEdit. I due plugin non sono compatibili tra loro: usane solo uno.

“An unexpected exception occurred while performing command”: un comando di LibreLogin non va a buon fine

Ecco come appare il messaggio:

[LibreLogin] An unexpected exception occurred while performing command …

Cosa c'è dietro: LibreLogin è un plugin di login: i giocatori accedono con una password, spesso su server in modalità offline. Durante l'esecuzione di uno dei suoi comandi, ad esempio per il login o la registrazione, il plugin si è interrotto a causa di un'eccezione imprevista. Per il giocatore il comando non va a buon fine. Se il problema riguarda il login, il giocatore resta bloccato finché il comando non torna a funzionare. Il server continua a funzionare.

Come risolvere:

  1. Leggi nella Console l'eccezione sotto il messaggio e annota di quale comando si tratta.
  2. Aggiorna LibreLogin in Plugin e riavvia.
  3. Prova di nuovo il comando con un giocatore.
  4. Se l'errore persiste, segnala all'autore del plugin l'eccezione e il comando.

Se l'eccezione menziona un database: Il plugin non riesce ad aprire il suo database.

LibreLogin: handler di rete registrato due volte

Ecco come appare il messaggio:

java.lang.IllegalArgumentException: Duplicate handler name: pe-decoder-librelogin

Cosa c'è dietro: ogni connessione di un giocatore passa attraverso una catena di fasi di elaborazione, la pipeline di rete. LibreLogin o la libreria PacketEvents tenta di inserire una seconda volta la stessa fase, un decoder per i dati in entrata. Di conseguenza, le nuove connessioni possono non riuscire. Le cause tipiche sono due file di LibreLogin nella cartella dei plugin, versioni incompatibili di LibreLogin e PacketEvents o un ricaricamento dei plugin a server avviato.

Come risolvere:

  1. Apri la cartella plugins/ in File e controlla che LibreLogin sia presente una sola volta. Rimuovi le copie più vecchie dopo aver creato un backup.
  2. Aggiorna insieme LibreLogin e, se installato, PacketEvents.
  3. Arresta il server e riavvialo completamente. In questo caso non basta ricaricare con /reload o con un gestore di plugin.
  4. Prova l'accesso con un giocatore.

Per saperne di più sui file duplicati: Il file del plugin è danneggiato o duplicato.

LightAntiCheat-Plus: errore in un controllo dei movimenti

Ecco come appare il messaggio:

[LightAntiCheat-Plus] Exception in event bus subscription: <Prüfung>
java.lang.UnsupportedOperationException: remove

Cosa c'è dietro: LightAntiCheat-Plus è un plugin anti-cheat che, tra le altre cose, controlla i movimenti dei giocatori. Uno dei suoi controlli tenta di svuotare una lista che non può essere modificata. Si tratta di un errore del plugin. Il controllo interessato può smettere di funzionare o dare risultati errati, lasciando passare i cheat o sospettando ingiustamente i giocatori onesti. Il server continua a funzionare.

Come risolvere:

  1. Aggiorna LightAntiCheat-Plus in Plugin e riavvia.
  2. Se il messaggio continua a comparire, disattiva il controllo interessato, SpeedD, nella configurazione del plugin in attesa di una correzione. Lo trovi in File, nella cartella del plugin dentro plugins/. Prima fai un backup del file.
  3. Riavvia e controlla nella Console che il messaggio non compaia più.
  4. Riattiva il controllo non appena esce una versione corretta.

Buono a sapersi: finché compare il messaggio, valuta con cautela i sospetti legati ai movimenti.

MagicSpells segnala un errore in un incantesimo

Ecco come appare il messaggio:

[MagicSpells] AN EXCEPTION HAS OCCURED:
[MagicSpells] This error has been saved in the errors folder.
Error saving spellbook for player '<Spieler>'

Cosa c'è dietro: MagicSpells è un plugin per creare incantesimi personalizzati. Segnala un errore durante l'esecuzione o il salvataggio degli incantesimi, spesso a causa di una voce della configurazione che questa versione non riconosce. Gli effetti sono gestiti dalla libreria EffectLib; i messaggi con “Unexpected EffectLib Error” riguardano questi effetti. MagicSpells salva inoltre un report nella cartella plugins/MagicSpells/errors. Se il salvataggio del libro degli incantesimi (spellbook) non riesce, i progressi di quel giocatore non vengono salvati.

Come risolvere:

  1. Apri in File la cartella plugins/MagicSpells/errors e il report più recente. Indica l'incantesimo e l'impostazione interessati.
  2. Controlla questa impostazione nei tuoi file degli incantesimi, cercando ad esempio errori di battitura o valori di una versione precedente di MagicSpells. Prima fai un backup del file.
  3. Mantieni MagicSpells ed EffectLib aggiornati e compatibili con la versione del server.
  4. Riavvia e prova l'incantesimo.

SinglePlayerSleep: dormire nel letto non funziona

Ecco come appare il messaggio:

[SinglePlayerSleep] INTERNAL ERROR: Unable to process PlayerBedEnterEvent

Cosa c'è dietro: SinglePlayerSleep fa passare la notte quando dorme un solo giocatore, senza che tutti debbano andare a letto. Il plugin si è bloccato nel momento in cui un giocatore è entrato in un letto. Per quel tentativo la funzione di sonno può non essere disponibile e la notte non viene saltata. Di solito la versione del plugin non è adatta alla versione di Minecraft. Il server continua a funzionare.

Come risolvere:

  1. Controlla in Versione quale versione di Minecraft è in esecuzione.
  2. Aggiorna SinglePlayerSleep in Plugin a una versione adatta e riavvia.
  3. Fai una prova nel gioco: mettiti a letto di notte e controlla che la notte passi.
  4. Se l'errore persiste, segnala all'autore del plugin l'eccezione riportata sotto il messaggio.

Per saperne di più: le regole di gioco di Minecraft spiegate.

Buono a sapersi: le versioni più recenti di Minecraft hanno una regola di gioco apposita che stabilisce quale percentuale di giocatori deve dormire. Può sostituire il plugin.

PacketEvents non riesce ad agganciarsi alla connessione

Ecco come appare il messaggio:

PacketEvents failed to add a decoder to the netty pipeline

Cosa c'è dietro: PacketEvents è una libreria che permette ad altri plugin, ad esempio quelli anti-cheat o di login, di leggere i pacchetti di rete. Per farlo inserisce un proprio passaggio, un decoder, nella pipeline di rete di ogni connessione. Netty è la libreria di rete con cui il server gestisce le connessioni. L'inserimento non è riuscito: un altro handler di rete o una versione incompatibile di PacketEvents blocca l'ordine previsto. I plugin basati su PacketEvents, quindi, non funzionano correttamente per questa connessione.

Come risolvere:

  1. Aggiorna insieme PacketEvents, Geyser e Floodgate, oltre ai plugin di login e anti-cheat, a versioni adatte alla versione del tuo server.
  2. In File, controlla nella cartella plugins/ che non ci siano file duplicati.
  3. Arresta il server e riavvialo completamente, senza ricaricarlo mentre è in funzione.
  4. Prova ad accedere con Java e, se usi Geyser, anche con Bedrock.

Per i giocatori Bedrock: Bedrock e Geyser: i messaggi nel log.

StringIndexOutOfBoundsException: valore di testo vuoto o troppo corto

Ecco come appare il messaggio:

java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

Cosa c'è dietro: un plugin o una mod ha cercato di leggere un determinato carattere da un testo, ad esempio il primo carattere di un prefisso. Il testo però è più corto del previsto e, con “length 0”, addirittura vuoto. Spesso è vuoto un valore di configurazione atteso, come un prefisso, un colore o un nome inserito solo come ''. Il server continua a funzionare, ma la funzione che ha bisogno di quel testo non è disponibile.

Come risolvere:

  1. Nello stacktrace, leggi la prima riga che contiene il nome di un plugin o di una mod.
  2. In File, apri la configurazione di quel plugin nella cartella plugins/<Plugin>/ e cerca valori vuoti come '' o voci senza valore. Prima fai una copia di backup del file.
  3. Inserisci un valore valido oppure riprendi il valore predefinito dal modello del plugin.
  4. Aggiorna il plugin e riavvia il server.

Per saperne di più sulle impostazioni errate: Il file di configurazione di un plugin contiene errori.

“NoSuchFieldException: childHandler”: il plugin di rete non è compatibile con il server

Ecco come appare il messaggio:

java.lang.NoSuchFieldException: childHandler

Cosa c'è dietro: Netty è la libreria di rete con cui il server accetta le connessioni. Alcuni plugin accedono direttamente alle sue parti interne per agganciarsi alle connessioni. In questo caso un plugin di rete cerca il campo interno “childHandler”, che non è disponibile nella versione del server o di Netty installata. Il plugin, quindi, è stato creato per una build del server diversa. Di solito sono coinvolti plugin di rete, proxy o di protocollo, che smettono di funzionare.

Come risolvere:

  1. Leggi lo stacktrace sotto il messaggio e cerca il primo plugin di rete, proxy o di protocollo, ad esempio ViaVersion, ProtocolLib o Geyser.
  2. In Versione, controlla quale versione del server è in esecuzione. La versione esatta del software del server (build) si trova anche nelle prime righe di logs/latest.log.
  3. Aggiorna il plugin individuato a una versione adatta a questa build del server e riavvia.
  4. Se non esiste ancora una versione compatibile, disattiva temporaneamente il plugin finché l'autore non lo aggiorna.

Guida dettagliata: Il plugin non è compatibile con la versione del server.

“Unhandled exception during tab completion”: il comando del plugin non fornisce suggerimenti

Ecco come appare il messaggio:

Exception when <Spieler> attempted to tab complete
org.bukkit.command.CommandException: Unhandled exception during tab completion for command '<Befehl>' in plugin <Plugin> v<Version>

Cosa c'è dietro: quando premi il tasto Tab, Minecraft chiede al plugin responsabile i possibili completamenti. In questo caso la funzione di suggerimento del plugin non riesce a completare l'operazione. La prima riga indica il giocatore che ha premuto il tasto Tab. Il server continua a funzionare, mancano solo i suggerimenti per il comando interessato. La traccia dell'errore sottostante, il cosiddetto stacktrace, mostra le chiamate di programma coinvolte.

Come risolvere:

  1. Leggi il messaggio completo nella Console oppure in File, in logs/latest.log. Annota il plugin, il comando e il primo messaggio di errore specifico riportato sotto.
  2. In Versione, controlla la versione del tuo server e in Plugin installa una versione del plugin indicato adatta a quest'ultima.
  3. Riavvia completamente il server e prova di nuovo lo stesso comando con il tasto Tab.
  4. Se l'errore persiste, invia all'autore del plugin lo stacktrace completo e descrivi in quale punto mancano i suggerimenti.

StackOverflowError durante la valutazione di una regola di ricerca

Ecco come appare il messaggio:

Exception in thread "<Hintergrundaufgabe>" java.lang.StackOverflowError

Cosa c'è dietro: un'espressione regolare è una regola di ricerca per il testo, usata ad esempio nei filtri dei comandi. Per verificare questa regola, Java ha bisogno di troppe chiamate annidate e riempie così lo stack delle chiamate. L'attività in background indicata viene terminata e il suo lavoro resta incompleto, ma il server continua a funzionare. StackOverflowError è un errore diverso dall'esaurimento della memoria di Java.

Come risolvere:

  1. Apri lo stacktrace completo nella Console oppure in File, in logs/latest.log. Individua il plugin responsabile in base al nome del thread e alle chiamate del plugin.
  2. Fai un backup delle sue impostazioni e controlla le regole di ricerca o dei comandi configurabili. Semplifica la regola che causa l'errore, se l'hai impostata tu.
  3. In Plugin, aggiorna il plugin a una versione adatta e riavvia completamente il server.
  4. Se la regola è integrata nel plugin, segnala all'autore lo stacktrace completo e l'input che causa l'errore.

Paper blocca “entity add” da un thread in background

Ecco come appare il messaggio:

Thread <Thread> failed main thread check: entity add

Cosa c'è dietro: Paper verifica che le modifiche al mondo di gioco vengano eseguite sul thread corretto. Un thread è un flusso di esecuzione separato del programma. In questo caso un'attività in background cerca di aggiungere un'entità al mondo e viene fermata dal controllo di sicurezza. L'azione interessata non va a buon fine, ma il server continua a funzionare.

Come risolvere:

  1. Nella Console oppure in File, apri lo stacktrace completo in logs/latest.log. Il messaggio abbreviato spesso mostra solo le chiamate del server.
  2. Continua a leggere fino alla prima chiamata di un plugin e annota quale azione ha causato l'errore.
  3. In Plugin, installa una versione di questo plugin adatta alla versione del tuo server e riavvia completamente il server.
  4. Se l'errore si ripresenta, segnalalo all'autore del plugin allegando lo stacktrace completo. La chiamata del plugin deve essere spostata sul thread corretto.

Buono a sapersi: lascia attivo il controllo di sicurezza. Disattivarlo non risolve l'accesso errato al mondo.

Il calcolo del bottino fallisce per la mancanza di valori obbligatori

Ecco come appare il messaggio:

java.lang.IllegalArgumentException: Missing required parameters: [<Parameter>]

Cosa c'è dietro: per generare bottini e oggetti, Minecraft ha bisogno di informazioni sulla situazione specifica. In questo caso la funzione chiamante non fornisce tutti i valori obbligatori, perciò il calcolo viene interrotto. Puoi capire quale azione è coinvolta dal report completo dell'errore e dal momento in cui compare il messaggio.

Come risolvere:

  1. Apri il messaggio nella Console oppure in logs/latest.log sotto File, includendo l'elenco delle chiamate che segue. Questo elenco si chiama stack trace.
  2. Cerca al suo interno il primo plugin coinvolto e annota quale azione provoca l'errore.
  3. Aggiorna questo plugin sotto Plugin e controlla sotto Versione che il software del tuo server sia compatibile.
  4. Prova di nuovo la stessa azione. Se l'errore persiste, inoltra il report completo al progetto responsabile.

«NoSuchElementException» in Oritech: l'azione di un oggetto su un blocco si interrompe

Ecco come appare il messaggio:

Failed to handle packet <Paket>, suppressing error
java.util.NoSuchElementException: null
    at <Paket>.ItemFluidApi.tryFluidBlockItemInteraction(<Datei>:<Zeile>)

Cosa c'è dietro: la mod Oritech elabora un'azione in cui un oggetto viene usato su un blocco. La sua gestione dei fluidi tenta di leggere la prima voce di un elenco vuoto. Java segnala quindi una NoSuchElementException, cioè un accesso a una voce inesistente. L'azione si interrompe, ma il server continua a svolgere le altre attività.

Come risolvere:

  1. Annota l'oggetto usato, il blocco e l'orario. Crea un backup sotto Backup prima di apportare modifiche.
  2. Cerca sotto Mod un aggiornamento adatto di Oritech. La versione di Minecraft, il loader e, se usi un Modpack, le versioni delle mod previste devono essere compatibili tra loro.
  3. Se l'errore si ripresenta, per il momento evita l'azione che lo provoca. Segnalala all'autore di Oritech allegando la traccia completa dell'errore presente in logs/latest.log.

BeautyQuests: l'avanzamento della quest non si aggiorna nella barra laterale

Ecco come appare il messaggio:

[BeautyQuests.ScoreboardManager] Failed to refresh line {quest_advancement} for player <Spieler>
java.util.NoSuchElementException: No value present

Cosa c'è dietro: BeautyQuests inserisce nella barra laterale un segnaposto per l'avanzamento della quest, ma manca un valore numerico che il plugin si aspetta. La riga interessata non viene aggiornata, mentre il server continua a funzionare.

Come risolvere:

  1. Controlla nella Console oppure in logs/latest.log sotto File con quale quest compare il messaggio. La traccia dell'errore sottostante mostra le chiamate dei plugin coinvolti.
  2. Fai un backup della configurazione del plugin e aggiorna BeautyQuests sotto Plugin a una release compatibile con la versione del tuo server. Riavvia completamente il server.
  3. Se l'errore persiste, rimuovi temporaneamente sotto File la riga con {quest_advancement} dalla configurazione di BeautyQuests.
  4. Segnala all'autore del plugin la traccia completa e ripulita dell'errore e la configurazione della quest interessata. Rimuovi i dati personali prima di condividerle.

TAB usa un oggetto scartato dopo il ricaricamento

Ecco come appare il messaggio:

[TAB] java.lang.IllegalStateException: This instance got discarded because plugin was reloaded. Obtain a new instance.

Cosa c'è dietro: durante il ricaricamento, TAB ha sostituito i propri oggetti interni. Un'altra azione sta però ancora accedendo a un vecchio oggetto che TAB ha già scartato. Di conseguenza la registrazione del segnaposto interessato si interrompe e alcune parti della visualizzazione possono mancare. Il server continua a funzionare.

Come risolvere:

  1. Riavvia completamente il server e poi controlla la Console. Un riavvio completo ricarica insieme tutti i componenti coinvolti.
  2. Se il messaggio ricompare, fai un backup della configurazione e aggiorna TAB e le sue estensioni a versioni compatibili tra loro. Su Fabric usa Mod, per i file caricati manualmente usa File.
  3. Per il momento esegui solo riavvii completi. Annota quale azione fa ricomparire il messaggio.
  4. Se gli errori persistono, fornisci all'autore di TAB la traccia ripulita dell'errore e le versioni installate.

Un plugin lascia attività in background in esecuzione durante il ricaricamento o l'arresto

Ecco come appare il messaggio:

Nag author: '<Autor>' of '<Plugin>' about the following: This plugin is not properly shutting down its async tasks when it is being shut down.

Cosa c'è dietro: il plugin indicato non termina correttamente le sue attività asincrone, cioè i processi eseguiti parallelamente al ciclo principale del server. Dopo un ricaricamento, le attività vecchie e nuove del plugin possono entrare in conflitto; durante un arresto regolare possono comparire ulteriori messaggi di errore.

Come risolvere:

  1. Controlla nella Console quale plugin viene indicato e se il messaggio compare durante il ricaricamento o durante un normale arresto.
  2. Se è comparso dopo un ricaricamento, riavvia completamente il server. In seguito esegui sempre riavvii completi quando modifichi i plugin.
  3. Fai un backup della configurazione del plugin e aggiorna il plugin interessato sotto Plugin a una versione compatibile.
  4. Se il messaggio continua a comparire durante gli arresti regolari, segnalalo all'autore del plugin indicando le righe di log corrispondenti e la versione del tuo server.

Paper blocca un accesso ai POI da un thread in background

Ecco come appare il messaggio:

[ca.spottedleaf.moonrise.common.util.TickThread] Thread failed main thread check: Accessing poi chunk off-main, context=<Threadkontext>

Cosa c'è dietro: POI significa «Point of Interest» e indica luoghi importanti, come le postazioni di lavoro dei villici. In questo caso un thread in background tenta di accedere ai relativi dati di una sezione del mondo. Paper consente questo accesso solo al thread di gioco competente e interrompe l'azione interessata.

Come risolvere:

  1. Apri la traccia completa dell'errore nella Console oppure in logs/latest.log sotto File. Si tratta delle righe di chiamata sotto il messaggio; controlla se viene menzionato un plugin.
  2. Crea un backup sotto Backup. Aggiorna Paper sotto Versione e i plugin coinvolti sotto Plugin a release compatibili tra loro.
  3. Riavvia completamente il server e osserva se la stessa azione provoca di nuovo l'errore.
  4. Se il messaggio persiste senza alcun riferimento a un plugin, fornisci agli sviluppatori di Paper la traccia ripulita dell'errore, la versione del server e i passaggi per riprodurlo. Se invece viene menzionato un plugin, segnalalo al suo autore.

I dati giocatore di LuckPerms non sono ancora pronti all'accesso

Ecco come appare il messaggio:

Couldn't place player in world
java.lang.IllegalStateException: Capability has not been initialised

Cosa c'è dietro: l'accesso fallisce a causa di un controllo dei permessi. La traccia dell'errore passa per LuckPerms, il cui archivio di dati relativo ai giocatori, la cosiddetta Capability, in quel momento non è ancora pronto. Di conseguenza il giocatore interessato non viene inserito correttamente nel mondo.

Come risolvere:

  1. Leggi nella Console o in logs/latest.log i messaggi di LuckPerms che precedono l'errore e annota le mod coinvolte.
  2. Controlla in Mod se LuckPerms e la mod che effettua la richiesta sono compatibili con la tua versione di NeoForge e di Minecraft. Usa versioni supportate da entrambe.
  3. Riavvia completamente il server e prova di nuovo ad accedere. Se l'errore persiste, segnalalo agli autori delle mod coinvolte, allegando lo stack trace completo e le informazioni sulle versioni.

Una richiesta sui fluidi non trova il calderone previsto

Ecco come appare il messaggio:

java.lang.IllegalStateException: Unexpected error: no cauldron at location BlockPos{<Position>}

Cosa c'è dietro: un'interfaccia per i fluidi si aspetta un calderone nella posizione richiesta, ma trova un altro stato del blocco. Nello stack trace, Jade interroga questa interfaccia per leggere le informazioni sui fluidi. La richiesta interessata viene interrotta e le informazioni su questo blocco potrebbero quindi mancare.

Come risolvere:

  1. Leggi lo stack trace completo in logs/latest.log e controlla con quale azione sul blocco il messaggio si ripresenta.
  2. Crea un backup in Backup. In Mod, allinea Jade, le mod dei fluidi coinvolte e la versione di NeoForge a versioni supportate da tutte.
  3. Riavvia completamente il server e ripeti l'azione. Se l'errore persiste, segnala agli autori coinvolti l'azione esatta e lo stack trace.

MoreRelics calcola un valore numerico non valido durante un'azione di combattimento

Ecco come appare il messaggio:

Exception caught during firing event: max is NaN

Cosa c'è dietro: NaN sta per «Not a Number», un valore di calcolo non valido. Durante un'azione di combattimento, MoreRelics passa questo valore come limite massimo a un controllo numerico. Il controllo lo rifiuta e l'elaborazione dell'evento interessato viene interrotta; il server continua poi a elaborare gli altri eventi.

Come risolvere:

  1. Leggi nella Console o in logs/latest.log lo stack trace completo e annota l'azione che lo ha causato.
  2. Crea un backup in Backup. In Mod, verifica di avere una versione di MoreRelics compatibile con il tuo Modpack e con NeoForge.
  3. Riavvia completamente il server e prova la stessa azione. Se l'errore persiste, segnalalo all'autore, indicando lo stack trace, l'elenco delle mod e gli oggetti o gli effetti utilizzati.

Citizens fallisce a causa di un valore vuoto durante l'invio dei dati dei pacchetti

Ecco come appare il messaggio:

java.lang.NullPointerException
    at Citizens-<Version>.jar//net.citizensnpcs.PacketEventsHook.<Methode>(<Datei>:<Zeile>)

Cosa c'è dietro: durante l'invio dei dati dei pacchetti, Citizens accede a un valore mancante tramite la sua integrazione con PacketEvents. Java chiama questo valore vuoto null e si interrompe con una NullPointerException. L'elaborazione del pacchetto interessato non riesce e gli aggiornamenti degli NPC, cioè i personaggi controllati dal computer, possono risultare incompleti.

Come risolvere:

  1. Leggi lo stack trace completo in logs/latest.log e annota durante quale azione dell'NPC si verifica l'errore.
  2. Salva lo stato attuale in Backup. In Plugin, controlla quali versioni di Citizens, PacketEvents e del software del tuo server sono compatibili tra loro.
  3. Se necessario, sostituisci i file in File, riavvia completamente il server e prova la stessa azione. Se l'errore persiste, segnala all'autore lo stack trace e le informazioni sulle versioni.

NovaSync non trova il programma di supporto per gli aggiornamenti del sistema operativo

Ecco come appare il messaggio:

[NovaSyncPlugin] [os-updates] helper start failed subcmd=status err=IOException:Cannot run program "sudo": Exec failed, error: 2 (No such file or directory)

Cosa c'è dietro: NovaSync cerca di avviare un programma di supporto esterno per gli aggiornamenti del sistema operativo. Per farlo, il plugin richiama sudo, un programma che esegue comandi con i permessi di un altro utente. L'ambiente del server non trova questo programma, quindi la preparazione o il controllo dello stato della funzione di aggiornamento non riescono. Il server di gioco continua a funzionare.

Come risolvere:

  1. Leggi il messaggio completo nella Console oppure in logs/latest.log tramite File e annota l'ora in cui compare.
  2. Controlla nella guida della versione di NovaSync installata i requisiti di os-updates e il programma di supporto necessario.
  3. Apri un ticket indicando l'ora del messaggio e la versione del plugin, così da chiarire se il programma di supporto è disponibile nell'ambiente del tuo server.

Buono a sapersi: il messaggio riguarda la funzione di aggiornamento del sistema operativo di NovaSync, non l'aggiornamento dei tuoi plugin di Minecraft.

ProtocolLib non riesce a identificare una segnalazione di errore

Ecco come appare il messaggio:

[ProtocolLib] Error filtering reports: java.lang.IllegalArgumentException: Cannot find report name for Plugin %s tried to register listener for unknown packet %s

Cosa c'è dietro: ProtocolLib aiuta altri plugin a elaborare i pacchetti di rete, cioè i messaggi scambiati tra il server e il client di gioco. In questo caso non riesce nemmeno a identificare un report diagnostico. Il report riguarda la registrazione di un tipo di pacchetto sconosciuto. Il server continua a funzionare, ma devi controllare la funzione dei pacchetti interessata e la relativa diagnostica.

Come risolvere:

  1. Leggi nella Console o in logs/latest.log le righe immediatamente precedenti e successive al messaggio. Cerca il plugin e il tipo di pacchetto coinvolti.
  2. Controlla le versioni del server supportate da ProtocolLib e da quel plugin. Aggiorna entrambi a versioni compatibili in Plugin.
  3. Arresta il server prima di sostituire i file, poi riavvialo completamente. Controlla di nuovo la funzione interessata in precedenza.
  4. Se il messaggio persiste, invia all'autore del plugin il blocco di errore completo e le versioni utilizzate.

EliteMobs non riesce ad attivare la sua funzione per le munizioni

Ecco come appare il messaggio:

[EliteMobs] Cannot enable native ammunition for <Verbindung>: java.util.NoSuchElementException: packet_handler

Cosa c'è dietro: EliteMobs cerca di configurare la sua funzione nativa per le munizioni per una connessione. Un handler è una fase interna di elaborazione dei dati di rete. La fase prevista, denominata packet_handler, manca nel punto richiesto. Di conseguenza questa parte della funzione non viene attivata; il server continua a funzionare.

Come risolvere:

  1. Leggi nella Console o in logs/latest.log i messaggi vicini. Fai attenzione agli errori precedenti durante la creazione della connessione.
  2. Confronta le versioni del server supportate da EliteMobs con la tua Versione. Controlla anche le dipendenze indicate dall'autore.
  3. Arresta il server e aggiorna EliteMobs a una versione compatibile in Plugin. Poi riavvia completamente il server e prova la funzione interessata.
  4. Se l'errore persiste, segnalalo all'autore di EliteMobs, indicando il blocco di errore completo, la versione del server e l'elenco dei plugin. Queste informazioni aiutano a individuare la fase di elaborazione mancante.

LuckPerms blocca un login autorizzato in modo contraddittorio

Ecco come appare il messaggio:

[LuckPerms] Player connection was re-allowed for <Spieler-ID>

Cosa c'è dietro: durante un accesso, alcuni plugin hanno preso decisioni contraddittorie. LuckPerms blocca la connessione nuovamente autorizzata per proteggere la propria gestione dei permessi. L'accesso interessato non riesce, ma il server continua a funzionare.

Come risolvere:

  1. Nella Console o in logs/latest.log, leggi i messaggi immediatamente precedenti all'accesso non riuscito. Cerca errori di caricamento dei dati e messaggi dei plugin di login.
  2. Se viene indicato un errore del database o di caricamento dei dati, risolvi prima quello. Controlla poi quale plugin di login annulla un rifiuto precedente.
  3. In Plugins, aggiorna i componenti interessati a versioni compatibili tra loro e con la versione del server. Arresta il server prima della sostituzione e riavvialo al termine.
  4. Riprova ad accedere. Se il conflitto persiste, invia agli autori dei plugin coinvolti il blocco di errore completo e l'elenco dei plugin.

Buono a sapersi: non disattivare il controllo di accesso per aggirare il conflitto.

Apotheosis: un'azione su un blocco non riesce a causa di un oggetto vuoto

Ecco come appare il messaggio:

Failed to handle packet <Paket>, suppressing error
java.lang.IllegalArgumentException: Expected resource to be non-empty: minecraft:air [0]
at <Loader>/dev.shadowsoffire.apotheosis.affix.salvaging.<Aufruf>

Cosa c'è dietro: durante un'azione su un blocco, Apotheosis arriva alla sua funzione di smantellamento. In questa fase, una pila di oggetti vuota viene passata all'interfaccia di trasferimento di NeoForge, che richiede però un oggetto esistente. Per questo l'interazione si interrompe, mentre il server continua a funzionare. Lo stacktrace, cioè la catena di chiamate sotto il messaggio di errore, passa in questo caso da Apotheosis e NeoForge.

Come risolvere:

  1. Salva lo stato attuale in Backup. Annota quale azione sul blocco genera il messaggio ed evitala per il momento.
  2. Apri il messaggio completo nella Console oppure, tramite File, in logs/latest.log. Prendi nota anche delle righe che precedono l'errore.
  3. In Mods, controlla che Apotheosis e le mod richieste siano compatibili con la tua versione di Minecraft e NeoForge. Se usi un Modpack, scegli una versione coerente del pack. Arresta il server prima di sostituire i file e riavvialo al termine.
  4. Se il messaggio persiste, invia all'autore della mod lo stacktrace completo, le versioni installate e l'azione che causa l'errore.

ProtocolLib: un plugin richiede l'UUID di un giocatore temporaneo

Ecco come appare il messaggio:

[<Plugin>] Unhandled exception occurred in onPacketSending(PacketEvent) for <Plugin>
java.lang.UnsupportedOperationException: The method getUniqueId is not supported for temporary players.

Cosa c'è dietro: durante la connessione, ProtocolLib fornisce oggetti giocatore temporanei. L'UUID, l'identificativo univoco dell'account, non può ancora essere richiesto tramite questo oggetto. Un plugin prova comunque a farlo durante l'invio di un pacchetto. Il suo packet handler, cioè la funzione che elabora il pacchetto, si interrompe di conseguenza, ma il server continua a funzionare.

Come risolvere:

  1. Nella Console, leggi quale plugin viene indicato dopo «for». Salva lo stacktrace completo da logs/latest.log.
  2. In Plugins, controlla che questo plugin e ProtocolLib supportino la Versione del tuo server. Usa versioni compatibili tra loro.
  3. Arresta il server prima di sostituire i file. Riavvialo poi completamente e riprova ad accedere.
  4. Se l'errore persiste, segnalalo all'autore del plugin interessato, indicando lo stacktrace completo, le versioni installate e l'azione che causa l'errore.

GodWand: pacchetto non valido per un tempo di ricarica

Ecco come appare il messaggio:

java.lang.IllegalArgumentException: Invalid skill cooldown packet
  at net.godwand.network.SkillCooldownPayload.<init>(<Datei>:<Zeile>)

Cosa c'è dietro: quando si usa la bacchetta, GodWand scarta un pacchetto relativo al tempo di ricarica di un'abilità. Questo tempo determina quando l'abilità può essere usata di nuovo. L'azione dell'oggetto non riesce, mentre il server continua a funzionare.

Come risolvere:

  1. Apri la Console o logs/latest.log e leggi il messaggio completo. La traccia dell'errore che segue, chiamata anche stacktrace, indica la classe di GodWand coinvolta.
  2. Confronta le versioni di GodWand su server e client. In Mods, controlla anche le versioni di Minecraft e NeoForge supportate.
  3. Arresta il server, installa una versione compatibile ed esegui un riavvio completo. Riprova poi l'azione dell'oggetto.
  4. Se l'errore persiste, segnala all'autore della mod lo stacktrace e l'azione che causa l'errore. Rimuovi i dati personali dalla segnalazione.

ModelEngine: manca l'indirizzo della skin per un modello giocatore

Ecco come appare il messaggio:

java.lang.RuntimeException: Skin URL is null
  at com.ticxo.modelengine.api.model.limb.UserLimbRegistry.generate(<Datei>:<Zeile>)

Cosa c'è dietro: durante l'accesso, ModelEngine prova a creare parti del modello con la skin di un giocatore, ma manca l'indirizzo dell'immagine necessario; «null» significa qui che non è presente alcun valore. La funzione del modello interessata non riesce, mentre il server continua a funzionare.

Come risolvere:

  1. Controlla nella Console o in logs/latest.log se lo stesso messaggio compare dopo un nuovo accesso.
  2. Chiedi al giocatore interessato di controllare la propria skin sul client e di accedere di nuovo. Se necessario, controlla anche l'estensione per le skin in uso.
  3. Confronta ModelEngine e le estensioni coinvolte con la versione del server. Arresta il server prima di sostituire i file dei plugin tramite Plugins e riavvialo al termine.
  4. Se l'errore persiste, invia all'autore di ModelEngine lo stacktrace completo, cioè la catena di chiamate sotto l'errore. Rimuovi i dati personali.

Una mod imposta uno stato del blocco non valido

Ecco come appare il messaggio:

Cannot set property <Eigenschaft> to <Wert> on Block{<Block>}, it is not an allowed value

Cosa c'è dietro: durante un'interazione con un blocco, una mod imposta per una proprietà un valore non consentito. Minecraft scarta l'elaborazione del pacchetto interessato e l'azione sul blocco non riesce. Lo stacktrace descrive la catena di chiamate nel programma; la prima classe di mod indicata è un buon punto di partenza per il controllo.

Come risolvere:

  1. In File, apri logs/latest.log e individua dallo stacktrace la mod coinvolta e la proprietà del blocco interessata.
  2. In Mods, cerca una correzione della mod compatibile con la tua versione di Minecraft e, prima di procedere, salva il mondo in Backup.
  3. Dopo l'aggiornamento, esegui un riavvio completo e prova la stessa azione sul blocco; fino alla risoluzione del problema, evita di ripeterla durante il normale gioco.

Minecraft salta troppi aggiornamenti concatenati dei blocchi

Ecco come appare il messaggio:

Too many chained neighbor updates. Skipping the rest. First skipped position: <Position>

Cosa c'è dietro: una catena di aggiornamenti dei blocchi raggiunge il limite di sicurezza di Minecraft. Gli ulteriori aggiornamenti di questa catena vengono saltati e, per esempio, i circuiti di redstone possono temporaneamente non reagire come previsto. Il server continua a funzionare, ma alcune reazioni dei blocchi della catena interessata non si verificano. Aumentare semplicemente il limite di sicurezza non elimina la catena che causa il problema.

Come risolvere:

  1. Associa la posizione indicata nella console al circuito o alla macchina della mod interessati e ferma ciò che li attiva.
  2. Salva il mondo in Backup e riduci la catena di attivazioni simultanee, ad esempio dividendo il circuito.
  3. Prova la modifica dopo un riavvio completo e, per i blocchi delle mod, cerca in Mod una correzione adatta.

UnstableFarlandsExpansion non trova una foresta adatta alla riparazione

Ecco come appare il messaggio:

[UnstableFarlandsExpansion] Forest repair stopped; backup retained if editing began
No verified old-generator forest found; nothing changed

Cosa c'è dietro: La riparazione delle foreste di UnstableFarlandsExpansion non trova una foresta confermata del vecchio generatore e si interrompe. Con questa interruzione il mondo resta invariato e la riparazione richiesta non viene eseguita. Il server continua a funzionare. Qui il plugin termina di proposito la riparazione, perché il suo controllo non riconosce una foresta di partenza adatta.

Come risolvere:

  1. Controlla nella console il messaggio completo e verifica che come causa compaia davvero No verified old-generator forest found.
  2. Leggi la guida della versione installata del plugin e verifica che l'area scelta provenga dal vecchio generatore supportato.
  3. Prima di un nuovo tentativo di riparazione, crea un backup in Backup e scegli solo un'area adatta secondo la guida.

Una mod aggiunge un'entità da un thread in background

Ecco come appare il messaggio:

A mod is trying to add an entity from offthread, this should be avoided. Printing trace:

Cosa c'è dietro: Una mod aggiunge un'entità al mondo al di fuori del thread di gioco previsto. Questo accesso simultaneo non è sicuro e può disturbare l'elaborazione delle entità; la traccia dell'errore che segue indica le mod coinvolte. Un thread è un filone di esecuzione del programma. L'eccezione diagnostica mostra il percorso delle chiamate e qui serve a individuare l'accesso non sicuro.

Come risolvere:

  1. Tramite File, leggi la traccia dell'errore in logs/latest.log e cerca la mod che esegue la chiamata per aggiungere l'entità.
  2. Crea un backup in Backup e cerca in Mod una correzione adatta per questa mod e le sue dipendenze.
  3. Dopo l'aggiornamento, riavvia completamente il server e prova di nuovo ciò che ha causato l'errore; se si ripresenta, invia la traccia completa agli sviluppatori della mod.

Paper non riesce a far accedere un giocatore a causa di una dimensione di lista non valida

Ecco come appare il messaggio:

Couldn't place player in world
IllegalArgumentException: arraySize cannot be negative but was: <valore negativo>

Cosa c'è dietro: Durante l'inserimento di un giocatore nel mondo viene richiesta una lista di dimensione negativa. L'accesso di questo giocatore fallisce a causa dell'errore interno, mentre il server continua a elaborare le altre attività. Il messaggio riguarda il calcolo della dimensione di una lista interna. Un piano con più RAM non corregge questo valore negativo.

Come risolvere:

  1. Tramite File, controlla in logs/latest.log la traccia completa dell'errore e i messaggi di accesso immediatamente precedenti.
  2. Crea un backup in Backup e cerca in Versione una build di Paper più recente e adatta, oltre a versioni compatibili dei plugin coinvolti.
  3. Dopo l'aggiornamento, riavvia completamente il server e prova l'accesso; se l'errore persiste, segnalalo allegando il log completo.

LibreLogin esegue un accesso bloccante nel thread di gioco

Ecco come appare il messaggio:

[LibreLogin] AN IO OPERATION IS BEING PERFORMED ON THE MAIN THREAD! THIS IS A SERIOUS BUG!

Cosa c'è dietro: LibreLogin rileva un'operazione di input/output sul thread principale del server. Mentre questa operazione è in attesa, l'elaborazione del gioco può rallentare a scatti; la traccia dell'errore che segue mostra la chiamata del plugin che l'ha causata. Le operazioni di input/output leggono o scrivono, ad esempio, file o contenuti di database. Sul thread di gioco, i loro tempi di attesa entrano in competizione con le attività di gioco in corso.

Come risolvere:

  1. Tramite File, leggi in logs/latest.log la traccia completa dell'errore subito sotto l'avviso di LibreLogin e annota cosa l'ha causato.
  2. Crea un backup in Backup e cerca in Plugin una correzione adatta alla versione del server per LibreLogin e le estensioni coinvolte.
  3. Dopo un aggiornamento, riavvia completamente il server e, se l'avviso si ripresenta, segnalalo agli sviluppatori del plugin allegando la traccia dell'errore.

Paper blocca l'espulsione di un giocatore da un thread in background

Ecco come appare il messaggio:

Warning: This command deletes or removes game content. Create a backup first and check the command’s target.

Thread <thread del plugin> failed main thread check: player kick
java.lang.IllegalStateException: Asynchronous player kick!

Cosa c'è dietro: Un thread è un filone di esecuzione del programma. Qui le azioni sui giocatori devono avvenire nel thread principale del gioco. Un plugin richiama invece l'espulsione da un'attività in background e Paper impedisce questo accesso. La singola espulsione fallisce, ma il server continua a funzionare.

Come risolvere:

  1. Apri la traccia completa dell'errore nella Console o tramite File in logs/latest.log. Le righe di chiamata successive, cioè lo stacktrace, indicano il plugin coinvolto.
  2. Cerca in Plugin un aggiornamento adatto alla tua Versione. Ferma il server per sostituire i file e poi riavvialo.
  3. Prova di nuovo l'azione che doveva causare l'espulsione. Se l'errore persiste, invia all'autore del plugin la traccia completa dell'errore e descrivi questa azione.

AntiRelog non riesce a leggere un pacchetto per i tempi di ricarica

Ecco come appare il messaggio:

[AntiRelog] Unhandled exception occurred in onPacketSending(PacketEvent) for AntiRelog
com.comphenix.protocol.reflect.FieldAccessException: Field index 0 is out of bounds for length 0

Cosa c'è dietro: AntiRelog gestisce tramite ProtocolLib i tempi di ricarica degli oggetti. Per farlo legge un campo da un pacchetto di rete, cioè un messaggio inviato al gioco. Il campo previsto non è presente in questa forma e l'elaborazione di questo tempo di ricarica si interrompe. Il server continua a funzionare.

Come risolvere:

  1. Apri il messaggio completo nella Console o in File in logs/latest.log. Annota le versioni del server, di AntiRelog e di ProtocolLib.
  2. Controlla sulle pagine dei plugin quali versioni funzionano tra loro e con la versione del tuo server. Aggiorna di conseguenza AntiRelog e ProtocolLib in Plugin.
  3. Ferma il server prima di sostituire i file e poi riavvialo completamente.
  4. Se l'errore si ripresenta, invia all'autore di AntiRelog il messaggio completo con le versioni e l'azione di gioco che lo ha causato.

Un giocatore non riesce a entrare a causa di un valore mancante

Ecco come appare il messaggio:

Couldn't place player in world
java.lang.NullPointerException

Cosa c'è dietro: Durante l'accesso, il server non riesce a inserire un giocatore nel mondo. Una parte del programma tenta di usare un valore mancante, che Java chiama “null”. L'accesso interessato si interrompe, ma il server continua a funzionare. Le righe di errore che seguono aiutano a trovare la parte del programma coinvolta.

Come risolvere:

  1. Chiedi al giocatore di riprovare ad accedere e controlla se l'errore si ripresenta.
  2. Apri il messaggio completo nella Console oppure in File, nel file logs/latest.log. Leggi anche le righe precedenti. Le righe «at» che seguono formano lo stack trace, cioè la catena di chiamate che ha portato all'errore.
  3. Se questa catena di chiamate cita un plugin coinvolto, verifica che supporti la versione del tuo server nella sezione Plugin e sulla pagina del plugin. Arresta il server prima di sostituire i file e poi riavvialo.
  4. Se l'accesso continua a dare problemi o non riesci a individuare il componente responsabile, apri un ticket e indica l'orario del messaggio.

NameTag non riesce a disattivare la visualizzazione dei nomi

Ecco come appare il messaggio:

[NameTag] Failed to disable Name Tag implementation: Plugin attempted to register task while disabled

Cosa c'è dietro: Mentre disattiva la visualizzazione dei nomi, NameTag tenta di registrare un'altra attività sul server. A quel punto, però, il plugin è già disattivato. Il server quindi rifiuta l'attività e NameTag interrompe questa procedura di disattivazione con un errore. Il problema riguarda la pulizia finale della funzione del plugin.

Come risolvere:

  1. Controlla nella Console oppure in File, nel file logs/latest.log, se il messaggio compare durante un normale arresto o dopo aver ricaricato un plugin.
  2. Riavvia completamente il server. Non usare un plugin reloader per NameTag e controlla nella sezione Plugin se è disponibile una release compatibile con la Versione del server.
  3. Se l'errore si ripete durante il normale arresto, segnala all'autore di NameTag lo stack trace completo, ripulito dai dati sensibili, e le versioni coinvolte. Salva le impostazioni prima di sostituire i file.

Il tuo messaggio non è in elenco?

Leggi tutto il messaggio, comprese le righe precedenti. Spesso lì è indicato cosa stava cercando di fare il plugin. Nello stack trace, i nomi dei file nelle righe «at», ad esempio <Plugin>.jar, e i nomi dei pacchetti rivelano il plugin o la mod responsabile. Le righe con java.base, net.minecraft, org.bukkit o io.papermc appartengono a Java e al server. Crea un backup, aggiorna il componente che causa il problema e riavvia. Se non riesci a risolvere, apri un ticket e indica l'orario del messaggio.