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.