Kompatibilitas versi plugin dan API
Mengapa plugin tidak berfungsi di versi Anda, apa arti api-version, cara membaca persyaratan, dan apa yang bisa ditimbulkan ketidakcocokan.
Diperbarui 13 Agustus 2026
Sebuah plugin dibuat untuk versi API server tertentu. Ketidakcocokan akan mencegahnya dimuat atau menyebabkan error saat berjalan.
Apa yang menentukan kompatibilitas
- Versi game. Plugin untuk 1.20 biasanya tidak akan berfungsi di 1.21: kelas internalnya berubah.
- Core. Bukkit/Spigot/Paper kompatibel "dari bawah ke atas": plugin Bukkit akan berjalan di Paper, tetapi tidak sebaliknya jika API khusus Paper digunakan.
- Dependensi. Vault, PlaceholderAPI, ProtocolLib — versinya juga harus cocok.
api-version
plugin.yml milik plugin menentukan:
api-version: 1.21
Jika baris tersebut sama sekali tidak ada, server menganggap plugin sebagai legacy dan mengaktifkan mode kompatibilitas — sebuah peringatan muncul di log. Ini bukan error, melainkan tanda plugin lama.
Gejala umum
| Di log | Arti |
|---|---|
Unsupported API version | Plugin dibuat untuk core yang lebih baru |
NoSuchMethodError | Method tersebut sudah tidak ada di versi Anda — penjelasan |
NoClassDefFoundError | Dependensi tidak ditemukan — penjelasan |
Invalid plugin.yml | File rusak atau ini bukan plugin — penjelasan |
Memeriksa sebelum instalasi
Katalog "Plugins and mods" di panel memfilter berdasarkan core dan versi Anda serta memperingatkan Anda tentang ketidakcocokan sebelum instalasi — Cara memasang. Saat mengunggah secara manual, periksa halaman plugin: di sana selalu tercantum rentang versi yang didukung.
