游戏创意与功能

你的下一项功能

交易市场

让两名玩家交易同一件原始库存物品。

SDK:develop 分支需要玩家会话
Godot
交易市场功能示意图
可见的结果

买家获得原物品,卖家获得约定价格扣除已配置手续费后的金额。

视频稍后提供

此步骤尚无视频。指南和MCP请求已可使用。

交易市场

准备同一个项目

  1. 在仪表盘中选择与游戏配置相同的项目。

    交易市场 →
  2. 首次请求不需要额外定义。没有对应游戏数据时,空结果也有效。

    请设置货币、手续费和至少一条有效的价格规则。

    使用同一项目中已登录的两名玩家。配置货币、手续费和价格规则,挂售一件未装备的物品,并明确确认购买。

    物品 →玩家数值 →

实现此功能

你可以预览指南。运行需要有效的项目密钥。 准备项目

已安装 SDK、导入项目配置,且玩家已登录。

此 SDK 示例使用 develop。请检查已安装的 SDK 是否具备所需 API。

先通过快速入门连接目标玩家,再通过明确的按钮或场景操作调用read_listing(listing_id)。仅打开文件不会发送请求。

GDScript
res://scripts/marketplace.gd
horizOn 调用
1extends Node
2​
3const MarketStart = preload("res://addons/horizon_sdk/examples/features/marketplace_quickstart.gd")
4# Attach marketplace_example.gd to this screen, set its stable project_id,
5# and use the existing authenticated Horizon session for this project.
6@export var screen: Node
7​
8func read_listing(listing_id: String) -> Dictionary:
9 return await MarketStart.read_one_listing(screen, listing_id)
10​
11# Wire only to explicit Buy confirmation after displaying a successful read.
12func confirm_purchase(listing_id: String) -> Dictionary:
13 return await MarketStart.buy_reviewed_listing(screen, listing_id)
14​
15# Unknown outcome: await screen.retry_pending() or recover_original_operation().
16# Keep the original until Inventory, Values and Marketplace have refreshed.
17# Never delete a pending operation or unknown send-owner lock to buy again.
打开完整SDK示例 ↗

使用两名玩家测试

使用同一项目中已登录的两名玩家。配置货币、手续费和价格规则,挂售一件未装备的物品,并明确确认购买。

使用现有的登录会话。购买结果未确认时,保留并重试同一原始请求,然后刷新库存和余额。

取消后,原始物品仍受到保护,直到所有者领取。仅当前所有者已被删除时才能恢复分配。

挂单和重复操作保护只在项目中存储一次。玩家仅保留引用和有限的状态数据。

测试你的新功能。

买家获得原物品,卖家获得约定价格扣除已配置手续费后的金额。

在仪表盘中选择与游戏配置相同的项目。

接口
  • GET/marketplace/limits
  • GET/marketplace/rules
  • GET/marketplace
  • GET/marketplace/listings
  • GET/marketplace/listings/{listingId}
  • POST/marketplace/listings
  • POST/marketplace/listings/{listingId}/buy
  • POST/marketplace/listings/{listingId}/cancel
  • GET/marketplace/operations/{operationId}
  • POST/marketplace/listings/{listingId}/retry-return
API 参考中的全部接口
排行榜功能示意图
下一步建议

为每一局添加最高分。

每局结束后保存分数并展示领先者。继续使用现有连接和玩家会话。