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