市场

市场

动态定价市场，允许玩家买卖任何物品，并支持管理员修改设置、排行榜，旨在简单易用，让玩家无需帮助即可直接上手。

游戏玩法

市场预览查看大图

🛒 Hytale 市场插件

欢迎使用 Hytale 终极市场插件！本插件以高性能、动态经济与玩家安全为核心设计理念，通过精美的 Hytale 界面为玩家提供一个完全交互式的游戏内市场，玩家可以在这里买卖物品。

插件由模拟的供需经济驱动，能实时响应玩家的交易行为，是生存、角色扮演和经济驱动型服务器的完美补充。

✨ 核心功能

🖥️ 高级交互界面

  • 分类子菜单： 使用创意模式风格的分类（方块、物品、工具等）浏览物品，并支持本地化翻译。
  • 即时搜索： 强大的即时/实时搜索功能，可索引多种语言的翻译包（如德语、法语、日语等），让玩家能用母语进行搜索。
  • 收藏与置顶： 将常用物品置顶，以便快速访问。
  • 价格历史图表： 交互式物品详情页，包含价格历史图表和交易摘要。

📈 动态供需经济

  • 价格漂移： 价格根据每日交易量进行调整。高需求（买入多于卖出）会导致价格上涨，而供过于求（卖出多于买入）则导致价格下跌。
  • 非活跃期衰减： 在服务器交易冷清期间，自动使用衰减机制降低价格漂移幅度，避免恶性通胀。
  • 最低库存下限： 服务器管理员可设置最低库存限制（minimumStock），在新经济周期开始时自动补充关键物品。
  • 硬性价格区间： 为每件物品配置 dynamicBuyMin 和 dynamicBuyMax 约束，将价格控制在合理范围内。

🌳 配方感知定价（价格继承）

  • 父-子链接： 自动根据基础材料的成本推导合成品的买卖价格（例如，木质箱子 继承 木板 的价格）。
  • 自动级联更新： 更新父物品的成本会自动将变化级联到所有子物品，使整个经济体系保持对齐。
  • 多父物品配方： 支持由多种原料组成的物品（例如，4个圆石 + 1个木棍）。

🛡️ 玩家保护与安全回退

  • 交易撤销： 在当前交易周期内可以撤销操作失误。
  • 待交付队列： 如果撤销销售时玩家的背包已满，物品将安全地放入“待返还”队列，并在有空间时自动交付。
  • 回退追回： 撤销购买时如果物品不足，将产生“负债追回”。市场将阻止该玩家继续交易，直到欠款数量被追回或从未来的拾取中扣除。
  • 确认阈值： 玩家可以自定义一个金额阈值——任何超过此阈值的交易都需要手动确认。

🏆 多窗口排行榜与统计

  • 时区对齐追踪器： 基于服务器范围或自定义的时区跟踪收支情况。
  • 排行榜： 分页排行榜，按日、周、月、年和全部时间区间显示收入最高者和支出最高者。

⚡ 高性能与零延迟架构

  • 异步目录加载： 在服务器启动时预热缓存，使输入 /market 指令后即时加载。
  • 防抖异步写入： 玩家的操作会即时修改内存缓存。文件操作会合并并在后台保存，避免服务器卡顿。
  • 可靠的磁盘操作： 文件写入使用原子移动操作（ATOMIC_MOVE），并配合5个滚动备份（.bak.1 到 .bak.5），彻底消除数据库损坏风险。

🎮 玩家指南

指令

  • /market - 打开交互式可视化市场菜单。
    • 需要权限： marketplace.use

核心交易规则

  1. 仅限完好物品出售： 为保护玩家和维护目录品质，只有完好无损、耐久度100%的物品才能出售。修复后耐久上限降低的物品或已损坏的工具将被拒绝。
  2. 批量购买： 界面会根据你当前的背包格数和银行存款自动计算你能够购买的最大组数。
  3. 一键出售全部： 预览并一次性出售背包中所有与当前标签页分类匹配的完好物品。

个性化设置

直接从 UI 配置你的市场设置：

  • 允许/限制背包区域： 切换出售扫描是否检查你的快捷栏、工具槽、背包或护甲槽，避免误售正在使用的装备。
  • 记住筛选与排序： 独立的标志，用于记住每个标签页的搜索文本、滚动位置、分类和排序字段。
  • 订单确认阈值： 设置一个警告价格（例如 $1,000.00）。超过此金额的购买或出售将触发确认对话框。

👑 管理员指南

指令

  • /market admin - 打开可视化管理员仪表盘，用于编辑实时目录。
    • 需要权限： marketplace.admin

管理能力

在管理员仪表盘中，你可以配置单个目录条目：

  • 切换可购买/可出售： 控制是否允许玩家购买或出售该物品。
  • 库存与补充： 手动调整目录库存水平，并定义用于自动补充的 minimumStock 下限。
  • 动态定价配置： 启用/禁用动态定价，并配置特定物品的购买价格区间（dynamicBuyMin / dynamicBuyMax）。
  • 管理父物品： 关联价格父物品，定义父物品乘数，或配置多父物品的材料图。
  • 管理员全局撤销： 撤销服务器上的任何交易，即使玩家当前处于离线状态。缺失的物品会自动标记为负债追回，锁定该玩家的市场访问权限，直至问题解决。

⚙️ 安装与文件结构

本插件需要 Ecotale 来处理玩家银行存款和经济货币。

文件目录

所有数据库文件都位于 <mods 文件夹>/Marketplace/ 目录下：

  • market_db.json - 权威目录列表，包含价格、库存水平、每日追踪数据和历史价格图表。
  • market_settings.json - 全局服务器配置、时区设置和昼夜检查世界。
  • player_market_stats.json - 用于排行榜的滚动玩家统计数据。
  • player_market_transactions.json - 用于交易撤销的个人买卖交易日志。
  • player_market_debt.json - 用于处理未解决撤销的待交付和负债追回队列。
  • player-settings/ - 包含单个玩家 UI 设置 JSON 文件的目录。

📁 技术规格

动态定价公式

在一天轮转时，如果物品被设置为使用动态定价，系统将计算每日价格调整：

  1. 净交易比率： 根据购买与出售物品之间的净差额（dailyBought - dailySold）计算方向。
  2. 库存稀缺/过剩：
    • 稀缺会提高买入价（激励玩家向市场出售）。
    • 过剩会降低买入价（鼓励玩家购买并抑制出售）。
  3. 非活跃期衰减： 如果服务器上所有动态物品均无交易，衰减乘数会抑制任何向上的价格漂移，防止通胀。
  4. 子物品价格级联： 已关联父物品的价格会根据其基础材料和数量权重进行刷新。

健壮的数据库锁定机制

MARKET_TRADE_LOCK (互斥所有交易活动和每日轮转)
  └── MARKET_DB_IO_LOCK (保护 JSON 文件的读写操作)

这种双重锁定架构确保并发购买、库存操作和后台保存永远不会冲突，从而在所有情况下杜绝物品复制漏洞和负库存。