市场让玩家可以互相出售物品:固定价格挂单、带出价的拍卖和直接交易。 在交易完成之前,服务器会保管物品和付款,并收取你设置的手续费。
玩家看到什么
- 标签页:市场、我的挂单、我的出价、直接交易、待领取的物品和历史记录。
- 按物品分组并显示最低价;同一物品的报价从低到高排列。
- 出售:选择物品、挂单或拍卖、价格、时长和手续费。
- 显示最低下一次出价的出价,以及接受或拒绝直接交易。
市场
12 450
320
市场
我的挂单
领取1
史诗之剑12 个报价
480 起龙之盾拍卖 · 02:14:00
出价
生命药水40 个报价
15 购买
出售物品
31市场、你的挂单和出价、直接交易、待领取的物品和历史记录。
2物品按最低价分组;挂单和拍卖。
3出售:物品、价格、时长;交易由服务器托管并收取手续费。
如何运作
- 只有可交易的物品才能出售,已穿戴的物品永远不能。
- 价格使用后台中设置的、玩家之间可交易的货币。
- 服务器托管并结算每笔交易;手续费在交易时收取。
步骤 01把系统加入项目
告诉 AI 编程助手:“加一个玩家市场”。它会安装现成的系统,包含挂单和拍卖,以及 5% 的手续费。
步骤 02在后台中设置
打开后台,选择你的项目,进入 实时运营 → v2 → 市场。
- 选择玩家交易使用的货币和手续费。
- 设置挂单和拍卖允许的时长和限制。
- 标记哪些物品可以交易。
页面上的 AI 按钮会打开助手:描述你的需求,它会提出修改,你检查后点击保存。
步骤 03测试并发布
在应用的测试版中检查系统。设置通过单独的操作发送到正式应用,请看发布与链接。
开发者须知
市场通过 @idosgames/core 中的 client.marketplace 工作。
// 市场:按最低价分组的物品,然后购买其中一个报价
const market = await client.marketplace.getGroupedOffers()
const res = await client.marketplace.buy(offerID)
if (!res.ok) return showError(res.error)- 出价至少要达到服务器给出的最低下一次出价。
- 已结束的拍卖和退回的物品通过
claimAuction和claimBack领取。
每个字段都在技能 marketplace-system 中有说明,由 SDK 的 MCP 服务器提供。
常见问题
出售期间物品由平台保管吗?
是的。在交易完成之前,服务器会托管物品和付款。
我可以收取手续费吗?
可以。手续费是市场设置的一部分,每笔交易都会收取。