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.