大交易所

大交易所

Hytale服务器的玩家经营大交易所:买卖报价自动匹配,离线也能交易。

游戏玩法

Grand Exchange 为你的服务器添加了一个订单簿市场。玩家无需等待买家出现。他们可以发布出售报价(“我以每个 5.00 的价格出售 64 个铁矿石”)或购买报价(“我以每个最高 4.50 的价格购买 100 个铁矿石”)。一旦价格交叉,交易就会自动发生,即使一方或双方玩家离线也是如此。物品和金钱会存放在每位玩家的收取箱中。

一切操作都通过一个看起来像原生 Hytale UI 的游戏内菜单进行。每个操作也都有对应的聊天命令。

**开箱即用:**在单人游戏和没有经济插件的服务器上,Grand Exchange 使用其内置钱包。如果你的服务器运行 VaultUnlocked 并安装了经济插件,它会自动使用该经济系统。

功能

  • 带自动撮合的购买和出售报价。 价格-时间优先意味着最优价格先成交,相同价格下最早的报价先成交。支持部分成交。
  • 玩家离线时也能工作。 撮合不需要任何人在线。在线玩家在其报价成交时会收到聊天消息。
  • 为买家提供公平定价。 交易始终以已经挂出的报价的价格成交。如果你的出价高于最低卖家的要价,你支付较低的价格并拿回差额。
  • 安全的托管。 购买报价会锁定其金钱,出售报价会锁定其物品,直到报价成交或被取消。不会承诺任何实际不存在的东西。
  • 收取箱。 购买的物品、收益和退款会进入收取箱。点击“全部收取”或使用 /ge collect。如果你的背包已满,剩余物品会留在箱子中。
  • 游戏内菜单(/ge),包含四个标签页:
    • 浏览:显示有未成交报价的物品,展示最优卖价、最优买价、最近价格和 24 小时交易量。你也可以浏览游戏中的所有物品。搜索支持按名称或物品 ID 进行。
    • 出售物品:从你的背包中选择一组物品,然后设置数量和单价。有 -10% / -1% / +1% / +10% 按钮,以及最优买价和建议价格。实时预览会显示总额、手续费和你将收到的金额。
    • 我的报价:显示每个报价的进度(已成交 / 总量,花费或赚取的金钱)以及取消按钮,并带有确认步骤。
    • 收取箱:等待你领取的金钱和物品。
  • 可独立运行或与你的经济系统配合使用。 安装后,它会使用任何 VaultUnlocked 经济系统(例如 HyEssentialsX、EcoTale 或 TheEconomy)。否则,它使用内置钱包,每位玩家拥有持久余额和可配置的初始余额。你也可以通过 economy.mode 强制使用其中一种。
  • 卖家手续费(默认 1.5%),从卖家的收益中扣除。手续费会从经济系统中移除,因此它起到货币回收的作用,不会支付给任何人。
  • 无过期时间。 报价会一直保持开放,直到成交或你取消它们。
  • 每位玩家的报价上限(默认 20 个未成交报价)。
  • 只有干净物品可以交易。 损坏、附魔、命名或以其他方式修改的物品会被拒绝,因此物品的每个单位都是相同的。你也可以在配置中屏蔽物品或 ID 前缀。
  • 点击两次即可发布。 每个报价前都有确认步骤。
  • 管理员工具:取消任何报价(剩余部分进入所有者的收取箱)、查看总计、重新加载配置,以及在内置钱包中给予、扣除或设置金钱。
  • 审计追踪:每一笔金钱和物品流动都会写入插件文件夹中的每日交易日志。
  • 崩溃安全存储:每次更改后,数据会以原子写入方式保存到 ge.json。

命令

命令 功能 权限
/ge 打开 Grand Exchange 菜单 所有人
/ge sell <数量> <单价> 为你手中的物品发布出售报价 所有人
/ge buy <物品> <数量> <最高单价> 发布购买报价。金钱会被锁定,直到报价成交或你取消它 所有人
/ge offers 列出你未成交的报价 所有人
/ge collect 从你的收取箱中收取物品和金钱 所有人
/ge price <物品> 显示最优报价、最近交易、24 小时交易量和近期交易 所有人
/ge cancel <id> 取消你的一个报价。剩余部分进入你的收取箱 所有人
/ge balance(别名 bal、money) 显示你的余额和收取箱中的金钱 所有人
/ge help 列出所有命令 所有人
/ge admin cancel <id> 取消任何玩家的报价 grandexchange.admin
/ge admin stats 显示未成交报价、托管、收取箱总计、交易量、已移除手续费和经济提供者 grandexchange.admin
/ge admin reload 重新加载 config.json grandexchange.admin
/ge admin money give|take|set <玩家> <金额> 更改玩家在内置钱包中的余额(仅在使用内置钱包时) grandexchange.admin

默认别名为 /grandexchange 和 /exchange。你可以在配置中更改命令名称和别名。<物品> 接受物品 ID(例如 Ore_Iron)或物品名称(用 _ 代替空格)。

权限

  • grandexchange.admin:管理员子命令,包括钱包命令。所有玩家功能无需权限即可使用。

配置

配置文件位于 mods/MojoTvStream_GrandExchange/config.json,首次启动时创建。

{
  "command": "ge",
  "aliases": ["grandexchange", "exchange"],
  "currencySymbol": "$",
  "feePercent": 1.5,
  "maxOffersPerPlayer": 20,
  "maxAmountPerOffer": 10000000,
  "maxPricePerItem": 1000000000.0,
  "pageSize": 8,
  "notifyOnFill": true,
  "browseAllItems": true,
  "blockedItems": ["Debug_*", "Editor_*", "Template_*", "Test_*"],
  "transactionLog": true,
  "economy": { "mode": "auto", "startingBalance": 100.0 },
  "language": "en-US"
}
  • feePercent:0 到 50。从卖家处扣除并从经济系统中移除。
  • browseAllItems:当为 true 时,浏览有一个“所有物品”筛选器,搜索覆盖游戏中的每个物品。
  • blockedItems:精确的物品 ID,或以 * 结尾的前缀,这些物品永远不能交易。
  • economy.mode:auto(默认)在安装 VaultUnlocked 经济系统时使用它,否则回退到内置钱包。vault 仅使用 VaultUnlocked。builtin 仅使用内置钱包。更改后需要重启。
  • economy.startingBalance:新玩家在内置钱包中获得的余额。
  • currencySymbol:显示在每个金额前面,在菜单和聊天中。
  • language:菜单和聊天中物品名称使用的语言。
  • 对 command 和 aliases 的更改需要重启服务器。其他所有内容都可以通过 /ge admin reload 重新加载。

数据文件:ge.json 保存报价、收取箱和价格历史。wallet.json 保存内置钱包余额。logs/transactions-YYYY-MM-DD.log 保存审计追踪。

要求

  • 一个 Hytale 服务器或单人世界。此版本针对服务器版本 0.7.5 和 Java 25 构建。
  • 不需要其他任何东西。 没有经济插件时,Grand Exchange 使用其内置钱包。
  • 可选:VaultUnlocked 2.19 或更新版本,以及一个向其注册的经济插件。Grand Exchange 随后会使用你服务器现有的余额。

安装

  1. 将 GrandExchange-1.0.0.jar 放入服务器的 mods/ 文件夹,或从游戏内 Mod 浏览器安装。
  2. 可选:添加 VaultUnlocked 和经济插件以使用服务器现有的金钱。
  3. 启动或重启服务器。日志会显示 Grand Exchange v1.0.0 by MojoTvStream 和 economy in use: ...。
  4. 可选:编辑 mods/MojoTvStream_GrandExchange/config.json 并运行 /ge admin reload。

玩家无需安装任何东西。

常见问题

玩家必须在线才能交易吗? 不。报价一旦交叉就会立即撮合,无论所有者是否在线。结果会留在收取箱中。

谁支付手续费? 卖家支付,按每笔销售的百分比计算(默认 1.5%)。它会从经济系统中移除。

报价会过期吗? 不会。它们会一直保留,直到成交或被取消。

为什么我不能出售我的剑? 损坏、附魔、命名或以其他方式修改的物品不能交易,因为交易中的每个单位必须相同。请先修理物品,或直接与其他玩家交易。

我发布购买报价后,我的钱会怎样? 全额(数量 × 最高单价)会立即被锁定。你没有花掉的部分会回到你的收取箱,原因可能是物品成交价更低,或者你取消了报价。

我需要经济插件吗? 不需要。没有经济插件时,Grand Exchange 使用其内置钱包,新玩家以 economy.startingBalance 开始。安装 VaultUnlocked 和经济插件后,它会使用该经济系统(在 auto 模式下)。

我后来添加了经济插件。内置余额会怎样? 经济系统在启动时选择,服务器运行期间不会更改。内置余额会保留在 wallet.json 中,但不会转移到新的经济系统。如果你想控制选择,请明确设置 economy.mode。

我可以重命名 /ge 吗? 可以。在 config.json 中设置 command 和 aliases,然后重启服务器。

致谢

由 MojoTvStream 制作。© 2026 MojoTvStream,保留所有权利。

许可证: 可免费下载并在任何服务器或世界上使用。你不得复制、重新上传、修改、反编译、再分发或出售该插件或其代码,也不得移除作者署名。请参阅 jar 中的 LICENSE.txt。