Su Paper e Spigot, un plugin è un singolo file JAR (un archivio Java) nella cartella plugins. Se questo file è danneggiato, vuoto, duplicato o in realtà è una mod o una libreria, il server non carica il plugin oppure si blocca all'avvio. Ogni sezione qui sotto tratta uno di questi messaggi. Con “Scopri di più” in Stato del server arrivi direttamente a quella giusta.

Il testo completo si trova nella Console oppure in File, in logs/latest.log. Di solito le righe importanti sono quelle subito sotto il messaggio, perché lì è indicato il vero motivo. Sostituisci i file dei plugin solo a server fermo. Prima crea un backup in Backup, soprattutto se potrebbero essere coinvolti anche i file del mondo o di configurazione.

“Error occurred while enabling …”: il plugin non si avvia

Ecco come appare il messaggio:

Error occurred while enabling <Plugin> v<Version> (Is it up to date?)
java.net.SocketTimeoutException: Read timed out
Error occurred while disabling DeluxeMenus v<Version>

Cosa c'è dietro: il plugin si è bloccato durante l'attivazione ed è stato disattivato. Il server continua a funzionare, ma le funzioni del plugin non sono disponibili; con i plugin di protezione, permessi o login viene meno anche la relativa protezione. Di solito le versioni del server e del plugin non sono compatibili. Anche la mancata risposta di un servizio esterno può impedire l'avvio.

Come risolvere:

  1. Controlla sulla pagina del plugin quale release supporta la tua versione del server e aggiornalo a server fermo.
  2. In caso di NoSuchMethodError (manca un metodo) o NoClassDefFoundError (manca un componente del programma), controlla le dipendenze e le versioni indicate. Un riferimento a Bukkit può riguardare l'interfaccia del server.
  3. In caso di SocketTimeoutException: Read timed out, il tempo di attesa dei dati di rete è scaduto. Controlla il servizio utilizzato e il suo indirizzo nella configurazione del plugin prima di riavviare.
  4. In caso di Communications link failure, controlla le credenziali del database nella configurazione del plugin e in Database.
  5. In caso di zip file closed, esegui un riavvio completo. Se l'errore persiste, sostituisci il file del plugin a server fermo con un download compatibile.
  6. Dopo il riavvio, controlla nella Console se il plugin viene attivato.

Buono a sapersi: “Error occurred while disabling” riguarda la disattivazione. Se prima compare un errore di attivazione, controlla innanzitutto quello. Per saperne di più: Il plugin non è compatibile con la versione del server.

Il file del plugin viene saltato (“Could not load 'plugins/…jar'”)

Ecco come appare il messaggio:

[ModernPluginLoadingStrategy] Could not load 'plugins/<Plugin>.jar' in 'plugins'
org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [ProtocolLib]. Please download and install these plugins to run '<Plugin>'.

Cosa c'è dietro: il server non è riuscito a caricare come plugin il JAR indicato e lo salta. Un JAR (archivio Java) è il file che contiene un plugin. Il resto del server può continuare a funzionare, ma questo plugin manca del tutto. La causa è un file danneggiato o non valido, oppure un JAR senza un plugin.yml leggibile, il file descrittivo da cui il server riconosce un plugin. Con “Failed to run bootstrapper”, un plugin Paper ha fallito già nella primissima fase di avvio.

Come risolvere:

  1. Leggi la riga sotto il messaggio. Se contiene UnknownDependencyException, manca un altro plugin: installa quello indicato tra parentesi quadre.
  2. Altrimenti ferma il server ed elimina il JAR interessato in File, nella cartella plugins.
  3. Scarica da una fonte affidabile una release compatibile con il tuo tipo di server (Paper, Spigot) e con la tua versione di Minecraft, quindi caricala.
  4. Riavvia il server.

Buono a sapersi: se il percorso punta a plugins/.paper-remapped, si tratta di una copia che Paper crea per i plugin Spigot. Sostituisci il JAR originale in plugins: Paper ricreerà la copia al prossimo avvio. Per i plugin mancanti: Il plugin ha bisogno di un altro plugin.

“Error initializing plugin …”: il plugin fallisce all'avvio

Ecco come appare il messaggio:

[<Plugin>] Error initializing plugin '<Plugin>-<Version>.jar' in folder '<Ordner>' (Is it up to date?)
java.lang.ExceptionInInitializerError
java.lang.IllegalStateException: English locale not found in Geyser.

Cosa c'è dietro: il plugin si è bloccato mentre il server lo stava preparando, quindi ancora prima di essere attivato. Resta disattivato, i suoi comandi e le sue funzioni non sono disponibili e il server continua a funzionare senza di esso. Di solito la versione del plugin non è compatibile con quella del server. La riga di errore sottostante indica spesso la versione o una classe mancante, cioè una parte di programma che il plugin si aspetta di trovare nel server.

Come risolvere:

  1. Leggi prima le righe successive in logs/latest.log, in File, in particolare Caused by. Indicano la vera causa.
  2. Installa la versione del plugin adatta alla tua versione del server oppure aggiorna il plugin. La pagina del plugin indica le versioni supportate.
  3. Se per la tua versione del server non esiste ancora una release compatibile, aspetta un aggiornamento del plugin oppure resta per il momento su una versione supportata in Versione.
  4. Se non basta, rimuovi il plugin per fare una prova e segnala l'errore al suo autore, allegando il messaggio completo.
  5. Riavvia il server.

Buono a sapersi: se Geyser segnala “English locale not found”, il file è incompleto. Scarica di nuovo Geyser dalla pagina ufficiale del progetto. Per saperne di più: Il plugin non è compatibile con la versione del server.

Paper non carica un plugin (“Could not load plugin … in folder”)

Ecco come appare il messaggio:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>-<Version>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.ExceptionInInitializerError

Cosa c'è dietro: Paper non è riuscito a caricare il plugin indicato all'avvio. Il plugin manca del tutto, mentre il resto del server si avvia. Il motivo è indicato nella riga immediatamente sottostante: di solito un plugin.yml danneggiato, una dipendenza mancante o una build per un'altra versione del server. Un messaggio relativo a “API version string”, ad esempio, significa che l'indicazione della versione nel plugin.yml ha un formato che la tua versione del server non comprende.

Come risolvere:

  1. Leggi la riga immediatamente sotto il messaggio.
  2. Scarica di nuovo il plugin nella release adatta alla tua versione del server.
  3. Ferma il server, rimuovi il vecchio JAR da plugins in File e carica quello nuovo.
  4. Riavvia il server e controlla nella Console se ora il plugin viene caricato.

Buono a sapersi: se la riga sottostante indica un plugin mancante, il problema non dipende dal file in sé. In questo caso ti aiuta la guida Il plugin ha bisogno di un altro plugin.

“Ambiguous plugin name …”: il plugin è installato due volte

Ecco come appare il messaggio:

[ModernPluginLoadingStrategy] Ambiguous plugin name 'ViaVersion' for files 'plugins/ViaVersion.jar' and 'plugins/ViaVersion-<Version>.jar' in 'plugins'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'LPC' for files 'plugins/.paper-remapped/LPC-<Version>.jar' and 'plugins/.paper-remapped/LPC-<AndereVersion>.jar' in 'plugins/.paper-remapped'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'Slimefun' for files 'plugins/.paper-remapped/<Datei>.jar' and 'plugins/.paper-remapped/<AndereDatei>.jar' in 'plugins/.paper-remapped'

Cosa c'è dietro: due file JAR dichiarano lo stesso nome interno del plugin, anche se i nomi dei file sono diversi. Il caso tipico è la presenza di una versione vecchia e di una nuova, oppure di due varianti dello stesso plugin. Il server ne carica solo una e potrebbe quindi funzionare con la versione sbagliata.

Come risolvere:

  1. Arresta il server e apri la cartella plugins in File.
  2. Individua i JAR originali corrispondenti ai due file indicati. plugins/.paper-remapped contiene copie adattate da Paper; rimuovi il JAR originale indesiderato in plugins, non solo la sua copia.
  3. Tieni una sola versione, quella adatta alla versione del tuo server. Non eliminare le cartelle dei dati dei plugin.
  4. Riavvia. Controlla nella Console se il messaggio compare ancora; il comando plugins mostra i plugin caricati.

Buono a sapersi: aggiorna i plugin a server arrestato e rimuovi il vecchio JAR prima di caricare quello nuovo.

“does not contain a paper-plugin.yml or plugin.yml”: il file non è un plugin

Ecco come appare il messaggio:

Directory 'plugins/<Mod>-fabric-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!
Directory 'plugins/<Mod>-neoforge-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!

Qual è la causa: nella cartella plugins c'è un JAR senza plugin.yml e senza paper-plugin.yml, quindi privo di uno dei file che descrivono i plugin. Di solito si tratta di una mod per Fabric, Forge o NeoForge; a volte è una libreria Java, come un driver per database. Paper e le sue varianti non possono caricare questo file come plugin e lo saltano. Il server continua a funzionare, ma la funzione che ti aspettavi non è disponibile.

Come risolvere:

  1. Arresta il server e rimuovi il file indicato da plugins/ in File.
  2. Cerca sulla pagina del progetto una versione per Paper o Spigot compatibile con la tua versione di Minecraft.
  3. Se esiste solo una mod, verifica prima se va davvero installata sul server. Alcune mod funzionano esclusivamente nel client di gioco.
  4. Se vuoi passare a un server con mod, crea prima un backup in Backup. In Cambia software / loader scegli esattamente il loader richiesto dalla mod. I tuoi plugin Paper non funzioneranno più su quel server.
  5. Riavvia e controlla la Console.

Il cambio di software è descritto nella guida Cambiare il software e la versione del server nel pannello.

“zip file closed”: file del plugin sostituito a server avviato

Ecco come appare il messaggio:

java.lang.IllegalStateException: zip file closed
java.lang.IllegalStateException: The plugin classloader for <Plugin> has thrown a zip file error.
io.netty.handler.codec.EncoderException: java.lang.BootstrapMethodError: java.lang.IllegalStateException: zip file closed

Qual è la causa: un JAR, cioè il file eseguibile di un plugin, è stato sovrascritto o eliminato mentre il server era in funzione, oppure qualcuno ha usato /reload. Il plugin prova poi a caricare parti del programma dal suo file ormai chiuso e genera errori. Alcune funzioni del plugin possono smettere di funzionare fino al riavvio del server. Il messaggio può comparire anche durante l'arresto.

Come risolvere:

  1. Riavvia completamente il server. Se il JAR del plugin interessato manca, ripristinalo prima in File, a server arrestato.
  2. In futuro sostituisci i file dei plugin solo a server arrestato: arresta il server, sostituisci il JAR in File e avvialo.
  3. Evita /reload. Il comando ricarica i plugin a server avviato e molti plugin non lo gestiscono correttamente.
  4. Se il messaggio compare senza che tu abbia sostituito alcun file, leggi le righe precedenti nella Console. Ti aiuteranno a individuare il plugin interessato.

Buono a sapersi: le modifiche che il plugin non ha ancora salvato al momento dell'errore possono andare perse.

“duplicate plugin identifier”: due file di plugin usano lo stesso nome

Ecco come appare il messaggio:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
java.lang.IllegalStateException: … attempted to add duplicate plugin identifier <Plugin> …

Qual è la causa: due file JAR forniscono lo stesso nome di plugin; Paper ne carica solo uno e rifiuta l'altro. Di solito la vecchia e la nuova versione di un plugin si trovano entrambe nella cartella plugins. Oppure due plugin rivendicano lo stesso nome: FastAsyncWorldEdit (abbreviato FAWE) include già WorldEdit, quindi un JAR di WorldEdit aggiuntivo entra in conflitto con esso. Il server continua a funzionare, ma Paper avvisa espressamente del rischio di errori successivi.

Come risolvere:

  1. Arresta il server.
  2. In File, nella cartella plugins, elimina il JAR più vecchio o superfluo. Con FAWE si tratta del JAR separato worldedit-bukkit.
  3. Se il messaggio cita plugins/.paper-remapped, controlla prima se tra i file JAR originali nella cartella plugins ci sono versioni doppie.
  4. Avvia il server e controlla nella Console che l'avviso sia scomparso e che il plugin desiderato venga caricato.

Buono a sapersi: i soliti comandi di WorldEdit continuano a funzionare con FAWE. Per scoprire come costruire e annullare gli errori, leggi WorldEdit: selezionare aree, costruire e annullare le modifiche.

ProtocolLib segnala la presenza di un plugin reloader

Ecco come appare il messaggio:

*** ProtocolLib does not support plugin reloaders! ***
*** Please use the built-in reload command!        ***

Qual è la causa: ProtocolLib interviene in profondità nella connessione di rete tra il server e i giocatori. I plugin reloader sono plugin come PlugMan o PlugManX, che caricano o scaricano singoli plugin a server avviato. ProtocolLib non supporta questa operazione e avvisa del rischio di uno stato incoerente. In tal caso ProtocolLib e tutti i plugin che si basano su di esso, come quelli anti-cheat o di visualizzazione, possono funzionare in modo errato.

Come risolvere:

  1. Non ricaricare ProtocolLib e i plugin che lo usano con un plugin reloader.
  2. Dopo aver modificato i plugin, riavvia completamente l'intero server.
  3. Se il reloader non ti serve, rimuovilo dalla cartella plugins in File, così non verrà usato per sbaglio.
  4. Se hai appena usato un reloader, esegui ora un riavvio completo, così tutto verrà ricaricato correttamente.

Buono a sapersi: il messaggio consiglia il comando di reload integrato. Anche questo, però, ricarica tutti i plugin a server avviato. Il metodo più sicuro resta un riavvio completo.

“Error loading plugin”: file o nome del plugin non valido

Ecco come appare il messaggio:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/<Datei>.jar' failed to update!
[DirectoryProviderSource] Error loading plugin: Directory 'plugins/<Datei>.jar' failed to load!
[DirectoryProviderSource] Error loading plugin: Restricted name, cannot use 0x20 (space character) in a plugin name.

Qual è la causa: un file nella cartella plugins non può essere caricato e il plugin non si avvia. Spesso si tratta di codice sorgente (-sources.jar), documentazione (-javadoc.jar), un download incompleto o una versione per un'altra piattaforma. Anche “Invalid plugin.yml” e “only DEFLATED entries can have EXT descriptor” indicano un file non adatto. “Restricted name” con “0x20” significa che il nome del plugin indicato in plugin.yml contiene uno spazio.

Come risolvere:

  1. Arresta il server e rimuovi il JAR indicato da plugins in File.
  2. Scarica il vero JAR del plugin dalla pagina ufficiale, nella versione adatta a Paper o Spigot. Le mod Fabric o Forge non vanno messe nella cartella plugins di questi server.
  3. Se il download è in formato ZIP, estrailo sul tuo computer e carica il JAR corretto.
  4. In caso di “Restricted name”, usa una versione corretta dallo sviluppatore. Il nome del plugin indicato nel file deve essere corretto; rinominare il file non risolve questo errore.
  5. Riavvia e controlla la Console.

Buono a sapersi: quando sostituisci il JAR, conserva i dati e le configurazioni esistenti del plugin.

Una libreria Java si trova come plugin nella cartella plugins

Ecco come appare il messaggio:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/asm-util-<Version>.jar' failed to update!

Qual è la causa: una libreria Java come ASM o Nashorn si trova come file a sé nella cartella plugins. Le librerie sono componenti che i plugin usano internamente, ma non sono plugin. Paper non può né caricare questo JAR come plugin né aggiornarlo, quindi lo salta. Il server continua a funzionare. File di questo tipo finiscono lì, ad esempio, quando viene caricato per intero un archivio contenente più file.

Come risolvere:

  1. Elimina il JAR della libreria indicata da plugins nella sezione File.
  2. Installa solo il plugin vero e proprio. Include già le sue librerie oppure le scarica all'avvio.
  3. Riavvia il server e controlla la Console.
  4. Se in seguito un plugin segnala che gli manca qualcosa, leggi la sua guida all'installazione invece di aggiungere le librerie a mano.

Buono a sapersi: se un plugin ha davvero bisogno di un secondo plugin, lo indica esplicitamente. Ecco come riconoscere questa situazione: Un plugin ha bisogno di un altro plugin.

Il file del plugin è vuoto («zip file is empty»)

Ecco come appare il messaggio:

[DirectoryProviderSource] Error loading plugin: zip file is empty

Qual è la causa: un file nella cartella plugins ha una dimensione di 0 byte oppure il suo caricamento è stato interrotto. Paper non riesce ad aprirlo e lo salta. Il plugin non viene caricato, ma il server continua a funzionare. Spesso succede quando la connessione cade durante il caricamento o quando il download era già incompleto sul tuo computer.

Come risolvere:

  1. Nella sezione File apri la cartella plugins e cerca il file da 0 byte o con una dimensione insolitamente ridotta.
  2. Eliminalo.
  3. Scarica di nuovo il plugin da una fonte affidabile e caricalo a server fermo. Attendi che il caricamento sia del tutto completato.
  4. Riavvia il server e controlla nella Console se il plugin viene caricato.

Buono a sapersi: con file grandi o numerosi, SFTP è spesso più affidabile del caricamento dal browser; consulta Modificare i file del server nel pannello e connettersi via SFTP.

PlaceholderAPI: il file dell'espansione non contiene una classe di espansione caricabile

Ecco come appare il messaggio:

[PlaceholderAPI] Failed to load expansion <Datei>.jar, as it does not have a class which extends PlaceholderExpansion

Qual è la causa: un'espansione di PlaceholderAPI fornisce segnaposto di testo aggiuntivi. Il file JAR viene analizzato, ma la classe di espansione necessaria non può essere trovata o caricata. Questa espansione resta quindi inattiva. Il server continua a funzionare, ma i suoi segnaposto non restituiscono i valori previsti.

Come risolvere:

  1. Leggi nella Console i messaggi che precedono questo errore. Altri errori di caricamento possono indicare una dipendenza mancante.
  2. Verifica nella sezione File che il file indicato sia davvero l'espansione di PlaceholderAPI desiderata. Fanne un backup prima di sostituirlo.
  3. Scarica di nuovo dalla fonte ufficiale l'espansione compatibile con la versione di PlaceholderAPI installata. Sostituisci il file interessato e rimuovi eventuali copie della stessa espansione.
  4. Riavvia completamente il server. Controlla poi il messaggio di avvio e un segnaposto fornito dall'espansione.

Velocity: sostituisci il plugin Spigot o BungeeCord con la versione per Velocity

Ecco come appare il messaggio:

Unable to load plugin plugins/<Plugin>.jar:
The plugin file <Plugin>.jar appears to be a Paper, Bukkit or BungeeCord plugin.
Velocity does not support plugins from these platforms.

Qual è la causa: Velocity è un proxy con una propria interfaccia per i plugin. Un file creato per Paper, Bukkit o BungeeCord non è compatibile e viene rifiutato. La funzione del plugin in questione non è disponibile sul proxy, mentre gli altri plugin caricati correttamente possono continuare a funzionare.

Come risolvere:

  1. Annota il nome del file rifiutato che compare nella Console.
  2. Arresta il proxy ed esegui un backup della relativa configurazione dalla sezione File.
  3. Rimuovi il file non compatibile dalla cartella dei plugin e installa la versione ufficiale per Velocity nella sezione Plugin. Per Geyser e Floodgate scegli la rispettiva variante per Velocity.
  4. Riavvia il proxy e controlla i messaggi di caricamento. Per il resto della configurazione, segui la documentazione della rispettiva versione per Velocity.

Il tuo messaggio non è nell'elenco?

Leggi il messaggio completo nella Console o in logs/latest.log, comprese le righe precedenti e successive. Il nome del file del plugin si trova nel messaggio stesso o nello stacktrace, l'elenco di righe at rientrate: lì il JAR compare prima della doppia barra, ad esempio <Plugin>.jar//. Anche i nomi di cartelle come plugins/<Plugin>/ indicano quale plugin è coinvolto. Crea un backup prima di sostituire i file. Se non riesci a risolvere, apri un ticket e indica l'ora in cui è comparso il messaggio.