HyEconomy

HyEconomy 💰

HyEconomy 是一个为 Hytale 服务器打造的稳健且安全的经济系统插件。

它直接构建于 EcoAPI 标准之上，提供了一套功能完备的金融系统。EcoAPI 作为开发者桥梁，而 HyEconomy 则是处理数据存储、交易逻辑和玩家余额的“银行”。

---

✨ 功能特性

• 稳健存储： 以数据完整性为宗旨，安全管理玩家余额。
• EcoAPI 原生支持： 无缝驱动任何依赖于 EcoAPI 标准的其他插件（如商店、职业、领地系统）。
• 高性能： 经过优化，可处理频繁交易而不会影响服务器性能。
• 完全可配置： 自定义货币名称、符号和初始余额，以适应服务器的主题。

---

⚠️ 前置要求

运行 HyEconomy 前，必须满足以下条件：

1. Hytale 服务器（拥有根目录访问权限）。
2. EcoAPI： 本插件依赖于 EcoAPI 中定义的抽象方法。缺少它将无法加载。

---

📥 安装指南

按照以下简单步骤安装经济系统：

1. 下载

• 下载 HyEconomy 的最新发布版本。
• 下载 EcoAPI 的最新发布版本。

2. 安装

导航至服务器的根目录，找到 mods 文件夹。

📂 路径： ./YourServer/mods/

将 两个 .jar 文件（HyEconomy 和 EcoAPI）拖放到此文件夹中。

3. 重启

重启你的 Hytale 服务器以加载新模组。

# 服务器控制台
> stop

4. 验证

在启动过程中检查服务器控制台。你应该会看到 EcoAPI 先加载，随后 HyEconomy 成功接入该 API。

---

⚙️ 配置

首次重启后，系统会在 ./Server/HyEconomy/ 目录下生成一个配置文件。

常见设置：

• currency：设置你的货币（例如：$、€、Coins）。
• starting：新玩家首次加入时获得的初始金额。

---

🎮 命令

玩家命令

• /balance 或 /bal 或 /money - 查看你当前的钱包余额。
• /pay <玩家名> <金额> - 向其他玩家发送货币。

管理员命令

• /eco add <玩家名> <金额> - 向玩家账户添加资金。
• /eco remove <玩家名> <金额> - 从玩家账户移除资金。
• /eco set <玩家名> <金额> - 强制将玩家余额设置为指定数额。

---

🤝 面向开发者

如果你正在开发一个插件（例如商店或职业系统），请不要直接依赖 HyEconomy。请改为依赖 EcoAPI。HyEconomy 只是在后台运行的实现。