Konsep Awal

API Ekonomi Sponge memiliki beberapa bagian-bagian dasar yang harus dikenal pengembang:

  • EconomyService

  • Mata uang

  • Akun-akun

  • Transaksi

LayananEkonomi

EconomyService adalah sebagai dasar dari API Ekonomi, Itu digunakan untuk berinteraksi melalui API Ekonomi, menyimpan mata uang ekonomi dan menyediakan metode untuk pengelolaan akun.

Peringatan

Sponge tidak menyediakan pelaksanaan dasar untuk EconomyService. Hal itu tergantung pada plugin secara penuh untuk melaksanakan API Ekonomi. Yang berarti anda harus bergantung pada plugin yang lain yang menjalankan layanan tersebut atau anda harus menjalankannya sendiri, jika anda ingin memanfaatkannya.

Mata uang

The Currency object represents a form of Currency. Currency stores a display name (plural and singular), a symbol, the number of fractional digits, and whether the currency is the default currency for the economy. If the economy plugin chooses, it can support multiple currencies.

Akun-akun

Accountdigunakan untuk menyimpan informasi ekonomi tentang pengguna spesifik atau objek lain (contohnya bank. bisnis, badan usaha). Ada 2 tipe akun didalam API ekonomi Sponge:

Akun Virtual

Akun Virtual dikaitkan kedalam sebuah pengenalan, yang disimpan sebagai String, akun Virtual bisa dikaitkan hampir kedalam apapun, tapi biasanya digunakan untuk sesuatu seperti bank, atau yang bukan pengguna. Untuk mendapatkan id dari akun virtual, gunakan getIdentifier().

Akun yang unik

Akun yang unik dikaitkan kedalam UUID, biasanya seorang pengguna. Untuk mendaptkan UUID dari akun yang unik, gunakan getUUID().

Transaksi

Transaksi melambangkan sebuah perubahan saldo akun. Saat ini ada 3 jenis transaksi:

  • Penyetoran: Terjadi ketika sebuah akun memiliki dana yang ditambahkan kedalamnya

  • Penarikan: Terjadi ketika sebuah akun memiliki dana yang ditarik dari dalamnya

  • Pengiriman: Terjadi ketika sebuah akun bertukar dana dengan akun lainnya

Ketika pengiriman terjadi, :javadoc:`EconomyTransactionEvent`dihentikan. Menggunakan kejadian ini, anda dapat memperoleh :javadoc:`TransactionResult`. TransactionResult menyimpan data tentang transaksi yang terjadi, termasuk:

  • Akun yang terlibat

  • Mata uang yang terlibat

  • Jumlah mata uang yang terlibat

  • Jenis transaksi

  • Hasil dari transaksi

Anda dapat melihat semua kemungkinan hasil transaksi di ResultType laman JavaDocs,.