Come aggiornare un plugin a una nuova versione di Minecraft

Passo per passo

1. 1.Prova prima il .jar vecchio

   Mettilo su un server di prova della nuova versione e leggi la console. Se si carica e funziona, potresti non dover cambiare niente.

2. 2.Cambia la dipendenza dell'API

   In pom.xml o build.gradle, imposta paper-api o spigot-api alla nuova versione.

3. 3.Aggiorna api-version e Java

   Imposta api-version in plugin.yml (per esempio '1.21') e compila per il Java richiesto dalla nuova versione: Java 17 prima della 1.20.5, Java 21 dalla 1.20.5, Java 25 per la 26.x.

4. 4.Correggi quello che non si compila più

   Compila e passa in rassegna gli errori: materiali rinominati, metodi rimossi, classi di eventi cambiate. Il compilatore li elenca con file e riga.

5. 5.Aggiorna le dipendenze

   Anche i plugin che usa il tuo plugin (Vault, PlaceholderAPI, ProtocolLib, WorldGuard) devono essere in versioni che supportano la nuova versione di Minecraft, sia nel file di build sia sul server.

6. 6.Provalo sulla nuova versione

   Caricalo su un server della nuova versione con gli stessi plugin e prova ogni comando e ogni funzione, non solo l'avvio.

Cosa si rompe di solito

• Nomi di materiali ed enum: l'aggiornamento 1.13 ha rinominato la maggior parte di oggetti e blocchi; le versioni successive ne aggiungono, rinominano o tolgono alcuni. Il codice che usa nomi vecchi o id numerici va in errore.
• Metodi deprecati rimossi: i metodi segnati come deprecati per diverse versioni prima o poi spariscono.
• Dati degli oggetti: dalla 1.20.5 l'NBT degli oggetti è stato sostituito dai data component. I plugin che modificano direttamente l'NBT degli oggetti devono riscrivere quella parte; la normale API ItemMeta continua a funzionare.
• NMS e reflection: il codice che usa le classi interne del server si rompe quasi a ogni versione. Sostituiscilo con l'API dove possibile, o con una libreria come ProtocolLib.
• Versioni delle librerie: le librerie incluse nel .jar compilate per un Java più vecchio possono non funzionare con quello nuovo.

Aggiornare saltando molte versioni

Passare dalla 1.8 o dalla 1.12 alla 1.21 somiglia più a riscrivere le parti che toccano oggetti, blocchi e particelle che a un aggiornamento. Fallo in un colpo solo contro la nuova API, non versione per versione, e aspettati che anche i file di configurazione abbiano bisogno dei nuovi nomi dei materiali.

Se il plugin deve supportare più versioni insieme, compila contro la più vecchia che supporti ed evita le API aggiunte dopo, oppure usa build separate per ogni versione.

Con Codexe

Da Pro in su puoi importare il sorgente del plugin come ZIP e chiedere, per esempio, "Questo è il mio plugin per Paper 1.20.4. Aggiornalo a Paper 1.21.4". Codexe legge la versione di Minecraft dal file di build, compila con il Java richiesto da quella versione e corregge gli errori di compilazione usando le firme reali dell'API contro cui compila. Per un plugin che hai creato su Codexe, chiedi la nuova versione nella chat del progetto.

La compilazione dimostra che il plugin si compila con la nuova API. Poi provalo su un server di prova, perché i cambi di comportamento tra una versione e l'altra non compaiono come errori di compilazione.

Domande