Guida

Come risolvere gli errori dei plugin Minecraft

Aggiornato il 18 ottobre 2026

Quando un plugin non si carica, il server dice quasi sempre perché: il motivo è nella console durante l'avvio, qualche riga sopra o sotto il nome del plugin. Impara a leggere quella parte del log e la maggior parte degli errori si risolve in un minuto. Ecco i più comuni e cosa vogliono dire.

Scrivi la versione del tuo server e cosa deve fare il plugin.

Generalo con Codexe

Passo per passo

1.Apri il log dell'avvio
Leggi la console, o logs/latest.log nella cartella del server. Su un pannello di hosting usa la sua console o il file manager.
2.Cerca il nome del plugin
Trova il primo errore che lo nomina. Le righe che iniziano con [ERROR] o [WARN], con uno stack trace sotto, sono quelle che contano.
3.Leggi la prima riga e le righe "Caused by"
La prima riga dice cosa non è andato; l'ultima riga Caused by: di solito dice perché. Le righe con il nome del package del plugin mostrano in quale punto del suo codice.
4.Confrontalo con l'elenco qui sotto
La maggior parte degli errori all'avvio è un problema di versione, di Java o di dipendenze, e il messaggio dice quale.
5.Correggi una cosa e riavvia
Cambia una cosa sola, riavvia (non /reload) e rileggi il log. Gli errori di un plugin possono causare errori in altri.

Gli errori più comuni

Cosa vedi	Cosa vuol dire	Soluzione
`Unsupported API version 1.21`	L'`api-version` del plugin è più recente del tuo server.	Prendi la versione per il tuo server, o aggiorna il server.
`Could not load 'plugins/X.jar'` con `Invalid plugin.yml` o `Jar does not contain plugin.yml`	Il descrittore del plugin manca o ha un errore YAML, oppure il file non è un plugin.	Controlla di aver scaricato il plugin e non il suo sorgente, una mod o uno zip. Se l'hai compilato tu, correggi `plugin.yml`.
`UnsupportedClassVersionError`, "class file version 65.0"	Il plugin richiede un Java più recente di quello con cui gira il server (61 = Java 17, 65 = Java 21, 69 = Java 25).	Fai girare il server con quel Java, o ricompila il plugin per il tuo Java.
`NoClassDefFoundError` o `ClassNotFoundException`	Manca una classe che serve al plugin: manca un plugin da cui dipende, una libreria non è stata inclusa nel .jar, oppure l'API non esiste in questa versione.	Installa il plugin nominato nell'errore (Vault, ProtocolLib), o usa una build per la tua versione.
`Unknown/missing dependency plugins`	Un plugin elencato in `depend` non è installato.	Installalo in `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Il plugin si è caricato ma è andato in crash in `onEnable`.	Leggi la riga `Caused by`: spesso è un errore di configurazione o una dipendenza mancante.
`Ambiguous plugin name`	In `plugins/` ci sono due file .jar dello stesso plugin.	Cancella quello vecchio.

Errori che non riguardano il caricamento

Il plugin è verde ma un comando dice "Unknown command": il comando manca in plugin.yml, oppure un altro plugin usa lo stesso nome.
"I'm sorry, but you do not have permission": al giocatore manca il nodo del permesso. Controlla il nodo nella pagina del plugin e assegnalo con il tuo plugin dei permessi.
Errori dopo aver modificato config.yml: lo YAML vuole spazi, non tabulazioni, e le virgolette intorno al testo che inizia con : o &.
Funziona dopo un riavvio, si rompe dopo /reload: il plugin non supporta /reload. Riavvia invece.

Quale Java serve al tuo server

Minecraft 1.20.5 e successive richiedono Java 21, e la 26.x richiede Java 25; dalla 1.18 alla 1.20.4 serve Java 17. Esegui java -version con lo stesso Java che usa il server (su un pannello di hosting di solito è un'impostazione chiamata immagine Docker o versione di Java). Un plugin compilato per un Java più vecchio gira su uno più recente, non il contrario.

Correggere i plugin creati con Codexe

I plugin creati su Codexe vengono compilati per la versione che hai scelto e controllati per avere un plugin.yml valido prima di essere dichiarati pronti. Su un server di prova la scheda Log mostra il log in tempo reale con gli errori evidenziati, ed Esporta i log lo salva in un file. Descrivi quello che vedi nella chat del progetto ("il plugin è rosso in /plugins e il log dice ...") e Codexe modifica il codice e compila di nuovo. Se una compilazione fallisce su file esattamente come li ha consegnati Codexe, Correggi con l'AI li ripara gratis.

Domande

Dove si trova il log del server?

logs/latest.log nella cartella del server, per l'avvio in corso. Quelli precedenti sono nella stessa cartella come file .log.gz.

Un plugin può romperne un altro?

Sì: una dipendenza mancante o rotta blocca tutti i plugin che ne hanno bisogno. Correggi il primo errore del log prima degli altri.

Posso condividere il mio log senza rischi?

Quasi sempre, ma controllalo prima: i log possono contenere indirizzi IP e, con alcuni plugin, password del database comparse negli errori.

Ricrea un plugin rotto per il tuo server

Questo prompt si apre pronto da inviare:

“Un plugin per Paper 1.21.4 chiamato SimpleWarps che sostituisce il mio vecchio plugin che non si carica più: /setwarp, /warp e /delwarp con un nome, /warps li elenca in una GUI, permesso warps.admin per creare e cancellare, warp salvati tra un riavvio e l'altro, messaggi in config.yml.”