Cum actualizezi un plugin la o versiune nouă de Minecraft

Pas cu pas

1. 1.Încearcă mai întâi .jar-ul vechi

   Pune-l pe un server de testare cu versiunea nouă și citește consola. Dacă se încarcă și funcționează, s-ar putea să nu trebuiască să schimbi nimic.

2. 2.Schimbă dependența de API

   În pom.xml sau build.gradle, setează paper-api sau spigot-api la versiunea nouă.

3. 3.Actualizează api-version și Java

   Setează api-version în plugin.yml (de exemplu '1.21') și compilează pentru Java de care are nevoie versiunea nouă: Java 17 înainte de 1.20.5, Java 21 de la 1.20.5, Java 25 pentru 26.x.

4. 4.Repară ce nu se mai compilează

   Compilează și treci prin erori: materiale redenumite, metode eliminate, clase de evenimente schimbate. Compilatorul le listează cu fișierul și linia.

5. 5.Actualizează dependențele

   Plugin-urile pe care le folosește pluginul tău (Vault, PlaceholderAPI, ProtocolLib, WorldGuard) au nevoie și ele de versiuni care suportă noua versiune de Minecraft, atât în fișierul de build, cât și pe server.

6. 6.Testează pe versiunea nouă

   Încarcă-l pe un server cu versiunea nouă și aceleași plugin-uri și încearcă fiecare comandă și funcție, nu doar pornirea.

Ce se strică de obicei

• Numele materialelor și ale enum-urilor: update-ul 1.13 a redenumit majoritatea obiectelor și blocurilor; versiunile ulterioare adaugă, redenumesc sau elimină câteva. Codul care folosește nume vechi sau id-uri numerice eșuează.
• Metode depreciate eliminate: metodele marcate ca depreciate timp de mai multe versiuni dispar până la urmă.
• Datele obiectelor: de la 1.20.5, NBT-ul obiectelor a fost înlocuit de data components. Plugin-urile care editează direct NBT-ul obiectelor au nevoie de rescrierea acelei părți; API-ul normal ItemMeta continuă să funcționeze.
• NMS și reflection: codul care folosește clase interne ale serverului se strică la aproape fiecare versiune. Înlocuiește-l cu API-ul unde se poate sau cu o bibliotecă precum ProtocolLib.
• Versiunile bibliotecilor: bibliotecile incluse prin shade, construite pentru un Java mai vechi, pot eșua pe cel nou.

Actualizarea peste multe versiuni

Trecerea de la 1.8 sau 1.12 la 1.21 seamănă mai mult cu o rescriere a părților care ating obiecte, blocuri și particule decât cu un update. Fă-o dintr-o dată, pe API-ul nou, nu versiune cu versiune, și așteaptă-te ca și fișierele de configurare să aibă nevoie de nume noi de materiale.

Dacă pluginul trebuie să suporte mai multe versiuni deodată, compilează pe cea mai veche pe care o suporți și evită API-ul adăugat mai târziu sau folosește build-uri separate pentru fiecare versiune.

Cu Codexe

Pe Pro și mai sus poți importa sursa pluginului ca ZIP și poți cere, de exemplu, „Acesta este pluginul meu Paper 1.20.4. Actualizează-l la Paper 1.21.4”. Codexe citește versiunea de Minecraft din fișierul de build, compilează cu Java de care are nevoie acea versiune și repară erorile de compilare folosind semnăturile reale ale API-ului pe care compilează. Pentru un plugin făcut pe Codexe, cere versiunea nouă în chatul proiectului.

Compilarea dovedește că pluginul se construiește pe API-ul nou. Apoi încearcă-l pe un server de testare, pentru că schimbările de comportament dintre versiuni nu apar ca erori de compilare.

Întrebări