Ecotale - 经济

Ecotale - Hytale 经济插件

一款为 Hytale 服务器设计的完整经济系统插件，支持持久化存储、可自定义 HUD 和多种语言。

兼容 VaultUnlocked，感谢 creatorfromhell。

Discord 链接

截图

余额 HUD

屏幕上的余额显示，支持智能格式化（K, M, B）

管理员面板

完整的经济管理 GUI，包含仪表盘、玩家、排行、日志和配置选项卡

配置

实时配置编辑，支持多种语言

支付 GUI

玩家对玩家的支付界面

功能

核心经济

• 玩家余额 - 使用 H2/MySQL 数据库持久化存储余额
• 转账 - 玩家对玩家支付，支持可配置手续费
• 管理员控制 - 完整的经济管理 GUI

用户界面

• 余额 HUD - 屏幕上的余额显示，支持智能格式化（K, M, B）
• 管理员面板 - 完整的 GUI，包含仪表盘、玩家、排行、日志、配置选项卡
• 多语言 - 8 种语言：英语、西班牙语、葡萄牙语、法语、德语、俄语、日语、中文

技术特性

• 线程安全 - 每个玩家独立锁定，确保原子操作
• 多种存储选项 - H2（默认）、JSON 或 MySQL，支持共享数据库
• API - 面向其他插件的公共 API，支持速率限制
• 事件 - 余额变更和交易的可取消事件
• 一体化 JAR - 无需额外依赖

---

附属模组

通过以下配套插件扩展 Ecotale：

EcotaleMarketplace

一个完整的玩家驱动型经济市场，为 Hytale 服务器打造。通过用户友好的界面在全球范围内买卖物品。

购买物品

• 全局访问 - 随时随地打开市场。
• 分类物品 - 轻松找到所需物品（武器、工具、材料等）。
• 搜索系统 - 按名称快速搜索特定物品。
• 安全交易 - 如果背包空间不足，购买将失败，不会损失任何金钱。

出售物品

• 背包上架 - 从背包中选择任意有效物品并设定自己的价格。
• 管理 - 查看所有活跃上架，并随时取消以取回物品。
• 销售历史 - 追踪已售物品及收益。

下载 EcotaleMarketplace

---

EcotaleCoins - 实体货币

通过实体硬币物品将虚拟经济转化为可触摸的体验。

功能：

• 6 种硬币面额（铜 → 精金石）
• 怪物掉落实体战利品
• 银行系统，安全存储（/bank）
• 风险与回报：死亡时掉落硬币

下载 EcotaleCoins

EcotaleJobs - 奖励系统

通过游戏活动赚取货币。

功能：

• 采矿奖励，包含矿脉连击系统
• 击杀怪物奖励（所有 NPC 自动分类）
• VIP 倍率（基于权限）
• 反刷怪保护

下载 EcotaleJobs

---

安装

1. 下载 Ecotale-1.0.0.jar
2. 放置到 Hytale 的 mods/ 文件夹中
3. 重启服务器

命令

命令	描述	权限
/balance	查看余额	无（所有玩家）
/pay	打开支付 GUI	无（所有玩家）
/topb	打开余额排行 GUI	无（所有玩家）
/pay 玩家 金额	向其他玩家发送金钱	无（所有玩家）
/eco	打开管理员面板 GUI	ecotale.ecotale.command.eco
/eco give 金额 玩家	给予金钱	ecotale.ecotale.command.eco
/eco take 金额 玩家	扣除金钱	ecotale.ecotale.command.eco
/eco set 金额 玩家	设置余额	ecotale.ecotale.command.eco
/eco reset 玩家	重置为初始余额	ecotale.ecotale.command.eco

权限

权限	描述	默认
ecotale.ecotale.command.bal	访问 /balance 命令	所有玩家
ecotale.ecotale.command.pay	访问 /pay 命令	所有玩家
ecotale.ecotale.command.topb	访问 /topb 命令	所有玩家
ecotale.ecotale.command.eco	访问 /eco 管理员命令	仅管理员

配置

位于 mods/Ecotale_Ecotale/Ecotale.json：

{
  "CurrencySymbol": "$",
  "CurrencyName": "Coins",
  "StartingBalance": 100.0,
  "MaxBalance": 1000000000.0,
  "TransferFee": 0.05,
  "DecimalPlaces": 2,
  "EnableHudDisplay": true,
  "Language": "en-US",
  "StorageProvider": "h2"
}

存储提供商

提供商
h2
json
mysql
mongoDB (未测试)

支持的语言

代码	语言
en-US	英语
es-ES	西班牙语
pt-BR	葡萄牙语
fr-FR	法语
de-DE	德语
ru-RU	俄语
ja-JP	日语
zh-CN	中文

API 使用

import com.ecotale.api.EcotaleAPI;

// 获取余额
double balance = EcotaleAPI.getBalance(playerUuid);

// 存入/取出
EcotaleAPI.deposit(playerUuid, 100.0, "任务奖励");
EcotaleAPI.withdraw(playerUuid, 50.0, "商店购买");

// 转账
EcotaleAPI.transfer(fromUuid, toUuid, 100.0, "交易");

完整 API 文档请参见 docs/API.md。

从 1.0.6 版本开始，许可证变更为“保留所有权利”；早期版本仍以 MIT 许可证存在于 GitHub 上。