Cara menggunakan: Generator plugin.yml untuk Spigot dan Paper
plugin.yml adalah file YAML kecil yang memberi tahu Spigot, Paper, dan Purpur cara memuat plugin Anda: nama, kelas utama, versi, target API, perintah, dan izin. Generator ini mengisi field umum tersebut sehingga Anda tidak perlu mengetik YAML yang rapuh secara manual setelah setiap penggantian nama proyek. Ini tidak menulis Java, mengompilasi jar, atau memperbaiki jalur kelas utama yang rusak.
Anda memasukkan nama plugin, kelas utama, versi, penulis opsional, deskripsi, situs web, api-version, daftar depend/softdepend, lalu perintah dan izin jika Anda membutuhkannya. Halaman ini membuat plugin.yml yang dapat Anda unduh atau tempel ke src/main/resources. Ini membuat kerangka awal dan perbaikan singkat untuk "Saya hanya perlu satu perintah lagi di /help".
Ini tidak menulis kode plugin Anda. Jika perintah terdaftar di sini tetapi tidak pernah didaftarkan di Java, pemain akan melihat entri yang rusak. Jika kelas utama tidak cocok dengan paket yang Anda kompilasi, server akan menolak untuk mengaktifkan plugin. Perlakukan file ini sebagai metadata, bukan penginstal ajaib.
api-version harus mendekati versi Minecraft yang Anda gunakan untuk membangun, sehingga Paper dapat memperingatkan tentang API yang tidak kompatibel. depend dan softdepend hanya membantu jika plugin tersebut benar-benar ada di server target. Nama yang salah di sini tidak mengunduh apa pun; mereka hanya mengubah urutan pemuatan dan perilaku pengaktifan.
Setiap perintah dapat membawa deskripsi, baris penggunaan, dan node izin. Setiap izin dapat mengatur default (op, true, false, not op). Pertahankan nama yang stabil setelah pemain dan grup LuckPerms mulai menggunakannya; mengganti nama node nanti berarti memigrasikan konfigurasi di server langsung.
Dalam proyek Maven atau Gradle normal, file ini terletak di bawah resources sehingga berakhir di akar jar sebagai plugin.yml. Setelah membangun ulang, pastikan jar masih berisi file tersebut sebelum Anda menyalahkan generator. Panel hosting yang mengunggah "folder plugin" tetap memerlukan jar yang tepat untuk plugin gaya Spigot.
FAQ Plugin Yml
Apakah ini menulis Java untuk saya?
Tidak. Hanya plugin.yml. Anda tetap membuat kode, mengompilasi, dan menyebarkan jar sendiri.
Paper atau Spigot?
Field dasarnya sama. Atur api-version ke baris yang Anda dukung dan uji pada jar asli Anda.
Di mana saya menaruh file ini?
Biasanya di src/main/resources/plugin.yml sehingga dikirim di akar jar.
Mengapa plugin tidak mau aktif?
Kelas utama salah, depend hilang, atau ada kesalahan pemuatan di onEnable. Periksa log server setelah file terlihat benar.
Bisakah saya mengedit YAML setelah diunduh?
Ya. Generator hanyalah titik awal. Simpan salinan di git bersama dengan proyek lainnya.