Temel konseptler

Sponge Ekonomi API’sının, geliştiricilerin aşina olması gereken birkaç temel bileşeni vardır:

  • Ekonomi Hizmeti

  • Para birimi

  • Hesaplar

  • İşlemler

Ekonomi Servisi

The EconomyService is the basis of the Economy API. It is used to interact via the Economy API, stores an economy’s currencies and provides methods for account management.

Uyarı

Sponge, `` EconomyService`` için varsayılan bir uygulama sağlamıyor. Ekonomi API’sini uygulamak tamamen eklentilere bağlı. Kullanmak istiyorsanız bu hizmeti uygulayan başka bir eklentiye güvenmek zorunda olduğunuz veya kendi kendinize uygulayacağınız anlamına gelir.

Para birimi

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.

Hesaplar

:javadoc:`Account`lar belirli bir oyuncu ya da başka objeler (örneğin: banka, iş, entity) hakkında ekonomi bilgilerini depolamak için kullanılmaktadır. Sponge Economy API’ında iki adet account type’ı bulunmaktadır:

Sanal Hesaplar

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().

Benzersiz Hesaplar

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

İşlemler

İşlemler, bir hesabın bakiyesindeki değişimini gösterir. Şu anda üç tür işlem var:

  • Depozito: Bir hesaba para eklendiğinde gerçekleşir

  • Para Çekme: Bir hesap para birimi çıkarılırsa oluşur

  • Aktarım: Bir hesap başka bir hesapla para alışverişi yaptığı zaman oluşur

Bir aktarım olduğunda, :javadoc: EkonomiTransactionEvent tetiklenir. Bu olayı kullanarak, :javadoc: TransactionResult alabilirsiniz. `` TransactionResult``, gerçekleşen işlemle ilgili verileri depolar; bunlara aşağıdakiler dahildir:

  • Dahil hesap

  • Dahil para birimi

  • İlgili para birimi miktarı

  • İşlem türü

  • İşlemin sonucu

ResultType JavaDocs sayfasında mümkünatı olan bütün işlemleri inceleyebilirsiniz.