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

Virtual accounts are tied to an identifier, which is stored as a string. Virtual accounts can be tied to almost anything, but are commonly used for things such as banks, or non-players. To get the id of a virtual account, use identifier().

Akun yang unik

Unique accounts are tied to a UUID, usually a player. To get the UUID of an unique account, use uniqueId().

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,.