Minecraft Servers HQ

Plugin Minecraft EconomyAPI

Informasi tentang EconomyAPI dan server tempat ditemukan

🔌 Tentang EconomyAPI

EconomyAPI adalah plugin inti ekonomi dan implementasi API yang awalnya dibuat oleh onebone. Plugin ini diterbitkan dan didistribusikan untuk ekosistem server bergaya Bedrock/PocketMine (varian PocketMine/Nukkit) dan dimaksudkan untuk menyediakan backend mata uang bersama serta metode programatik yang bisa dipanggil plugin lain.

🎯 Tujuan

EconomyAPI menyediakan sistem mata uang terpusat sehingga pembuat plugin dapat membaca dan mengubah saldo pemain, mendaftarkan event terkait ekonomi, dan memungkinkan administrator server menampilkan perintah ekonomi dasar kepada pemain. Plugin ini memecahkan masalah ketika banyak plugin membutuhkan implementasi ekonomi terpisah dengan menawarkan lapisan API yang umum.

⚙️ Fitur

  • Menyediakan metode API programatik untuk pengecekan dan pembaruan saldo (contoh di dokumentasi mencakup akses gaya getInstance).
  • Menyediakan perintah ekonomi untuk pemain seperti balance, pay, dan penyesuaian money oleh admin.
  • Memicu event dan hook yang bisa didengarkan plugin lain untuk penanganan transaksi.
  • Banyak digunakan sebagai dependensi/komponen inti untuk addon dan ekstensi ekonomi PocketMine/Nukkit lainnya.

🧩 Untuk Siapa

  • Pengembang server dan plugin yang membutuhkan backend ekonomi bersama pada perangkat lunak server Bedrock bergaya PocketMine/Nukkit.
  • Administrator server Bedrock kecil hingga menengah yang bergantung pada ekosistem plugin yang terintegrasi dengan EconomyAPI.

🏗️ Contoh Penggunaan

  • Plugin toko atau marketplace membaca dan mengurangi saldo pemain melalui pemanggilan EconomyAPI.
  • Plugin lelang atau hadiah memberikan mata uang dengan memanggil metode add/reduce milik API.
  • Jaringan server yang menyertakan plugin addon yang mengharapkan penyedia ekonomi umum.

⌨️ Perintah

CommandDescriptionPermissionAccess
/mymoneyTampilkan saldo Anda saat ini.economyapi.command.mymoneyPemain
/seemoneyLihat saldo pemain lain.economyapi.command.seemoneyAdmin
/payBayar pemain lain.tidak disebutkanPemain
/givemoneyBeri uang kepada pemain.economyapi.command.givemoneyAdmin
/takemoneyAmbil uang dari pemain.economyapi.command.takemoneyAdmin
/setmoneyTetapkan saldo pemain.economyapi.command.setmoneyAdmin
/topmoneyTampilkan papan peringkat saldo tertinggi.economyapi.command.topmoneyPemain

(Perintah dan node permission di atas diambil dari listing resource PocketMine/Nukkit yang dipublikasikan; ketersediaan pastinya dapat berbeda حسب build/fork.)

🔐 Permissions

PermissionDescriptionDefault
economyapiNode permission dasar untuk fitur EconomyAPI.tidak disebutkan
economyapi.commandNode dasar untuk perintah ekonomi.tidak disebutkan
economyapi.command.mymoneyMemungkinkan penggunaan /mymoney.tidak disebutkan
economyapi.command.seemoneyMemungkinkan melihat saldo pemain lain.tidak disebutkan
economyapi.command.givemoneyMemungkinkan memberi uang (di banyak distribusi setingkat operator).op
economyapi.command.takemoneyMemungkinkan mengambil uang (di banyak distribusi setingkat operator).op
economyapi.command.setmoneyMemungkinkan menetapkan saldo pemain (di banyak distribusi setingkat operator).op
economyapi.command.topmoneyMemungkinkan melihat papan peringkat saldo.tidak disebutkan

⚙️ Instalasi

📥 Penyiapan

  • Unduh build plugin resmi untuk distribusi server Anda (PocketMine/Poggit atau build komunitas Nukkit).
  • Letakkan file plugin yang telah diunduh ke direktori plugins/ server.
  • Hentikan lalu jalankan kembali server (restart) dan periksa output konsol untuk memastikan plugin berhasil dimuat.

(Format paket yang tepat dapat berbeda حسب distribusi dan build; ikuti langkah instalasi dari distribusi yang dipilih.)

🧠 Catatan Teknis

  • EconomyAPI didistribusikan dalam beberapa build/fork untuk ekosistem PocketMine dan Nukkit; build yang berbeda mungkin menyertakan perintah atau titik masuk API yang sedikit berbeda.
  • Plugin ini menyediakan pola akses programatik yang digunakan addon lain (contoh di dokumentasi komunitas menunjukkan pemanggilan seperti EconomyAPI::getInstance() atau EconomyAPI.getInstance().addMoney(...)).
  • Terkadang plugin ini pernah ditandai di kanal distribusi karena masalah performa atau pemeliharaan; pertimbangkan status pemeliharaan terkini dan alternatif yang kompatibel saat menerapkannya di server produksi.

🤝 Kapan Plugin Ini Berguna

Jika server atau ekosistem add-on Anda mengharapkan penyedia ekonomi umum untuk server bergaya Bedrock/PocketMine/Nukkit, EconomyAPI menyediakan API yang banyak digunakan serta serangkaian perintah pemain dasar yang terintegrasi dengan banyak plugin lain.

Server dengan plugin EconomyAPI

Halaman plugin EconomyAPI menampilkan di server mana monitoring menemukan plugin ini, dengan platform dan versi apa ia ditemukan.

Plugin dapat menambahkan perintah, ekonomi, perlindungan, hak akses, mini-game, integrasi, atau mekanik lainnya. Peran sebenarnya dari EconomyAPI bergantung pada konfigurasi server yang bersangkutan.

Data terbentuk otomatis dari respons teknis server. Jika server menyembunyikan daftar plugin, server tersebut mungkin tidak muncul di bagian ini meskipun menggunakan EconomyAPI.

Gunakan daftar server dengan EconomyAPI untuk membandingkan proyek, memeriksa versi yang kompatibel, atau menemukan contoh penggunaan plugin di server publik.