Cara memperbarui plugin ke versi Minecraft baru

Langkah demi langkah

1. 1.Coba .jar lama terlebih dahulu

   Pasang di server uji dengan versi baru dan baca console. Jika termuat dan berfungsi, mungkin kamu tidak perlu mengubah apa pun.

2. 2.Ubah dependensi API

   Di pom.xml atau build.gradle, atur paper-api atau spigot-api ke versi baru.

3. 3.Perbarui api-version dan Java

   Atur api-version di plugin.yml (misalnya '1.21') dan kompilasi untuk Java yang dibutuhkan versi baru: Java 17 sebelum 1.20.5, Java 21 sejak 1.20.5, Java 25 untuk 26.x.

4. 4.Perbaiki yang tidak lagi bisa dikompilasi

   Build dan telusuri error-nya: material yang diganti nama, method yang dihapus, class event yang berubah. Compiler mencantumkannya beserta file dan barisnya.

5. 5.Perbarui dependensi

   Plugin yang dipakai plugin-mu (Vault, PlaceholderAPI, ProtocolLib, WorldGuard) juga butuh versi yang mendukung versi Minecraft baru, baik di file build maupun di server.

6. 6.Uji di versi baru

   Muat di server dengan versi baru dan plugin yang sama, lalu coba setiap perintah dan fitur, bukan hanya startup.

Yang biasanya rusak

• Nama material dan enum: update 1.13 mengganti nama sebagian besar item dan blok; versi-versi berikutnya menambah, mengganti nama, atau menghapus beberapa. Kode yang memakai nama lama atau id angka akan gagal.
• Method deprecated dihapus: method yang ditandai deprecated selama beberapa versi pada akhirnya hilang.
• Data item: sejak 1.20.5, NBT item diganti dengan data component. Plugin yang mengedit NBT item secara langsung perlu menulis ulang bagian itu; API ItemMeta yang biasa tetap berfungsi.
• NMS dan reflection: kode yang memakai class internal server rusak di hampir setiap versi. Ganti dengan API jika memungkinkan, atau dengan library seperti ProtocolLib.
• Versi library: library yang di-shade dan di-build untuk Java lama bisa gagal di Java baru.

Memperbarui melintasi banyak versi

Pindah dari 1.8 atau 1.12 ke 1.21 lebih mirip menulis ulang bagian yang menyentuh item, blok, dan partikel daripada sekadar update. Lakukan sekaligus dengan API baru, bukan versi demi versi, dan bersiaplah file config juga butuh nama material baru.

Jika plugin harus mendukung beberapa versi sekaligus, kompilasi dengan versi tertua yang kamu dukung dan hindari API yang ditambahkan belakangan, atau gunakan build terpisah per versi.

Dengan Codexe

Di Pro ke atas kamu bisa mengimpor kode sumber plugin sebagai ZIP dan meminta, misalnya, "Ini plugin Paper 1.20.4-ku. Perbarui ke Paper 1.21.4". Codexe membaca versi Minecraft dari file build, mem-build dengan Java yang dibutuhkan versi itu, dan memperbaiki error kompilasi memakai signature asli dari API yang dipakai untuk build. Untuk plugin yang kamu buat di Codexe, minta versi baru di chat proyek.

Kompilasi membuktikan plugin bisa di-build dengan API baru. Setelah itu coba di server uji coba, karena perubahan perilaku antar versi tidak muncul sebagai error kompilasi.

Pertanyaan