Podstawowe pojęcia

The Sponge Economy API has a few basic components that developers should be familiar with:

  • EconomyService

  • Waluta

  • Konta

  • Transakcje

EconomyService

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.

Ostrzeżenie

Sponge does not provide a default implementation for the EconomyService. It’s completely up to plugins to implement the Economy API. This means that you have to rely on another plugin which implements the service or you’ll have to implement it yourself, if you want to make use of it.

Waluta

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.

Konta

Accounts are used to store economy information about a specific player or other object (i.e. bank, business, entity). There are two account types in the Sponge Economy API:

Wirtualne Konta

Wirtualne konta są przypięte do identyfikatora, który przechowywany jest jako string. Wirtualne konta mogą być przypięte prawie do wszystkiego, ale zazwyczaj używane są do takich rzeczy jak banki lub obiektów innych niż gracze. Aby uzyskać id od wirtualnego konta, użyj identifier().

Unikalne konta

Unikatowe konta są przypięte do UUID, zazwyczaj gracza. Aby uzyskać UUID unikalnego konta, użyj uniqueId()

Transakcje

Transactions represent an account’s change in balance. There are currently three types of transactions:

  • Deposit: Occurs when an account has funds added to it

  • Wypłata: Występuje, kiedy środki zostają usunięte z konta

  • Transfer: Occurs when an account exchanges funds with another account

When a transfer occurs, the EconomyTransactionEvent is fired. Using this event, you can get the TransactionResult. The TransactionResult stores data about the transaction that occurred, including:

  • Zaangażowane konta

  • Waluta biorąca udział

  • Ilość waluty biorącej udział

  • Typ transakcji

  • Rezultat transakcji

You can view all possible transaction results on the ResultType JavaDocs page.