Panduan

Cara membuat plugin Paper

Diperbarui 7 Oktober 2026

Paper adalah software server Minecraft yang paling banyak dipakai untuk plugin: menjalankan plugin Spigot dan menambahkan API yang lebih besar dan cepat di atasnya. Plugin Paper adalah proyek Java (atau Kotlin) yang dikompilasi terhadap paper-api. Inilah yang dibutuhkannya, secara manual atau dengan AI yang membuatkannya.

Contoh untuk memulai.

Buat ini dengan Codexe

Langkah demi langkah

  1. 1.Pilih versi Minecraft

    Pakai versi yang dijalankan servermu. Versi itu menentukan versi Java: Java 17 sebelum 1.20.5, Java 21 mulai 1.20.5, Java 25 untuk 26.x.

  2. 2.Buat proyek

    Proyek Gradle atau Maven dengan dependensi paper-api untuk versi itu, dari repositori PaperMC, dengan scope provided/compileOnly.

  3. 3.Tulis class utama

    Class yang meng-extend JavaPlugin, dengan onEnable() untuk mendaftarkan perintah dan listener.

  4. 4.Jelaskan plugin ke server

    plugin.yml (name, version, main, api-version, commands, permissions). Paper juga mendukung paper-plugin.yml, dengan aturan pemuatannya sendiri.

  5. 5.Build dan uji

    Build .jar-nya, letakkan di folder plugins/ server uji Paper, jalankan, dan periksa konsol untuk error.

Paper atau Spigot?

Kode yang ditulis untuk API Spigot berjalan di Paper, tetapi tidak sebaliknya: Paper menambahkan event dan method (misalnya komponen teks Adventure dan banyak API async) yang tidak dimiliki Spigot. Tulis untuk Paper jika servermu menjalankan Paper; tulis untuk Spigot jika plugin juga harus berjalan di server Spigot.

Cara cepat

Di Codexe, pilih plugin Bukkit/Spigot/Paper, sebutkan "Paper" dan versinya di permintaan, lalu jelaskan apa yang dilakukannya. Codexe menyiapkan proyek dan versi Java yang tepat, mengompilasinya, memperbaiki error build, dan membiarkanmu bergabung ke server uji Paper dengan plugin terpasang.

Masalah umum

  • UnsupportedClassVersionError: plugin dikompilasi dengan Java yang lebih baru daripada yang dijalankan server.
  • NoSuchMethodError / NoClassDefFoundError: plugin memakai API yang tidak ada di versi server, atau dependensi tidak di-shade ke dalam .jar.
  • Plugin termuat tetapi perintah tidak melakukan apa-apa: perintah tidak ada di plugin.yml atau executor-nya belum didaftarkan.

Pertanyaan

Apakah plugin Paper berfungsi di Purpur atau Folia?

Purpur adalah fork Paper, jadi plugin Paper berjalan di sana. Folia mengubah threading: plugin harus ditulis untuk region scheduler-nya agar berjalan di Folia.

Bisakah aku menulis plugin Paper dengan Kotlin?

Ya. Codexe bisa membuat proyek Gradle Kotlin dengan build.gradle.kts untuk Paper API yang sama.

Buat plugin Paper sekarang

Prompt ini terbuka dan siap dikirim:

“Plugin Paper 1.21.4 bernama Bounties: /bounty set <player> <amount> memakai ekonomi Vault, pembunuh mendapat hadiah, /bounty list menampilkan 10 teratas, bounty tersimpan setelah restart, pesan di config.yml.”

Buat ini dengan Codexe
Cara membuat plugin Paper (Minecraft) | Codexe