EconomySS

EconomySS

SimpleScripting的经济扩展

图书馆

EconomySS — 为 SimpleScripting 打造的经济 API

为你的 JavaScript 服务端模组添加经济系统功能。

EconomySS 是 SimpleScripting 的一个扩展，为你的服务器带来完整的经济发展 API — 让你只需几行 JavaScript 就能构建商店、管理玩家余额以及创建基于经济的游戏玩法。它能自动检测并与流行的经济插件（如 VaultUnlocked）集成，因此设置过程毫不费力。

需要 SimpleScripting。 请先下载 SimpleScripting。

完整文档、指南和教程： wiki.hosttale.com

如有问题或需要帮助，请加入我们的 Discord：Discord

为什么选择 EconomySS？

   
兼容你的经济插件 自动检测 VaultUnlocked、EliteEssentials 及其他提供者 — 无需额外配置。
简洁的 JavaScript API 通过简洁直观的接口查询余额、存款、取款和检查资金。
无需处理线程问题 帮你处理好所有复杂的线程问题 — 你的 JavaScript 代码就像以同步方式运行一样。
多供应商支持 基于 VaultUnlocked 桥接构建，因此你无需更改模组代码即可支持数十种经济插件。
玩家商店示例 附带一个完整的商店系统模组 — 可直接部署或根据你的服务器需求进行定制。
包含类型定义 在你的编辑器中获得经济 API 的自动补全和内联文档。

工作原理

  1. 在 SimpleScripting 和你的经济插件（例如 VaultUnlocked + EconTale）旁边安装 EconomySS。
  2. EconomySS 在启动时自动检测你的经济提供者。
  3. economy 全局变量对所有 JavaScript 模组可用。
  4. 使用简单的 API 调用来管理玩家余额、构建商店以及创建经济驱动的游戏玩法。

你可以构建什么？

经济发展 API 解锁了无限可能：

  • 玩家商店 — 让玩家用货币买卖物品
  • 小费与捐赠 — 玩家可以支付其他玩家或支持服务器
  • 税收与费用 — 对访问区域、命令或服务收费
  • 悬赏与奖励 — 奖励玩家完成任务或赢得活动
  • 拍卖与交易行 — 玩家可以互相出售物品
  • 服务器资源 — 对特殊能力、皮肤或头衔收取货币
  • 经济事件 — 组织带有奖池的比赛或挑战
  • 银行系统 — 让玩家管理账户并设定利率
  • 彩票与赌博 — 举办押注货币的运气游戏
  • 自定义商店 — 将你的模组经济与服务器范围的余额追踪集成

经济提供者

EconomySS 会自动检测并使用你的服务器上最合适的经济提供者，优先级如下：

1. VaultUnlocked（推荐）

一个通用的经济发展 API，可桥接许多经济插件。安装 VaultUnlocked 与任何兼容的经济后端，即可获得最大灵活性。

兼容的经济插件：

  • EconTale
  • TheEconomy
  • DynastyEconomy
  • Coins
  • Maiconomy
  • EcoTale
  • EasyEcon

2. EliteEssentials

直接与 EliteEssentials 的内置经济系统集成。

设置：

  1. 安装 VaultUnlocked 插件（推荐）+ 你选择的经济插件，或者
  2. 安装 EliteEssentials
  3. 安装 EconomySS — 它将自动检测你的提供者

检查服务器启动日志以确认检测成功：

[EconomySS] 经济提供者：VaultUnlocked
[EconomySS] 已连接到经济服务

面向 JavaScript 模组开发者

一旦安装了 EconomySS，economy 全局变量就会自动在你的所有模组中可用，并提供检查余额、存款、取款和验证玩家资金的方法。

附带的 玩家商店 示例模组演示了一个完整、即用的商店系统，包含多种物品、价格配置和余额检查。

有关详细的 API 文档、代码示例和开发指南，请访问 SimpleScripting 维基。

附带的示例

EconomySS 附带了一个即用的 玩家商店 示例模组，你可以为服务器启用或自定义它。

安装要求

  • 安装了 SimpleScripting 插件的 Hytale 专用服务器
  • 经济提供者： 以下之一：
    • VaultUnlocked 插件 + 任何兼容的经济插件（推荐）
    • EliteEssentials
  • Java 25+ JDK（用于从源码构建）

功能一览

  • ✅ 自动提供者检测 — 无需手动配置
  • ✅ 多提供者支持 — 通过 VaultUnlocked 与数十种经济插件兼容
  • ✅ 线程安全操作 — EconomySS 处理线程；你的模组只需使用 API
  • ✅ TypeScript 定义 — 完整的编辑器自动补全和内联文档
  • ✅ 示例模组 — 即用的商店和完整实现
  • ✅ 操作日志 — 服务器日志中清晰的错误信息和提供者状态
  • ✅ 支持热重载 — 无需重启即可更新你的经济模组

依赖

EconomySS 是一个 SimpleScripting 扩展。它要求先安装并加载 SimpleScripting 才能初始化。如果你尚未设置 SimpleScripting，请先从 CurseForge 下载它。

故障排除

经济系统不可用？

  • 确保已安装并运行 VaultUnlocked（或 EliteEssentials）
  • 在服务器日志中检查提供者检测消息
  • 确认 EconomySS 位于 plugins 文件夹中

找不到玩家余额？

  • 确认你的代码中玩家 UUID 是正确的
  • 某些经济插件可能需要额外配置

更多帮助：

SimpleScripting 维基 · 报告问题 · 为 Hytale 模组社区基于 SimpleScripting 构建。