Un plugin di Minecraft è un file JAR (un archivio Java) che si trova nella cartella plugins/ ed è sempre compilato per determinate versioni di Minecraft, per una determinata versione di Java e di solito anche per un determinato software server come Paper o Spigot. Se uno di questi elementi non corrisponde, il plugin non si carica affatto, si disattiva da solo o alcune funzioni smettono di funzionare. Ogni sezione qui sotto tratta un messaggio specifico: come si presenta, qual è la causa e come risolverlo.
Trovi il messaggio completo nella Console oppure in File, in logs/latest.log. Leggi anche le righe precedenti, perché spesso indicano il plugin interessato. Da noi la versione di Java viene impostata automaticamente in base alla versione di Minecraft. Le versioni supportate da un plugin sono indicate nella sua pagina di download. Prima di cambiare versione o modificare file di configurazione e del mondo, crea un backup in Backup.
UnsupportedClassVersionError: il plugin o il server richiede una versione di Java più recente
Ecco come si presenta il messaggio:
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
java.lang.UnsupportedClassVersionError: <Klasse> has been compiled by a more recent version of the Java Runtime …
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: <Klasse> …
Qual è la causa: il file richiede una versione di Java più recente di quella usata dal tuo server. Il messaggio completo indica la versione del file di classe richiesta e la più alta supportata: 69.0 corrisponde a Java 25, 65.0 a Java 21. Se il messaggio riguarda un plugin, questo non si avvia; se riguarda il JAR del server, non si avvia l'intero server.
Come risolvere:
- Leggi il messaggio completo in File, in
logs/latest.log, oppure nella Console. Controlla i requisiti Java del file indicato nella pagina del progetto. - Se si tratta di un plugin, scarica una release per la tua versione di Minecraft che funzioni anche con la versione di Java in uso. Arresta il server, sostituisci il vecchio file in
plugins/e riavvia. - Se si tratta di un JAR del server, verifica che il file corrisponda alla Versione selezionata. Impostiamo automaticamente la versione di Java adatta per ogni versione di Minecraft.
- Se devi cambiare versione, fai prima un backup del server in Backup. Se l'abbinamento è già corretto e l'errore persiste, apri un ticket e indica l'ora in cui è comparso il messaggio.
Approfondimento: Quale versione di Java serve al tuo server Minecraft?
«Unsupported API version …»: il plugin richiede una versione di Minecraft più recente
Ecco come si presenta il messaggio:
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
org.bukkit.plugin.InvalidPluginException: Unsupported API version <Version>
Qual è la causa: ogni plugin include un piccolo file descrittivo, il plugin.yml. Al suo interno, api-version indica la versione API richiesta, cioè la versione dell'interfaccia di programmazione del server. Se questa versione è più recente di quella del tuo server, Paper non carica affatto il plugin, come nel caso di Unsupported API version 26.1 su un server con la 1.21.11. Il server si avvia, ma tutto ciò che il plugin dovrebbe offrire manca completamente: comandi, regole di protezione, menu.
Come risolvere:
- Confronta il numero dopo
Unsupported API versioncon la versione di Minecraft del tuo server, indicata in Versione. - Su Modrinth o SpigotMC filtra i download del plugin in base alla tua versione di Minecraft e scarica la release adatta.
- Arresta il server, sostituisci il vecchio file in File, nella cartella
plugins/, e riavvia. - Se non esiste una release adatta, imposta in Versione la versione richiesta dal plugin. Crea prima un backup, perché il mondo verrà convertito alla nuova versione.
Buono a sapersi: non modificare manualmente api-version nel file del plugin. Aggirare il controllo non aggiunge le funzioni mancanti del server; usa una release del plugin adatta.
Per saperne di più: Cambiare in sicurezza la versione di Minecraft e il modloader
«Fatal error trying to convert»: Paper non riesce a caricare un plugin compilato per un Java più recente
Ecco come si presenta il messaggio:
Fatal error trying to convert <Plugin> v<Version>:<Pfad>/<Klasse>.class
java.lang.IllegalArgumentException: Unsupported class file major version 65
java.lang.IllegalArgumentException: Unsupported class file major version 69
Qual è la causa: durante il caricamento, Paper trasforma i plugin con un convertitore integrato. Il numero indica per quale versione di Java è stato compilato il plugin: 65 corrisponde a Java 21, 69 a Java 25. Paper 1.19.4 o precedenti non leggono le classi per Java 21 o successivi. Anche versioni più recenti di Paper, come la 1.21.1 o la 1.21.4, non riescono a leggere le classi per Java 25. Il plugin non viene caricato. Capita spesso con Geyser: in quel caso i giocatori Bedrock non possono entrare. Il server si avvia comunque e i giocatori Java possono continuare ad accedere.
Come risolvere:
- Leggi il nome del plugin interessato dopo
trying to convert. - Se vuoi restare sulla tua versione di Minecraft, scarica una release meno recente del plugin per quella versione esatta e sostituisci il file in File, nella cartella
plugins/. - In alternativa, imposta in Versione una versione di Minecraft più recente. Con 65 basta la 1.20.5 o successiva, perché le build più recenti di Paper leggono le classi Java 21. Con 69, le versioni supportate sono indicate nella pagina del plugin. Crea prima un backup in Backup.
- Riavvia e controlla nella Console che il plugin si carichi senza errori.
Buono a sapersi: il messaggio compare spesso più volte di seguito, una per ogni classe. Il plugin interessato resta comunque uno solo.
Approfondimento: Quale versione di Java serve al tuo server Minecraft?
«Unsupported server version»: il plugin non supporta la versione del server
Ecco come si presenta il messaggio:
[Essentials] You are running an unsupported server version!
[Shopkeepers] Incompatible server version: Shopkeepers cannot be enabled.
[voicechat] Could not load any compatibility for <Version>
Qual è la causa: all'avvio il plugin controlla su quale versione di Minecraft e su quale software server è in esecuzione. Se non supporta la versione o il software server, mostra un avviso oppure si disattiva del tutto o in parte. Il motivo può essere una versione troppo recente o troppo vecchia, oppure il software server sbagliato. Il server continua comunque a funzionare.
Come risolvere:
- Sui server Bukkit/Paper digita
pluginsnella Console. I plugin in verde sono attivi, quelli in rosso sono disattivati. - Controlla nella pagina del plugin quali versioni di Minecraft e quali software server sono supportati.
- Scarica la release adatta, arresta il server e sostituisci il vecchio file in File, nella cartella
plugins/. Poi riavvia. - Se non esiste, crea un backup in Backup. Scegli poi una versione di Minecraft supportata in Versione oppure un software server supportato tramite Cambia software / loader. Per passare a una versione di Minecraft precedente ti serve un mondo compatibile; se necessario, usa un backup precedente all'aggiornamento.
Buono a sapersi: anche un plugin attivo può aver disattivato singole funzioni. Prova i comandi che ti servono.
«Failed to remap plugin jar …»: Paper non riesce a rimappare il plugin
Ecco come si presenta il messaggio:
[PluginRemapper] Encountered exception remapping plugins
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to remap plugin jar 'plugins/<Plugin>.jar'
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to open plugin jar plugins/<Plugin>.jar
Cosa c'è dietro: le versioni più recenti di Paper riscrivono all'avvio i plugin più vecchi adattandoli alla struttura interna della versione attuale di Minecraft: questo processo si chiama remapping. Le copie di lavoro si trovano in plugins/.paper-remapped. Con Failed to open plugin jar non si riesce nemmeno ad aprire il file JAR originale, negli altri casi è la riscrittura a fallire. Il server continua ad avviarsi, ma il plugin potrebbe non funzionare affatto o funzionare solo in parte, spesso senza altri messaggi di errore.
Come risolvere:
- Leggi il nome del file dopo
Failed to remap plugin jaroFailed to open plugin jar. - Controlla in File se in
plugins/ci sono più file JAR dello stesso plugin. Rimuovi le copie che hai verificato essere di troppo a server fermo. - Scarica di nuovo dalla pagina ufficiale del progetto una versione completa e compatibile del plugin. Ferma il server e usala per sostituire in File il vecchio file in
plugins/, non la copia di lavoro inplugins/.paper-remapped. - Riavvia e controlla se il messaggio è sparito.
Buono a sapersi: se non esiste una versione compatibile, il plugin non è ancora pronto per la versione del tuo server. Rimuovilo o aspetta un aggiornamento.
File duplicati: File del plugin danneggiato, duplicato o non è affatto un plugin
«Unsupported key» / «Unable to lookup value for key»: nome di blocco o oggetto sconosciuto
Ecco come appare il messaggio:
Unsupported key: minecraft:bed
[<Erweiterung>] [STDERR] Unable to lookup value for key <minecraft:chain> in registries <RegistryKeyImpl[key=minecraft:block]>!
Cosa c'è dietro: Minecraft identifica ogni blocco e ogni oggetto con un nome fisso nel formato minecraft:<Name>, la cosiddetta chiave di registro. Un plugin, una mod o la loro configurazione usa un nome che la tua versione di Minecraft non conosce. Un esempio tipico è minecraft:bed: dalla 1.13 i letti prendono il nome dal loro colore, ad esempio red_bed. La voce viene saltata e il server continua a funzionare, ma la funzione interessata potrebbe mancare.
Come risolvere:
- Leggi il nome dell'estensione all'inizio della riga o nelle righe precedenti nella Console oppure in
logs/latest.log. - Fai un backup della configurazione e cerca in File la chiave indicata. Per i plugin la configurazione si trova di solito in
plugins/<Plugin>/; per le mod il percorso è indicato nella relativa documentazione. - Sostituisci il nome con quello valido per la tua versione di Minecraft, che trovi sul Minecraft Wiki. Nei file YAML (
.yml), un formato di configurazione strutturato, non modificare il rientro e le virgolette. - Riavvia. Se il nome è scritto direttamente nel codice del plugin o della mod, aggiorna l'estensione a una versione compatibile in Plugin o Mod. Ferma il server prima di sostituire i file.
In caso di errori nel file: Il file di configurazione di un plugin contiene errori
Il plugin richiede una libreria di testo (Adventure) più recente di quella del tuo server
Ecco come appare il messaggio:
Caused by: java.lang.ExceptionInInitializerError: Exception java.lang.TypeNotPresentException: Type net.kyori.adventure.text.TranslationArgument not present
Cosa c'è dietro: Adventure è la libreria con cui Paper crea i testi colorati della chat, i titoli e i testi al passaggio del mouse. È integrata nel server, quindi la sua versione dipende dalla tua versione di Minecraft. Il plugin è stato compilato per una versione più recente di Adventure e la classe indicata non è presente sul tuo server. Per questo alcune parti del plugin non si avviano. Il server continua a funzionare.
Come risolvere:
- Scopri quale plugin è interessato. Nello stacktrace, cioè l'elenco di righe
at …sotto il messaggio, compare spesso il nome del file JAR. In caso contrario, ti aiutano le righe precedenti. - Scarica una versione meno recente del plugin, compilata per la versione del tuo server, e sostituisci il file in File nella cartella
plugins/. - In alternativa, passa a una versione più recente di Minecraft in Versione. Prima crea un backup.
Buono a sapersi: aggiungere un altro file di Adventure nella cartella plugins/ non serve, perché Paper usa la versione integrata.
ProtocolLib non è compatibile con la versione del server
Ecco come appare il messaggio:
[ProtocolLib] INTERNAL ERROR: Cannot load ProtocolLib.
If this problem hasn't already been reported, please open a ticket
java.lang.IllegalArgumentException: Unable to find a field that matches …
Cosa c'è dietro: ProtocolLib è una libreria di supporto che permette ad altri plugin di leggere e modificare i pacchetti di rete. Per farlo interviene a fondo nei meccanismi interni del server, che cambiano quasi a ogni versione di Minecraft. Se ProtocolLib non trova i campi dei pacchetti che si aspetta, non si carica. Di conseguenza non funzionano nemmeno i plugin che ne hanno bisogno.
Come risolvere:
- Scarica la build più recente di ProtocolLib per la tua versione attuale di Minecraft. Per le versioni appena uscite, le build compatibili sono spesso disponibili prima come versioni preliminari sulla pagina del progetto.
- Sostituisci il vecchio file in File nella cartella
plugins/. Tieni un solo file di ProtocolLib. - Riavvia completamente il server, cioè fermalo e avvialo di nuovo, senza usare
/reload. - Digita
pluginsnella Console e controlla che ProtocolLib e i plugin che dipendono da esso siano verdi.
Buono a sapersi: la richiesta di aprire un ticket per ProtocolLib viene dal plugin stesso. Di solito manca soltanto la build giusta.
Plugin dipendenti: Un plugin ha bisogno di un altro plugin che manca
«is not compatible with Minecraft …»: Citizens si disattiva
Ecco come appare il messaggio:
[Citizens] v<Version> (build <Nummer>) is not compatible with Minecraft <Version> - try upgrading or downgrading Citizens. Disabling.
Cosa c'è dietro: Citizens è un plugin per gli NPC, cioè personaggi controllati dal computer come mercanti o assegnatori di missioni. Ogni build di Citizens supporta solo determinate versioni di Minecraft e build del server. Se non è compatibile con il tuo server, Citizens si disattiva all'avvio. I tuoi NPC non compaiono e i plugin basati su Citizens perdono questa funzione. Il server continua a funzionare.
Come risolvere:
- Controlla in Versione quale versione di Minecraft ha il tuo server.
- Scarica la build di Citizens per quella versione esatta. Molte build di Citizens hanno
SNAPSHOTnel nome: ciò che conta è la versione di Minecraft indicata nella pagina di download. - Ferma il server, sostituisci il vecchio file in File nella cartella
plugins/e riavvia. - Se non esiste una build compatibile, cambia la versione del server in Versione. Prima crea un backup.
Buono a sapersi: try upgrading or downgrading significa che Citizens può essere troppo vecchio o troppo recente. Il file più recente, quindi, non è automaticamente quello giusto.
«is not compatible with your version of Minecraft»: la versione del plugin non è compatibile
Ecco come appare il messaggio:
[Citizens] v<Version> (build <Nummer>) is not compatible with your version of Minecraft. Disabling...
[Citizens] Could not fetch NMS field <Feld>: …
Your MC version isn't supported
Cosa c'è dietro: il plugin è stato compilato per un'altra versione di Minecraft o per un altro software server. NMS indica le classi interne del server di Minecraft; «Could not fetch NMS field» segnala problemi di accesso ai loro campi. A seconda del plugin, questo si disattiva del tutto oppure smettono di funzionare singole funzioni, ad esempio i testi colorati della chat in caso di Unable to load Adventure, chat components will not work. Il server continua a funzionare.
Come risolvere:
- Leggi il nome del plugin tra le parentesi quadre a inizio riga. Se manca, lo trovi nelle righe precedenti.
- Controlla sulla pagina del plugin quali versioni di Minecraft e quali software server supporta.
- Scarica la release adatta, arresta il server e sostituisci il vecchio file in File, nella cartella
plugins/. - Se non esiste una release adatta, in Versione imposta il server sulla versione richiesta dal plugin. Prima crea un backup.
- Dopo il riavvio, digita
pluginsnella Console e verifica che il plugin sia verde. Poi prova la funzione interessata.
Buono a sapersi: il passaggio a una versione più recente di Minecraft converte il mondo. Puoi tornare indietro in modo affidabile solo con il backup.
Il plugin richiede una build di Paper più recente per la tua versione di Minecraft
Ecco come appare il messaggio:
[EntrypointUtil] Class io.papermc.paper.plugin.loader.library.impl.MavenLibraryResolver does not have member field 'java.lang.String MAVEN_CENTRAL_DEFAULT_MIRROR'
java.lang.NoSuchFieldError: …
Cosa c'è dietro: Paper viene sviluppato di continuo anche all'interno di una stessa versione di Minecraft e ogni release si chiama build. Il plugin accede a un campo della Paper API, nella parte che all'avvio scarica le librerie aggiuntive per i plugin. Questo campo (MAVEN_CENTRAL_DEFAULT_MIRROR) esiste solo nelle build più recenti. Nella tua build manca, perciò il plugin non si carica. Il server invece continua a funzionare.
Come risolvere:
- Apri Versione nel pannello e aggiorna alla build di Paper più recente per la tua versione di Minecraft.
- Riavvia e controlla nella Console se ora il plugin si carica senza errori.
- Se non vuoi cambiare build, usa una release precedente del plugin e sostituisci il file in File, nella cartella
plugins/.
Buono a sapersi: passare a una build più recente della stessa versione di Minecraft è un piccolo passo. Il mondo resta sulla stessa versione di Minecraft. Un backup preventivo, comunque, non guasta.
«Failed to init reflection»: il plugin non riesce ad accedere ai componenti interni del server
Ecco come appare il messaggio:
Failed to init reflection: Index 3 out of bounds for length 3
java.lang.RuntimeException: Failed to obtain CraftItemStack.asCraftMirror
java.lang.RuntimeException: Couldn't initialize NMS adapter
Cosa c'è dietro: alcuni plugin leggono direttamente le classi interne del server tramite il loro nome: questa tecnica si chiama reflection. Questi componenti interni cambiano da una versione di Minecraft all'altra, quindi una release del plugin compilata per un'altra versione del server non trova i metodi o i campi che si aspetta. Anche una libreria come ProtocolLib può fallire durante l'accesso; NMS indica le classi interne del server di Minecraft. Le funzioni che ne dipendono smettono di funzionare o il plugin non si avvia, mentre il server continua a girare.
Come risolvere:
- Leggi il nome del plugin all'inizio del messaggio o nelle righe precedenti. Nella Console o in
logs/latest.logcontrolla anche le righeat …, che mostrano la catena delle chiamate. - Verifica quale versione del server supportano il plugin e le dipendenze citate, come ProtocolLib. Aggiornali a release compatibili tra loro e con la tua versione del server.
- Crea un backup dello stato attuale, arresta il server e sostituisci i file interessati in File, nella cartella
plugins/. - Riavvia e prova la funzione interessata. Verifica che il messaggio sia scomparso.
Buono a sapersi: se non esiste una release adatta, usa un'alternativa compatibile oppure lascia temporaneamente disattivato il plugin interessato.
Gli effetti luminosi di un plugin sono disattivati (GlowingEntities)
Ecco come appare il messaggio:
[GlowingEntities] [GlowingEntities] Glowing Entities reflection failed to initialize. The util is disabled. Please ensure your version (<Version>) is supported.
java.lang.NoSuchFieldException: MARKER
Cosa c'è dietro: GlowingEntities non è un plugin a sé, ma un componente incluso in altri plugin per far brillare giocatori, mob o oggetti. Il componente non trova un campo interno della build del tuo server, perciò gli effetti luminosi del plugin in questione sono disattivati. Il server continua a funzionare e di solito anche il plugin continua a lavorare senza gli effetti.
Come risolvere:
- Individua il plugin che include GlowingEntities. Nelle righe
at …sotto il messaggio trovi una voce nel formato<Plugin>.jar//…. - Scarica la release di questo plugin adatta alla tua build di Paper.
- Sostituisci il vecchio file in File, nella cartella
plugins/, e riavvia.
Buono a sapersi: non puoi aggiornare GlowingEntities separatamente. Se ne occupa lo sviluppatore del plugin che contiene il componente. Se non ti servono gli effetti luminosi, puoi ignorare il messaggio fino al prossimo aggiornamento.
«Failed to apply GUI head texture»: mancano le teste nel menu di Simple_RTP
Ecco come appare il messaggio:
[Simple_RTP] Failed to apply GUI head texture: IllegalArgumentException: Can not set net.minecraft.world.item.component.ResolvableProfile field org.bukkit.craftbukkit.inventory.CraftMetaSkull.profile to com.mojang.authlib.GameProfile
Cosa c'è dietro: Simple_RTP è un plugin per i teletrasporti casuali. Per le teste del suo menu imposta un profilo giocatore nel vecchio formato (GameProfile), ma in quel punto la tua versione di Minecraft si aspetta un formato più recente (ResolvableProfile). I due formati non sono compatibili, perciò le teste nel menu non funzionano. Il server continua a girare.
Come risolvere:
- Controlla in Versione quale versione di Minecraft usa il tuo server.
- Scarica la release di Simple_RTP per questa versione di Minecraft.
- Arresta il server, sostituisci il vecchio file in File, nella cartella
plugins/, e riavvialo. - Apri il menu nel gioco e verifica che ora le teste compaiano.
Buono a sapersi: il messaggio può ripetersi ogni volta che apri il menu. Non provoca altri danni: indica soltanto che la release del plugin è obsoleta.
ZNPCs: gli NPC salvati non corrispondono alla versione del plugin
Ecco come appare il messaggio:
io.github.gonalez.znpcs.commands.CommandExecuteException
No enum constant io.github.gonalez.znpcs.npc.<…>.PLAYER
Cosa c'è dietro: ZNPCs salva i tuoi NPC in un file, insieme al loro tipo e alle loro azioni. Il file contiene un tipo o un'azione che la versione di ZNPCs installata non conosce, ad esempio ActionType.PLAYER. Di solito succede quando gli NPC sono stati creati con un'altra versione di ZNPCs. Il comando eseguito si interrompe, ma il server continua a funzionare.
Come risolvere:
- Crea un backup in Backup.
- Installa la versione di ZNPCs con cui sono stati creati gli NPC e riavvia.
- Se non è possibile, arresta il server, apri il file
plugins/ZNPCs/data.jsonin File e rimuovi la voce dell'NPC interessato. JSON è un formato di testo con parentesi e virgole: una sola virgola mancante rende illeggibile l'intero file. - Avvia il server e prova di nuovo il comando.
Buono a sapersi: modifica il file solo a server arrestato. Se è in funzione, ZNPCs può sovrascrivere le tue modifiche alla chiusura.
«failed to register events»: al plugin manca una classe necessaria
Ecco come appare il messaggio:
Plugin <Plugin> v<Version> has failed to register events for class <Klasse> because io/papermc/paper/event/<Ereignis> does not exist.
Plugin <Plugin> v<Version> has failed to register events for class <Klasse> because <Abhängigkeit>/<Klasse> does not exist.
Cosa c'è dietro: i plugin reagiscono agli eventi di gioco, ad esempio quando un giocatore rompe un blocco. Durante la configurazione di queste reazioni manca una classe necessaria, cioè un componente del programma. Spesso il plugin richiede Paper invece di Spigot oppure un'altra versione di Minecraft, ma la classe mancante può anche provenire da un altro plugin o da una libreria. Le funzioni del plugin interessate smettono di funzionare, mentre il server resta attivo.
Come risolvere:
- Leggi il nome dopo
becausee controlla i requisiti del plugin interessato: software del server, versione di Minecraft e altri plugin necessari. - Se il nome inizia con
io/papermc/paperocom/destroystokyo/papere il tuo server usa Spigot, fai un backup e passa a una versione di Paper supportata in Cambia software / loader. - Se usa già Paper, installa una versione del plugin compatibile. Se il nome rimanda a un'altra dipendenza, installala o aggiornala seguendo le istruzioni del plugin.
- Riavvia e controlla che il messaggio sia sparito.
Per saperne di più: Cambiare il software e la versione del server nel pannello
Il file è compilato per una versione più recente di Java (Unsupported class file major version)
Ecco come appare il messaggio:
java.lang.IllegalArgumentException: Unsupported class file major version 69
Cosa c'è dietro: plugin, mod e librerie vengono compilati per una determinata versione di Java. Il numero dopo major version indica quale: sottraendo 44 ottieni la versione di Java, quindi 65 corrisponde a Java 21 e 69 a Java 25. Gli strumenti del tuo server che leggono o riscrivono plugin e mod durante il caricamento non riconoscono questa versione più recente. Il componente interessato non viene caricato.
Come risolvere:
- Controlla nelle righe precedenti quale plugin o mod era in fase di caricamento.
- Scaricane una versione compilata per la tua versione di Minecraft e sostituisci il vecchio file in File, nella cartella
plugins/omods/. - In alternativa, aggiorna il server in Versione a una versione più recente di Minecraft che funzioni con Java 21 o superiore. Da noi la versione di Java adatta viene impostata automaticamente. Prima fai un backup.
Buono a sapersi: se subito prima compare Fatal error trying to convert, vale la sezione più in alto dedicata ai server Paper meno recenti.
Guida completa: Quale versione di Java serve al tuo server Minecraft?
Un vecchio plugin cerca una funzione dei chunk rimossa (ID legacy)
Ecco come appare il messaggio:
java.lang.NoSuchMethodException: net.minecraft.world.level.chunk.Chunk.k(net.minecraft.core.BlockPosition)
Cosa c'è dietro: fino a Minecraft 1.12 i blocchi avevano ID numerici: la pietra, ad esempio, era l'1. Alcuni vecchi plugin usano ancora internamente questi ID legacy e per farlo accedono direttamente alle funzioni interne del gioco, cioè alle classi sotto net.minecraft. La funzione dei chunk cercata non esiste più nella tua versione, quindi la funzione ID legacy del plugin non si avvia. A seconda del plugin, possono smettere di funzionare singole funzioni o molte di esse.
Come risolvere:
- Guarda lo stacktrace sotto il messaggio, cioè le righe
at …. Lì trovi il nome del plugin o del suo file JAR. - Aggiorna il plugin a una versione adatta alla tua versione di Minecraft e sostituisci il file in File, nella cartella
plugins/. - Se non esiste, il plugin non viene più mantenuto per le versioni moderne. Cerca un plugin sostitutivo aggiornato.
Buono a sapersi: il nome breve k è un nome interno offuscato. Nomi di questo tipo cambiano a ogni versione di Minecraft, perciò i plugin che li usano direttamente smettono di funzionare quasi a ogni aggiornamento.
«GameProfile.getProperties()»: il plugin usa una funzione obsoleta dei profili Mojang
Ecco come appare il messaggio:
[<Plugin>] Failed to apply GUI head texture: NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()
java.lang.NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()
Cosa c'è dietro: authlib è la libreria di Mojang con cui il server gestisce i profili dei giocatori, con nome e skin. Il plugin legge questi profili tramite un metodo (GameProfile.getProperties) che non esiste più nella tua versione di Minecraft. La funzione interessata smette di funzionare: di solito si tratta delle teste dei giocatori nei menu. Il server resta attivo.
Come risolvere:
- Individua il plugin: spesso il suo nome compare tra parentesi quadre all'inizio del messaggio. In caso contrario, il nome del plugin o del suo file JAR si trova nelle righe
at …sottostanti o nelle righe precedenti. - Scarica una versione del plugin adatta alla tua versione di Minecraft.
- Sostituisci il vecchio file in File, nella cartella
plugins/, e riavvia. - Apri il menu interessato nel gioco e controlla che le teste siano tornate visibili.
Buono a sapersi: questa modifica riguarda molti plugin per menu e teste contemporaneamente. Se più plugin non mostrano più le teste, di solito la causa è la stessa e ognuno ha bisogno del proprio aggiornamento.
«No enum constant» / «NoSuchFieldException»: il plugin non è compatibile con la versione
Ecco come appare il messaggio:
java.lang.IllegalArgumentException: No enum constant org.bukkit.Material.<Name>
java.lang.NoSuchFieldException: maxStack
java.lang.NoSuchFieldError: Class org.bukkit.<Klasse> does not have member field '<Feld>'
Cosa c'è dietro: il plugin è compilato per un'altra versione di Minecraft e accede a elementi di gioco che qui mancano o hanno un nome diverso, come blocchi, particelle o attributi. NoSuchFieldException riguarda anche i campi interni per le dimensioni delle pile, a cui un plugin accede tramite reflection, cioè usando il loro nome. A seconda del plugin, l'errore compare a ogni azione oppure smettono di funzionare singole funzioni. Possono comparire anche Unknown material e Could not initialize Brigadier mappings; Brigadier è il sistema di comandi di Minecraft con il completamento tramite Tab.
Come risolvere:
- Leggi il nome del plugin nelle righe precedenti o nelle righe
at …sottostanti. - Scarica una versione del plugin adatta alla tua versione di Minecraft, fai un backup dello stato attuale e arresta il server. Sostituisci il file in File, nella cartella
plugins/, e riavvia. - In alternativa, seleziona in Versione la versione di Minecraft supportata dal plugin. Prima fai un backup del server; per passare a una versione precedente ti serve un salvataggio del mondo compatibile.
- Se il nome del materiale sconosciuto si trova in un file di configurazione del plugin, sostituiscilo con una denominazione supportata dalla tua versione di Minecraft. I campi interni mancanti si risolvono installando una versione compatibile del plugin.
Il plugin Marriage non è compatibile con la versione di Minecraft
Ecco come appare il messaggio:
[Marriage] Marriage is not compatible with the version of minecraft you are using
Marriage kissing will be disabled!
Cosa c'è dietro: Marriage permette ai giocatori di sposarsi nel gioco e aggiunge funzioni come il bacio. Il plugin non supporta la tua versione di Minecraft, perciò disattiva almeno la funzione del bacio; anche altre parti potrebbero essere interessate. Il server continua a funzionare normalmente.
Come risolvere:
- Controlla sulla pagina del plugin se esiste una versione di Marriage per la tua versione di Minecraft. Puoi vedere la tua versione in Versione.
- Se esiste, sostituisci il vecchio file in File, nella cartella
plugins/, e riavvia. - Se non esiste, sostituisci il plugin con uno aggiornato dalle funzioni simili. Tieni presente che un altro plugin potrebbe non importare i dati salvati da Marriage, quindi fai prima un backup.
Buono a sapersi: se ti dà fastidio solo la mancanza della funzione del bacio e tutto il resto funziona, puoi ignorare il messaggio finché non esce un aggiornamento.
Un plugin anticheat o di gestione dei pacchetti non supporta ancora del tutto la tua versione di Minecraft
Ecco come appare il messaggio:
java.lang.IllegalStateException: Unknown entity metadata type id: <Zahl> version V_<Version>
Cosa c'è dietro: Alcuni plugin leggono i pacchetti di rete scambiati tra il gioco e il server, ad esempio l'anticheat GrimAC tramite la libreria PacketEvents. Con le nuove versioni di Minecraft arrivano nuovi tipi di dati per creature e oggetti, i cosiddetti metadati delle entità. Il plugin non ne conosce ancora uno, di solito perché è più vecchio della versione del tuo server. I pacchetti interessati vengono elaborati in modo errato. Questo può causare falsi allarmi dell'anticheat o problemi di connessione.
Come risolvere:
- Aggiorna il plugin e, se è installato come file separato, anche PacketEvents a una versione che supporti espressamente la tua versione di Minecraft.
- Riavvia completamente il server.
- Se non esiste ancora una versione adatta, disattiva temporaneamente il plugin: rinomina il suo file in File, ad esempio in
<Plugin>.jar.off. Il server carica solo i file con estensione.jar. - In alternativa, seleziona in Versione una versione di Minecraft supportata dal plugin. Prima crea un backup.
Un plugin aggiuntivo per WorldEdit usa un'interfaccia rimossa
Ecco come appare il messaggio:
[WorldEdit] Got request to set EditSessionFactory <…> EditSessionFactories have been removed …
Cosa c'è dietro: WorldEdit ha rimosso una vecchia interfaccia, la EditSessionFactory, che permetteva ai plugin aggiuntivi di agganciarsi a ogni modifica fatta con WorldEdit. Un plugin aggiuntivo, ad esempio per il log dei blocchi o la protezione delle aree, cerca ancora di usarla. WorldEdit di per sé funziona normalmente, ma la funzione di log o di protezione del plugin aggiuntivo non si applica alle modifiche di WorldEdit: ciò che costruisci o cancelli con WorldEdit non viene né registrato né bloccato da quel plugin.
Come risolvere:
- Scopri quale plugin invia la richiesta. Di solito il nome compare nel messaggio stesso o nelle righe precedenti.
- Aggiorna questo plugin aggiuntivo a una versione compatibile con il tuo WorldEdit o FastAsyncWorldEdit (FAWE, una variante più veloce di WorldEdit).
- Se non esiste, disattiva l'integrazione con WorldEdit nella configurazione del plugin aggiuntivo, se è prevista un'impostazione apposita.
- Riavvia e controlla che il messaggio sia sparito.
Buono a sapersi: Finché il problema non è risolto, non puoi contare sul fatto che le modifiche di WorldEdit vengano registrate o che si possano annullare tramite quel plugin.
Braslety: la ricetta non viene registrata
Ecco come appare il messaggio:
[Braslety] … java.lang.IllegalAccessException: class com.example.braslety.BraceletsPlugin cannot access …
Cosa c'è dietro: Braslety accede alle classi interne di CraftBukkit tramite Reflection. Reflection significa che il plugin legge direttamente parti del server invece di usare l'interfaccia ufficiale. Nella versione del tuo server queste parti non sono accessibili e Java nega l'accesso. Per questo la ricetta interessata non viene registrata e l'item corrispondente non si può creare. Il server continua a funzionare.
Come risolvere:
- Controlla se esiste una versione di Braslety per la tua build attuale di Paper. Puoi vedere quella in uso in Versione.
- Se esiste, sostituisci il vecchio file in File nella cartella
plugins/e riavvia. - Se non esiste, sostituisci il plugin con uno mantenuto attivamente e con funzioni simili.
- Controlla nel gioco che la ricetta funzioni.
Buono a sapersi: Il nome del pacchetto com.example fa pensare a un plugin autoprodotto o poco diffuso. In questo caso solo il suo autore può fornire un aggiornamento.
ViaVersion non riesce a caricare un modulo di traduzione
Ecco come appare il messaggio:
[ViaVersion] Error during loading of Protocol<Version>To<Version>
Cosa c'è dietro: ViaVersion fa da traduttore tra le versioni del gioco, così possono entrare anche i giocatori con client più recenti o più vecchi. Estensioni come ViaBackwards aggiungono questa funzione per i client più vecchi. Ogni traduzione si trova in un modulo a sé, il cui nome inizia con Protocol. Uno di questi non è stato caricato, di solito perché ViaVersion e le sue estensioni non sono compatibili tra loro o con la versione del server. I giocatori con le versioni del client interessate non possono quindi entrare. Chi gioca esattamente con la versione del server non ha problemi.
Come risolvere:
- Scarica le versioni più recenti di ViaVersion e di tutte le estensioni Via che usi.
- Sostituiscile tutte insieme in File nella cartella
plugins/. Non mescolare file Via vecchi e nuovi. - Riavvia completamente il server.
- Prova a entrare con la versione del client che prima non funzionava.
Guida completa: Configurare ViaVersion: connettere client più vecchi e più recenti
LibreLogin non funziona su Spigot
Ecco come appare il messaggio:
[LibreLogin] Detected an unsupported server distribution. Please use Paper or its forks. SPIGOT IS NOT SUPPORTED!
Cosa c'è dietro: LibreLogin è un plugin di login: i giocatori accedono con una password. Questo è importante soprattutto sui server in modalità offline. LibreLogin richiede Paper o un fork compatibile, cioè una variante di Paper come Purpur, e su Spigot si disattiva. Se il tuo server è in modalità offline, viene quindi a mancare la protezione con password: i giocatori possono connettersi usando il nome di qualcun altro.
Come risolvere:
- Crea un backup in Backup.
- Passa a Paper o Purpur in Cambia software / loader. I plugin per Spigot di norma continuano a funzionare anche lì.
- Riavvia e controlla nella Console che LibreLogin si carichi senza questo messaggio.
- Se vuoi restare su Spigot, usa un plugin di login che supporti espressamente Spigot.
Buono a sapersi: Se il tuo server è in modalità offline, risolvi il problema prima che entrino i giocatori.
Per saperne di più: Cambiare il software e la versione del server nel pannello
A Nova manca un parametro di avvio Java (-javaagent)
Ecco come appare il messaggio:
[Nova] Missing required JVM argument: -javaagent:plugins/Nova-<Version>.jar
Cosa c'è dietro: Nova è un plugin molto ricco che permette di avere blocchi e item personalizzati sui server Paper. Per una parte delle sue funzioni, Java deve caricare all'avvio un cosiddetto Java agent. Si tratta di un componente aggiuntivo che si attiva già prima del server vero e proprio e viene incluso tramite un parametro di avvio. Il tuo server si avvia senza questo parametro. Per questo Nova non funziona del tutto, mentre il server continua a funzionare.
Come risolvere:
- Leggi nel messaggio il parametro esatto, compreso il nome del file JAR di Nova.
- Non puoi modificare da solo il comando di avvio del tuo server Minecraft nel pannello. Apri quindi un ticket, incolla il parametro copiato dal messaggio e indica l'ora in cui è comparso.
- Se Nova non ti serve davvero, rimuovi il plugin in Plugin e riavvia il server. Il messaggio scomparirà.
Buono a sapersi: A ogni nuova versione di Nova di solito cambia anche il nome del file nel parametro. Per questo, dopo un aggiornamento di Nova, il messaggio ricompare spesso.
AngelChest: integrazione con WorldGuard disattivata per un conflitto di versioni
Ecco come appare il messaggio:
[AngelChest] WorldGuard integration is disabled.
Cosa c'è dietro: AngelChest rileva che WorldGuard non supporta completamente la tua versione di Minecraft. Per questo disattiva il collegamento a questo plugin. Le funzioni di AngelChest che ne dipendono non sono disponibili, mentre il server continua a funzionare. Controlla il comportamento nelle aree protette prima di fare di nuovo affidamento sull'integrazione tra i due plugin.
Come risolvere:
- Annota la versione di Minecraft indicata in Versione e controlla nella Console le versioni dei plugin caricati.
- Crea un backup delle tue impostazioni in Backup.
- In Plugin, installa versioni di WorldGuard e AngelChest che supportano la tua versione di Minecraft.
- Riavvia completamente il server. Verifica che il messaggio sia scomparso e prova AngelChest nelle aree interessate.
EssentialsSpawn: il teletrasporto dei nuovi giocatori fallisce per un metodo mancante
Ecco come appare il messaggio:
[EssentialsSpawn] <Spieler> Failed to teleport new player!
java.util.concurrent.CompletionException: java.lang.AbstractMethodError: Receiver class com.earth2me.essentials.OfflinePlayerStub <Details>
Cosa c'è dietro: EssentialsSpawn richiama l'interfaccia di teletrasporto di Paper per un nuovo giocatore. L'errore AbstractMethodError significa che la classe di Essentials utilizzata non fornisce il metodo previsto. In questo punto i componenti installati non sono compatibili tra loro: il teletrasporto automatico non funziona, mentre il server continua a girare.
Come risolvere:
- Fai un backup della configurazione del plugin e controlla nella Console il messaggio di errore completo e le versioni dei plugin caricati.
- In Plugin, aggiorna insieme EssentialsX ed EssentialsSpawn a una versione adatta alla tua versione di Paper. Per i file caricati manualmente usa File.
- Rimuovi in File i vecchi file duplicati di questi plugin e riavvia completamente il server.
- Prova il teletrasporto di un giocatore che entra per la prima volta. Se l'errore persiste, segnalalo al progetto EssentialsX allegando lo stack trace ripulito dai dati sensibili e tutte le versioni coinvolte.
Il plugin viene rifiutato da Folia per mancanza di supporto
Ecco come appare il messaggio:
Could not load plugin '<Plugin> <Version>' as it is not marked as supporting Folia!
Cosa c'è dietro: Folia elabora le regioni del mondo in parallelo e per questo richiede plugin adattati. Il plugin interessato non dichiara questo supporto e viene rifiutato durante il caricamento. Le sue funzioni non sono disponibili, mentre gli altri plugin idonei possono continuare a essere caricati.
Come risolvere:
- Leggi nella Console quale file del plugin è interessato e controlla le indicazioni dell'autore su Folia.
- Installa in Plugin o File una versione con supporto esplicito e riavvia completamente il server.
- Se non esiste una versione per Folia, scegli un'alternativa. Per passare a un altro software server, crea prima un backup in Backup e controlla i requisiti di tutti i plugin.
Buono a sapersi: aggiungere manualmente la dichiarazione di supporto non rende il plugin compatibile con Folia.
Il tuo messaggio non è nell'elenco?
Leggi il messaggio completo nella Console o in logs/latest.log, comprese le righe precedenti. Puoi riconoscere il plugin interessato dal nome tra parentesi quadre all'inizio della riga o nello stack trace, l'elenco delle righe at …: lì trovi i nomi dei JAR presenti in plugins/ o mods/ e i nomi dei package, che spesso contengono il nome del plugin. Confronta poi le versioni supportate indicate nella pagina del plugin con quella del tuo server. Crea un backup prima di ogni cambio di versione. Se non riesci a risolvere, apri un ticket e indica l'orario del messaggio.