货币

货币

为你的Hytale服务器创建任意多种货币。

杂项

在您的 Hytale 服务器上创建多种货币,并在玩家之间建立商业系统。

该插件使用 Hibernate 来处理与 MySQL / H2 的连接。

API 方法

该插件包含用于与其他插件集成的 "API" 方法。

  • CurrencyUser:包含所有更新用户余额的方法。
  • Currency:包含所有获取已创建货币信息的方法。
final PlayerRef playerRef = ...;
final String currencyId = ...;

final CurrenciesPlugin currenciesPlugin = CurrenciesPlugin.getInstance();

final CurrencyUser user = currenciesPlugin.getUserCache().find(playerRef.getUuid());
final Currency currency = currenciesPlugin.getCurrencyCache().find(currencyId);

示例配置

插件在初始化时会生成一个 config.json 文件,其中包含创建货币和连接数据库的详细信息。

Currencies (货币) 字段:

  • Id:插件中通用使用的货币 ID。
  • Name:插件消息中显示的名称。
  • Color:插件消息中显示的颜色。
  • DefaultAmount:玩家拥有的该货币的初始余额数量。
  • IsPayEnable:决定玩家是否可以使用支付命令。

Repository (数据库) 字段:

  • Type:连接类型 (h2 或 mysql)。
  • Address:MySQL 连接的地址。
  • Username:MySQL 连接的用户名。
  • Password:MySQL 连接的密码。
  • Database:MySQL 连接的数据库。
  • File:H2 连接的文件路径和名称。
{
  "Currencies": [
    {
      "Id": "coins",
      "Name": "Coins",
      "Color": "#09ff00",
      "DefaultAmount": 100.0,
      "IsPayEnable": true
    },
    {
      "Id": "gold",
      "Name": "Gold",
      "Color": "#FFD700",
      "DefaultAmount": 0.0,
      "IsPayEnable": false
    }
  ],
  "Repository": {
    "Type": "h2",
    "Address": "localhost:3306",
    "Username": "root",
    "Password": "",
    "Database": "test",
    "File": "database/data"
  }
}

命令与权限

  • /{currency-id} [player] - 显示你或某个玩家的余额。
  • /{currency-id} pay {player} {amount} - 向某个玩家发送余额。
  • /{currency-id} top - 显示该货币的玩家排名。
  • /{currency-id} add {player} {amount} - 为某个玩家增加余额 (权限: currencies.commands.add)。
  • /{currency-id} remove {player} {amount} - 扣除某个玩家的余额 (权限: currencies.commands.remove)。
  • /{currency-id} set {player} {amount} - 设置某个玩家的余额 (权限: currencies.commands.set)。

源代码

该插件的源代码可在我的 Github 上获取。