Panduan
Cara membuat plugin ekonomi Minecraft
Diperbarui 18 Oktober 2026
Plugin ekonomi menyimpan saldo setiap pemain dan memungkinkan mereka saling membayar, mendapatkan uang, dan membelanjakannya di toko. Bagian terpentingnya bukan perintahnya, melainkan integrasi dengan Vault: itulah yang memungkinkan plugin toko, pekerjaan (jobs), dan lelang memakai uangmu. Panduan ini membahas desain, penyimpanan, serta cara mem-build dan mengujinya.
Mulai dari contoh ini dan ubah aturannya sesuai kebutuhanmu.
Buat ini dengan CodexeLangkah demi langkah
1.Tentukan peran plugin
Plugin itu menjadi ekonominya (menyimpan saldo dan mendaftarkan diri sebagai ekonomi Vault), atau memakai ekonomi yang sudah ada lewat Vault (toko, bounty, plugin jobs). Kebanyakan server butuh satu dari masing-masing, bukan dua ekonomi.
2.Pilih server dan versi
Tulis software dan versi server, misalnya Paper 1.21.4. Plugin di-build untuk API dan level Java versi tersebut.
3.Daftarkan perintah dan aturannya
/balance,/pay <player> <amount>,/baltop, dan perintah admin seperti/eco give|take|set. Tambahkan saldo awal, nama mata uang, jumlah desimal, dan pembayaran minimum.4.Pilih tempat menyimpan saldo
SQLite untuk satu server, MySQL jika beberapa server harus berbagi saldo yang sama. Uang harus bertahan setelah restart dan crash, jadi tidak pernah hanya disimpan di memori.
5.Biarkan Codexe menulis dan membangunnya
Deskripsikan plugin-nya dan sebutkan Vault secara eksplisit agar ditambahkan sebagai dependensi. Codexe menulis kode Java,
plugin.yml, danconfig.yml, mengompilasinya, dan memperbaiki error build sebelum proyek Ready.6.Uji pembayaran di dalam game
Tekan Coba sekarang dan bergabunglah ke server uji coba. Lakukan pembayaran antara dua akun, coba jumlah yang terlalu besar, negatif, atau bukan angka, lalu restart dan pastikan saldonya masih ada.
7.Pasang
Letakkan Vault dan .jar-mu di folder
plugins/server lalu restart. Hapus plugin ekonomi lainnya, atau tentukan mana yang harus dipakai Vault.
Peran Vault
Vault adalah jembatan, bukan ekonomi. Plugin ekonomi mengimplementasikan interface Economy milik Vault dan mendaftarkannya ke services manager server; plugin lain memintanya dengan getServer().getServicesManager().getRegistration(Economy.class) dan memanggil method seperti getBalance, withdrawPlayer, dan depositPlayer.
Jadi plugin toko tidak perlu tahu ekonomi apa yang kamu jalankan. Di plugin.yml gunakan depend: [Vault] jika plugin tidak bisa berjalan tanpanya, atau softdepend jika Vault opsional. Vault API hanya dibutuhkan untuk kompilasi; Vault sendiri dipasang di server.
Keputusan yang perlu ditulis di permintaan
- Format uang: nama mata uang dalam bentuk tunggal dan jamak, simbol, berapa desimal.
- Batas: saldo awal, saldo maksimum, apakah saldo boleh negatif.
- Pemain offline: apakah
/paydan/ecoberlaku untuk pemain yang sedang tidak online. - Pencatatan: log transaksi di database atau file, agar staf bisa memeriksa sengketa.
- Mendapatkan uang: membunuh mob, hadiah waktu bermain, menjual item, atau hanya lewat perintah admin.
Tempat menyimpan saldo
| Penyimpanan | Cocok untuk | Perhatikan |
|---|---|---|
| File YAML | Server sangat kecil, mudah dibaca | Lambat dengan banyak pemain, mudah rusak saat crash |
| SQLite | Satu server, tanpa penyiapan | Tidak bisa dibagi antar server |
| MySQL / MariaDB | Jaringan server yang berbagi satu saldo | Butuh server database dan login di config.yml |
Contoh deskripsi
"Plugin ekonomi Paper 1.21.4 bernama Coins yang mendaftarkan diri sebagai ekonomi Vault. /balance [player], /pay <player> <amount> dengan minimum 1, /baltop dengan 10 teratas, dan /eco give|take|set untuk pemain dengan coins.admin. Pemain baru mulai dengan 100 koin. Dua desimal. Setiap pembayaran dicatat dengan tanggal, pengirim, penerima, dan jumlah. Saldo disimpan di SQLite. Nama mata uang dan semua pesan di config.yml."
Codexe memakai SQLite secara default jika kamu tidak meminta yang lain. Jika kamu meminta MySQL, plugin ditulis dengan pengaturan storage-type, dan server uji coba menyediakan database MySQL sendiri untuknya selama kamu mencobanya.
Pertanyaan
Apakah aku butuh Vault?
Tidak, untuk ekonomi mandiri yang tidak dipakai plugin lain. Kamu membutuhkannya begitu plugin lain (toko, jobs, lelang) harus membaca atau mengubah saldo, karena itulah API yang mereka cari.
Bisakah dijalankan bersama EssentialsX?
EssentialsX punya ekonomi sendiri dan juga mendaftarkannya ke Vault. Jalankan satu ekonomi saja dalam satu waktu, atau matikan yang tidak kamu inginkan; kalau tidak, plugin lain bisa memakai saldo yang berbeda dari yang ditampilkan perintahmu.
Bisakah beberapa server berbagi saldo yang sama?
Bisa, dengan MySQL atau MariaDB sebagai penyimpanan dan database yang sama di config.yml setiap server. Mintalah di permintaanmu agar plugin membaca saldo dari database alih-alih menyimpannya di cache terlalu lama.
Bagaimana cara mengujinya tanpa server sungguhan?
Dengan Coba sekarang: server Paper pribadi dengan versimu menyala dengan plugin yang sudah dikompilasi, dan plugin yang tercantum di depend dan softdepend, seperti Vault, ikut dipasang. Paket gratis memberi 3 server uji coba per hari, masing-masing 10 menit.
Buat ekonomi servermu
Prompt ini terbuka dan siap dikirim:
“Plugin ekonomi Paper 1.21.4 bernama Coins yang terdaftar sebagai ekonomi Vault: /balance, /pay dengan minimum 1, /baltop 10 teratas, /eco give|take|set untuk coins.admin, saldo awal 100, dua desimal, setiap pembayaran dicatat, saldo di SQLite, nama mata uang dan pesan di config.yml.”
Buat ini dengan Codexe