游戏创意与功能

你的下一项功能

群组

为所选项目提供带角色的公会、战队和团队。

SDK:develop 分支需要玩家会话
Godot
群组功能示意图
可见的结果

超时或冲突后保留原始操作并读取当前状态。切勿自动改用新修订号重试。

视频稍后提供

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

群组

准备同一个项目

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

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

    群组在游戏内创建和管理。

    首个示例只读取数据,不创建群组、对局或对象。空列表也是有效的首次响应。

实现此功能

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

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

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

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

GDScript
res://scripts/groups.gd
horizOn 调用
1extends Node
2​
3# Restore the existing matching player and connect in the Quickstart first.
4# Invoke explicitly from a player action, not from a poll or page loop.
5func read_my_groups() -> void:
6 var user = Horizon.auth.getCurrentUser()
7 if user == null:
8 return
9 var result = await Horizon.groups.getGroups(user.userId)
10 if not result.success:
11 push_warning(result.errorCode)
12 return
13 print("Player revision: ", result.data.revision)
14 for group in result.data.groups:
15 print(group.id, " ", group.myRole, " revision=", group.revision)
16 # result.data.limits contains all current limits; retained groups are not truncated.
17 # getMembers(userId, groupId, "", 1) reads one page. Keep its revision/cursor.
18 # Restart explicitly on a changed revision; optional createdAt is not epoch zero.
19# Full durable mutations: addons/horizon_sdk/examples/features/groups_example.gd.
20# Keep the original revision/requestId; unknown create requires explicit reconciliation.
打开完整SDK示例 ↗

测试你的新功能。

超时或冲突后保留原始操作并读取当前状态。切勿自动改用新修订号重试。

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

接口
  • GET/groups
  • GET/groups/{groupId}
  • GET/groups/{groupId}/members
  • GET/groups/{groupId}/pending
  • POST/groups
  • PUT/groups/{groupId}
  • POST/groups/{groupId}/join
  • POST/groups/{groupId}/request
  • POST/groups/{groupId}/invite
  • POST/groups/{groupId}/accept-invite
  • POST/groups/{groupId}/decline-invite
  • POST/groups/{groupId}/cancel-invite
  • POST/groups/{groupId}/accept-request
  • POST/groups/{groupId}/decline-request
  • POST/groups/{groupId}/cancel-request
  • POST/groups/{groupId}/leave
  • POST/groups/{groupId}/remove
  • POST/groups/{groupId}/role
  • POST/groups/{groupId}/transfer
  • POST/groups/{groupId}/delete
API 参考中的全部接口
排行榜功能示意图
下一步建议

为每一局添加最高分。

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