EconomyAPI

EconomyAPI

为你的Hytale服务器提供最佳经济API！让所有模组协同工作❤

图书馆

EconomyAPI预览查看大图

 

EconomyAPI

一个API，支持所有经济系统！

一个轻量级、对开发者友好、用于 Hytale 服务器的经济核心。它会自动挂钩 TheEconomy、EcoTale、HyEssentialsX 和 VaultUnlocked（玩家指南）

EconomyAPI 是一个核心工具，旨在处理货币管理的“繁重工作”。它提供了一个集中式系统来存储、检索和修改玩家余额，让其他模组能够专注于商店、拍卖或领地等功能，而无需担心统一的货币系统。同时，它也充当桥梁，使得使用此API开发的模组也能与其它经济系统协同工作。并且与任何使用 VaultUnlocked 的插件完全兼容！

想要实体货币？

只需安装 SimpleBanker，你就拥有一个完全可自定义的实体货币系统，与此API完美配合！

🎮 对于玩家

就其本身而言，此模组是一个库/依赖项。它不会向游戏世界添加任何物品或方块。你可能需要它是由于你使用的另一个模组（如商店或交易模组）使用它来管理货币。

可用命令：

如果其他经济插件覆盖了这些命令，你仍然可以在命令前使用 /eco、/ecoapi、/economyapi 来使用本插件，或从其他插件禁用这些命令。

命令 描述 权限
/balance (玩家)
/bal		 检查某人的余额 economyapi.user.command.balance
/pay 向某人付款 economyapi.user.command.pay
/baltop 查看服务器上最富有的5位玩家 economyapi.user.command.baltop
/economyapi
/economy
/eco
 查看此模组的致谢 economyapi.user.command.economy
/eco stats 显示服务器经济的一些酷炫统计信息 economyapi.user.command.stats
/eco admin 打开管理员GUI economyapi.admin.command.adminui
/setbalance <玩家> <数量>
/setbal		 将玩家的余额设置为特定值。 economyapi.admin.command.setbalance
/deposit <玩家> <数量>
/addbal
/givebal		 给予玩家金钱 economyapi.admin.command.deposit
/withdraw <玩家> <数量>
/rembal
/takebal		 从玩家处取走金钱 economyapi.admin.command.withdraw
/eco save 强制保存所有数据 economyapi.admin.command.forcesave


你可以通过击杀生物获得金钱。

占位符：

*需要 Placeholdar (PHAR) 或 Placeholder API (PAPI)

%economyapi_balance% --> 获取玩家的原始余额，例如 5257.96
%economyapi_formatted_balance% --> 获取格式化后的余额，例如 $5,257.96
%economyapi_formatted_balance_short% --> 获取简短格式化后的余额，例如 $5.9k
%economyapi_prefix% --> 从配置中获取经济前缀，例如 $
%economyapi_starting_balance% --> 获取默认起始余额（未格式化），例如 500.0
%economyapi_provider% --> 获取当前活动的提供者，例如 Internal、TheEconomy 等
%economyapi_cache_username% --> 获取提供的 UUID 的缓存用户名，例如 sennecoolgames
%economyapi_server_total% --> 显示流通中的金钱总额
%economyapi_server_average% --> 显示玩家平均拥有的金钱数量
%economyapi_server_highest% --> 显示服务器中最高的余额
%economyapi_server_accounts% --> 显示活跃账户的数量
%economyapi_bridge_mode% --> 显示插件正在使用的桥接模式
%economyapi_storage_type% --> 显示服务器当前使用的存储类型
%economyapi_config_mobkill_min% --> 显示击杀生物的最低奖励
%economyapi_config_mobkill_max% --> 显示击杀生物的最高奖励
%economyapi_config_playerkill_min% --> 显示击杀玩家的最低奖励
%economyapi_config_playerkill_max% --> 显示击杀玩家的最高奖励

📦 安装方法

  1. 下载 EconomyAPI.jar 文件。

  2. 将其放入你服务器的 mods 文件夹中。

  3. 重启服务器。

⚙️ 配置

{
  "currencyPrefix": "$",
  "logRetentionDays": 7,
  "startingBalance": 500.0,
  "bridgeMode": "none" // 参见 桥接模式
  "formatType": "US",
  "disableMobKillRewards": false,
  "disablePlayerKillRewards": false,
  "rewards": {
    "mobKillMin": 5.0,
    "mobKillMax": 10.0,
    "playerKillMin": 50.0,
    "playerKillMax": 75.0
  },
  "storageType": "json",
  "mongodb": {
    "uri": "mongodb://localhost:27017",
    "database": "economyapi"
  },
  "mysql": {
    "uri": "mysql://localhost:3306",
    "database": "economyapi",
    "username": "economyuser",
    "password": "economyPassword"
  }
}

桥接模式：

模组会在首次启动时检查桥接提供者。你始终可以在配置中更改它。

💿 使用此API的模组

👨‍💻 对于开发者

别再重复造轮子了！使用 EconomyAPI 作为你服务器货币的唯一权威来源。

为什么要使用这个API？

  • 持久化存储： 自动保存到插件数据文件夹中的 balances.json 文件。
  • 防改名： 使用 Hytale 的 UUID 系统确保即使玩家改名，数据依然有效。
  • 易于访问： 通过我们的API实现简单的集成

如何使用API？

请查看我们的 维基百科

即将推出

  • 商店