Panduan

Cara memperbaiki error plugin Minecraft

Diperbarui 18 Oktober 2026

Saat plugin tidak termuat, server hampir selalu menyebutkan alasannya: penyebabnya ada di console saat startup, beberapa baris di atas atau di bawah nama plugin. Belajarlah membaca bagian log itu dan sebagian besar error bisa diperbaiki dalam semenit. Berikut error yang umum dan artinya.

Sebutkan versi servermu dan apa yang harus dilakukan plugin.

Buat ini dengan Codexe

Langkah demi langkah

1.Buka log startup
Baca console, atau logs/latest.log di folder server. Di panel hosting, gunakan console atau file manager-nya.
2.Cari nama plugin
Temukan error pertama yang menyebutnya. Baris yang diawali [ERROR] atau [WARN] dan stack trace di bawahnya adalah yang penting.
3.Baca baris pertama dan baris "Caused by"
Baris pertama menyebutkan apa yang gagal; baris Caused by: terakhir biasanya menyebutkan alasannya. Baris dengan nama package plugin itu sendiri menunjukkan lokasinya di kode.
4.Cocokkan dengan daftar di bawah
Sebagian besar error startup adalah masalah versi, Java, atau dependensi, dan pesannya menyebutkan yang mana.
5.Perbaiki satu hal lalu restart
Ubah satu hal, restart (bukan /reload), lalu baca log lagi. Error dari satu plugin bisa menyebabkan error di plugin lain.

Error yang umum

Yang kamu lihat	Artinya	Solusi
`Unsupported API version 1.21`	`api-version` plugin lebih baru dari servermu.	Ambil versi untuk servermu, atau perbarui server.
`Could not load 'plugins/X.jar'` dengan `Invalid plugin.yml` atau `Jar does not contain plugin.yml`	Descriptor plugin tidak ada atau punya error YAML, atau file-nya bukan plugin.	Pastikan yang kamu unduh adalah plugin-nya, bukan kode sumber, mod, atau zip. Jika kamu mem-build-nya sendiri, perbaiki `plugin.yml`.
`UnsupportedClassVersionError`, "class file version 65.0"	Plugin butuh Java yang lebih baru dari yang dijalankan server (61 = Java 17, 65 = Java 21, 69 = Java 25).	Jalankan server dengan Java tersebut, atau build ulang plugin untuk Java-mu.
`NoClassDefFoundError` atau `ClassNotFoundException`	Class yang dibutuhkan plugin tidak ada: plugin dependensi hilang, library tidak di-shade ke dalam .jar, atau API-nya tidak ada di versi ini.	Pasang plugin yang disebut di error (Vault, ProtocolLib), atau gunakan build untuk versimu.
`Unknown/missing dependency plugins`	Plugin yang tercantum di `depend` tidak terpasang.	Pasang di `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Plugin termuat tetapi crash di `onEnable`.	Baca baris `Caused by`: sering kali error config atau dependensi yang hilang.
`Ambiguous plugin name`	Ada dua file .jar dari plugin yang sama di `plugins/`.	Hapus yang lama.

Error yang bukan soal pemuatan

Plugin berwarna hijau tetapi perintah menampilkan "Unknown command": perintahnya tidak ada di plugin.yml, atau plugin lain memakai nama yang sama.
"I'm sorry, but you do not have permission": pemain tidak punya permission node-nya. Periksa node di halaman plugin dan berikan lewat plugin permission-mu.
Error setelah mengedit config.yml: YAML butuh spasi, bukan tab, dan tanda kutip di sekitar teks yang diawali : atau &.
Berfungsi setelah restart, rusak setelah /reload: plugin tidak mendukung /reload. Restart saja.

Java yang dibutuhkan servermu

Minecraft 1.20.5 ke atas butuh Java 21, dan 26.x butuh Java 25; 1.18 sampai 1.20.4 butuh Java 17. Jalankan java -version dengan Java yang sama dengan yang dipakai server (di panel hosting biasanya berupa pengaturan bernama Docker image atau Java version). Plugin yang di-build untuk Java lama berjalan di Java yang lebih baru, bukan sebaliknya.

Memperbaiki plugin yang dibuat dengan Codexe

Plugin yang dibuat di Codexe dikompilasi untuk versi yang kamu pilih dan diperiksa memiliki plugin.yml yang valid sebelum Ready. Di server uji coba, tab Logs menampilkan log secara langsung dengan error yang disorot, dan Export logs menyimpannya sebagai file. Jelaskan apa yang kamu lihat di chat proyek ("plugin berwarna merah di /plugins dan log-nya bilang ...") lalu Codexe mengubah kode dan mem-build lagi. Jika Compile gagal pada file yang persis seperti yang dikirimkan Codexe, Fix with AI memperbaikinya secara gratis.

Pertanyaan

Di mana log server berada?

logs/latest.log di folder server, untuk sesi saat ini. Sesi sebelumnya ada di folder yang sama sebagai file .log.gz.

Bisakah satu plugin merusak plugin lain?

Bisa: dependensi yang hilang atau rusak menghentikan setiap plugin yang membutuhkannya. Perbaiki error pertama di log sebelum yang lain.

Apakah aman membagikan log-ku?

Umumnya aman, tetapi periksa dulu: log bisa berisi alamat IP dan, dengan beberapa plugin, kata sandi database dari pesan error.

Build ulang plugin yang rusak untuk servermu

Prompt ini terbuka dan siap dikirim:

“Plugin Paper 1.21.4 bernama SimpleWarps yang menggantikan plugin lamaku yang tidak lagi termuat: /setwarp, /warp, dan /delwarp dengan nama, /warps menampilkan daftarnya di GUI, permission warps.admin untuk mengatur dan menghapus, warp tersimpan setelah restart, pesan di config.yml.”