贸易市场

贸易市场

一个基于游戏内玩家间物品交易的Hytale服务器完整市场。

游戏玩法

贸易市场预览查看大图

logo

TradeMarket

一个用于 Hytale 服务器的安全、物品对物品的市场插件。玩家可以创建上架、浏览报价，并通过安全的托管系统进行交易，不涉及真实货币，仅限游戏内物品。

注意： TradeMarket 仍在积极开发中。核心市场功能已可运行，且足够稳定可用于生产环境，但新内容会定期添加。欢迎提交 Bug 报告和反馈。

工作原理

出售

使用 /tm 打开市场，点击 创建上架。选择你想提供的物品，设定你想要的回报（及数量），选择上架持续时间，然后确认。你提供的物品会自动移入托管系统，在服务器端锁定，直到有人购买或上架过期。

购买

同样使用 /tm。浏览可用物品，点击上架查看详情，如果满意即可购买。你将立即获得物品。卖家的付款会存入其仓库。

仓库

/tm vault 打开你的个人仓库。出售所得以及过期/取消上架退回的物品都会存放在这里。随时可以取走物品。它并非用于长期存储，只是一个领取点。

过期

上架会根据你设定的时长自动过期。托管物品会自动退回你的仓库，不会丢失。请记住，你无需在线即可完成交易，你的仓库会处理一切。

功能

当前已实现的功能：

  • 完整的 GUI 市场：浏览所有上架或仅筛选自己的上架
  • 带有分类和搜索功能的物品选择器
  • 收藏物品面板，方便快速访问（玩家和服务器范围）
  • 托管系统：物品在服务器端锁定，直至交易完成或过期（当前版本中，玩家可以取消自己的上架）
  • SQLite 持久化存储，支持自动迁移和备份
  • 可配置间隔的自动保存，空闲数据将从内存中释放
  • 通知系统：登录摘要和交易提醒
  • 管理员命令：查看交易历史、重载配置、手动保存以及创建系统（SYSTEM）上架

计划中的功能：

  • 虚拟货币支持
  • 区域/基于规则的市场区域
  • 拍卖系统（竞价）
  • 针对玩家/组的细粒度权限（仓库大小、同时最大交易数、每日/每周交易限额、物品分类）
  • 整个分类的黑名单/白名单，以及特定物品
  • 用于世界集成的自定义市场方块和 NPC
  • 扩展的管理工具，用于批量操作、交易日志、监控、无限制类型系统（SYSTEM TYPE）上架。

命令

玩家命令

无论你要做什么，都需要先授予 trademarket.use 权限。

命令 功能 权限
/tm 打开市场 trademarket.command.browse
/tm vault 打开你的仓库 trademarket.command.vault

管理员命令

命令 功能 权限
/tm admin reload 重载配置 trademarket.admin.reload
/tm admin save 强制保存数据 trademarket.admin.save
/tm admin systemlisting 创建一个系统（SYSTEM）上架 trademarket.admin.systemlisting
/tm admin history player <player> 查看玩家交易历史 trademarket.admin.history.player
/tm admin history server 查看服务器范围交易历史 trademarket.admin.history.server
/tm admin history listing <id> 查看特定上架历史 trademarket.admin.history.listing
/tm admin history stats <player> 查看玩家交易统计 trademarket.admin.history.stats

GUI 权限

操作 功能 权限
创建上架 在市场 GUI 中创建新上架 trademarket.listing.create
购买上架 从市场 GUI 中购买上架 trademarket.listing.buy

最低配置权限

普通玩家

trademarket.use
trademarket.command.browse
trademarket.command.vault
trademarket.listing.create
trademarket.listing.buy

或使用通配符：

trademarket.use
trademarket.command.*
trademarket.listing.*

管理员

trademarket.*

配置

配置文件位于 {server}/mods/StealthC_TradeMarket/TradeMarket.json。

服务器范围的物品收藏（示例）：

  "ServerFavoriteItems":
[
  "Ingredient_Bar_Gold",
  "Ingredient_Bar_Copper",
  "Ingredient_Bar_Iron"
]

常见问题

我可以在生产环境中使用这个插件吗？ 可以。核心功能稳定，交易安全，数据已持久化。只需在更新前备份 trade-market.db 以确保万无一失，如果出现问题，你也可以回滚。

如果服务器在交易过程中崩溃会发生什么？ 进行中的上架会被回滚。物品不会丢失。系统使用至少一次语义和幂等操作。

它能在单人游戏中工作吗？ 从技术上讲可以，但你会跟自己交易，所以……随你便。

支持货币吗？ 目前仅支持物品对物品。货币功能已列入计划。

本地化

此模组支持 Hytale 的原生语言文件。将很快建立一个 GitHub 仓库以允许社区翻译。支持的语言：

  • 葡萄牙语（巴西）：作者 @StealthC
  • 英语：作者 @StealthC
  • 西班牙语：作者 @laz0rra

支持

详细的 Wiki、Bug 报告、功能请求和一般反馈请在 Discord 服务器上进行：https://discord.gg/uDKpPW5QRx