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

Sanal hesaplar, dizge halinde saklanan bir tanımlayıcıya bağlıdır. Sanal hesaplar hemen hemen her şeye bağlı olabilir, ancak yaygın olarak bankalar veya oyuncu olmayanlar için kullanılır. Sanal bir hesabın kimliğini almak için, `` getIdentifier () `` kullanın.

Benzersiz Hesaplar

Benzersiz hesaplar, genellikle bir oyuncu olan bir UUID’e bağlıdır. UUID’yi benzersiz bir hesaptan almak için, `` getUUID () `` yı kullanın.

İş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.