基本概念

作为 Sponge 插件开发者，你应该要熟悉以下几个基本概念：

• 经济服务（EconomyService）
• 货币（Currency）
• 账户（Account）
• 数据操作记录

经济服务

EconomyService 是经济 API 的基础。它用于通过经济 API 进行交互、存储货币、并提供管理帐户的方法。

警告

Sponge 没有提供 EconomyService 的默认实现。也就是说这完全依靠第三方插件来实现经济 API 。这意味着如果你想要使用经济 API ，你需要依赖另一个实现了经济 API 的插件，否则你需要自己实现它。

货币（Currency）

Currency 对象表示一种货币。 Currency 存储了一个显示名称（单数或复数），一个货币符号（如￥或＄等），小数点的位数，以及它是否是默认的交易货币。如果经济插件支持，那么我们可以使用多种货币。

账户（Account）

Account 用于存储一个特定玩家或其他对象（如银行、企业、实体）等的经济数据。在 Sponge 的经济 API 系统中有两种账户类型：

虚拟帐户

虚拟账户绑定到一个特定标识符，这个标识符是一个字符串。虚拟帐户可以绑定到几乎任何东西，但通常用于诸如银行或非玩家的事情。要获取虚拟帐户的 ID ，请使用 getIdentifier() 方法。

唯一账户

唯一账户都绑定到一个 UUID ，通常是玩家的 UUID ，我们通常使用 getUUID() 方法来获取 UUID 。

数据操作记录

交易记录代表一个帐户的收支。有三种类型的交易记录：

• 收入：代表帐户中货币数量的增加
• 支出：代表帐户中货币数量的减少
• 转让：代表帐户中的货币与另一个帐户的货币之间的流动

当交易发生时，经济系统将触发 EconomyTransactionEvent 事件。这一事件提供了 TransactionResult ，而 TransactionResult 储存了交易的相关数据，包括：

• 涉及账户
• 涉及币种
• 涉及金额
• 交易类型
• 交易结果

你可以查看 JavaDoc 页面（ ResultType ）以了解所有可能的交易结果。