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

El objeto Currency representa una forma de Moneda. `` Currency`` almacena un nombre a mostrar (plural y singular), un símbolo, la cantidad de dígitos fraccionarios y si la moneda es la predeterminada para la economía. Si el complemento de economía lo elige, puede admitir varias monedas.

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

Las cuentas virtuales están vinculadas a un identificador, que se almacena como una cadena. Las cuentas virtuales se pueden vincular a casi cualquier cosa, pero se usan comúnmente para cosas como bancos o no jugadores. Para obtener el id de una cuenta virtual, usa `` getIdentifier () ``.

Cuentas únicas

Las cuentas únicas están vinculadas a un UUID, usualmente un jugador. Para obtener el UUID de una cuenta única, usa getUUID().

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.