HyMarketPlus

HyMarket+ - Hytale 经济与交易系统

该模组目前仍处于测试阶段。如有错误请在此报告。欢迎提出功能建议。

---

💰 货币系统

• 三级货币： 金币、银币、铜币（1g = 100s = 10,000c）
• 自动格式化（例如“5g 25s 50c”）
• 持久的玩家余额存储

🛒 服务器商店

• 管理员配置的商店，包含分类（武器、护甲、材料等）
• 单独的购买和出售价格
• 每件物品的库存可设置有限或无限
• 提供限时优惠
• 商店标签页可100%自定义（名称、顺序）
• 稀有度显示（从普通到传说）

🏪 玩家交易市场

• 玩家可以出售物品给其他玩家
• 每位玩家最多拥有20个活跃挂单
• 可配置的销售税率（默认：5%）
• 挂单在7天后过期（可配置）
• 按价格或日期排序
• 按稀有度筛选

🔨 拍卖行

• 管理员创建拍卖，设置起拍价和持续时间
• 玩家可以实时竞价
• 被超过时自动退款
• 新出价的全服公告
• 拍得的物品自动送达（即使玩家离线）

🎟️ 代金券系统

• 创建带有货币奖励的促销码
• 设置最大兑换次数
• 可选的过期日期
• 每位玩家每个码只能兑换一次
• 代金券可包含物品奖励
• 服务器管理员可以创建“新手礼包”或奖励包

👹 怪物掉落系统

• 击杀怪物可获得货币
• 可针对每种怪物配置：最低铜币数、最高铜币数、掉落几率
• 管理员可以创建怪物分组（例如“低级怪物”、“高级怪物”、“Boss”）并统一配置掉落
• 每个分组可配置：最低铜币数、最高铜币数、掉落几率（%）
• 可以全局启用/禁用

📦 奖励送达系统

• 物品甚至可送达离线玩家
• 当背包满时自动重试

🗣️多语言支持

• 现已支持英语和德语
• 服主可以自行将模组翻译成自己的语言（见下文）

🎮 模组集成

• RPGLevling 模组集成 (www.curseforge.com/hytale/mods/rpg-leveling-and-stats)
  • 与RPGLevling模组集成，支持等级限制的商店物品
• VaultUnlocked 集成
  • HyMarketPlus 现已与 VaultUnlocked 经济系统集成
  • 你的货币余额现在在所有兼容 VaultUnlocked 的模组间共享

---

玩家指令

指令	描述
/balance	查看你的当前余额
/pay	向其他玩家发送货币
/shop	打开服务器商店
/market	打开玩家交易市场
/marketsell	上架一件物品出售
/auction	打开拍卖行
/voucher	兑换一个代金券码
/mplang	更改语言

管理员指令

指令	描述
/admin	打开管理员控制面板
/addcoins	给自己增加1金币（测试用）

管理员控制面板

/admin 面板提供了一个带有标签页的图形界面：

• 经济 - 管理玩家余额，查看统计信息，全局操作
• 商店 - 添加/编辑物品，管理分类
• 市场 - 交易市场设置
• 代金券 - 创建和管理代金券
• 掉落 - 配置怪物掉落率
• 拍卖 - 创建和管理拍卖
• 统计 - 全服经济统计
• 设置 - 插件设置

数据存储

所有数据自动保存到 mods/HyMarketPlus/：

• economy.json - 玩家余额
• shop/ - 商店配置
• market/ - 交易市场挂单
• vouchers.json - 代金券
• auctions.json - 拍卖
• rewards.json - 待发放的奖励
• monster-drops.json - 掉落配置

---

添加新语言

服务器管理员可以轻松添加新语言：

1. 导航到 mods/HyMarketPlus/lang/
2. 复制 en.json 到一个新文件（例如法语用 fr.json）
3. 翻译所有值（保持键不变！）
4. 更新 language.name 和 language.code 条目
5. 重启服务器

示例：法语 (fr.json)

{
  "language": {
    "name": "Français",
    "code": "fr"
  },
  "common": {
    "balance": "Solde: {0}",
    "close": "Fermer",
    "confirm": "Confirmer"
  },
  "shop": {
    "title": "Boutique du Serveur",
    "buy_success": "Achat de {0}x {1} réussi!"
  }
}

翻译提示

• 保持所有 JSON 键与英文文件中的完全一致
• 缺失的翻译将自动回退为英文