游戏创意与功能

你的下一项功能

已验证操作

让服务器验证游戏操作。

SDK:develop 分支需要玩家会话
Godot
已验证操作功能示意图
可见的结果

有效操作被接受,无效操作被拒绝。

验证游戏操作3:12

此教程以英语播放。

单独打开视频 ↗

准备同一个项目

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

    已验证操作 →
  2. 在控制台表单中创建或复用这些测试条目。这些是示例值,并非项目当前数据。

    Key(slug)
    weekly
    只接受已验证游戏局的分数
    true
    最高分
    20000
    最短时长(秒)
    0
    必须提供关卡
    false

    在测试项目中保存这些规则,其他限制留空。固定的quickstart字节仅用于测试请求协议。18250分应被接受。另开一局提交20001分以验证拒绝。实际游戏中应记录真实输入。

    排行榜 →
  3. 运行示例前先保存、重新加载并核对条目。保留其他定义。

实现此功能

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

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

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

保存GDScript并挂到主场景节点,运行后检查Output。

GDScript
res://scripts/validated_actions.gd
horizOn 调用准备
1# 将此脚本挂到主场景中的某个节点上。
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # 准备:初始化、连接并登录玩家。
9 var connected = await Horizon.connect_to_server()
10 if not connected:
11 print("Failed to connect to horizOn server")
12 return
13 if not Horizon.auth.isSignedIn():
14 var signed_in: bool
15 if Horizon.auth.hasCachedAnonymousToken():
16 signed_in = await Horizon.auth.restoreAnonymousSession()
17 else:
18 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
19 if not signed_in:
20 return
21​
22 # horizOn:开始一局,记录输入,提交经过验证的分数。
23 # 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
24​
25 # 2. Round start: single-use ticket plus server seed
26 var run: Dictionary = await Horizon.validatedActions.startRun("weekly")
27 if run.is_empty():
28 print(Horizon.validatedActions.getLastErrorCode()) # e.g. RUN_RATE_LIMITED
29 return
30 var rng := RandomNumberGenerator.new()
31 rng.seed = run["seed"]
32​
33 # Protocol test input only. Replace it with actual recorded game inputs in your game.
34​
35 # 3. Round end: score plus input log (the SDK sends its SHA-256 hash)
36 var result: Dictionary = await Horizon.validatedActions.submitValidated(18250, input_log)
37 if result.is_empty():
38 print(Horizon.validatedActions.getLastErrorCode())
39 return
40 print("Accepted score=", result.get("score"), ", rank=", result.get("rank"))
打开完整SDK示例 ↗

测试你的新功能。

有效操作被接受,无效操作被拒绝。

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

接口
  • POST/validated-actions/runs
  • POST/validated-actions/submit
API 参考中的全部接口
排行榜功能示意图
下一步建议

为每一局添加最高分。

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

教程视频

已验证操作Godot6:05

此教程以英语播放。

单独打开视频 ↗
服务器管理的数值Godot4:58

此教程以英语播放。

单独打开视频 ↗
输入日志Godot5:45

此教程以英语播放。

单独打开视频 ↗