Conceptos básicos
La API Economy de Sponge tiene unos pocos componentes básicos con los que los desarrolladores deberían estar familiarizados:
ServicioEconomico
Moneda
Cuentas
Transacciones
El ServicioEconomico
El EconomyService es la base de la API Economy. Es usada para interactuar a través de la API Economy, almacena las monedas de Economy y proporciona los métodos para el manejo de cuentas.
Advertencia
Sponge no proporciona una implementación por defecto para el EconomyService
.
La implementación de la API Economy depende completamente de los complementos. Esto significa que debes confiar en otro complemento que implementa el servicio o tendrás que implementarlo tu mismo, si deseas hacer uso de él.
Moneda
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.
Cuentas
Los Accounts son usados para almacenar información económica sobre un jugador especifico u otro objeto (es decir, banco, negocio, entidad). Hay dos tipos de cuentas en la API Economy de Sponge:
Cuentas virtuales
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()
.
Cuentas únicas
Unique accounts are tied to a UUID, usually a player. To get the UUID of an unique account, use uniqueId()
.
Transacciones
Las transacciones representan los cambios en el balance de una cuenta. Actualmente hay tres tipos de transacciones:
Deposito: Ocurre cuando una cuenta tiene fondos añadidos
Retiro: Ocurre cuando una cuenta tiene fondos retirados
Transferencia: Ocurre cuando una cuenta intercambia fondos con otra cuenta
Cuando ocurre una transferencia, se desencadena el EconomyTransactionEvent. Usando este evento puedes obtener el TransactionResult. El TransactionResult
almacena datos sobre la transacción que ocurrieron, incluyendo:
Cuenta involucrada
Moneda involucrada
Monto de la moneda involucrada
Tipo de transacción
Resultado de la transacción
Puedes ver todos los resultados pusibles de la transaccion en la pagina ResultType JavaDocs.