游戏创意与功能

你的下一项功能

礼品码

允许玩家输入并兑换礼品码。

需要玩家会话
Godot
礼品码功能示意图
可见的结果

测试代码成功兑换。重复兑换遵循你的规则。

创建礼品码1:42

此教程以英语播放。

单独打开视频 ↗
视频稍后提供

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

服务器玩家数值

准备同一个项目

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

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

    代码
    WELCOME
    礼品数据(JSON)
    {}
    每用户最大次数
    1

    兑换时由服务器发放最多八种已配置的数值。giftData仍是独立的游戏数据。显示返回的余额,不要在本地再次叠加奖励。

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

实现此功能

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

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

兑换时由服务器发放最多八种已配置的数值。giftData仍是独立的游戏数据。显示返回的余额,不要在本地再次叠加奖励。 此 SDK 示例使用 develop。请检查已安装的 SDK 是否具备所需 API。

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

GDScript
res://scripts/gift_codes.gd
horizOn 调用准备
1# 将此脚本挂到主场景中的某个节点上。
2extends Node
3​
4​
5func _ready() -> void:
6 # 准备:初始化、连接并登录玩家。
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn:验证礼品码并兑换。
21 # Run from one explicit player action; serialize this handler until it completes.
22 var user_id: String = Horizon.auth.getCurrentUser().userId
23 var project: String = Horizon.getConfig().api_key
24 var scope: String = project + "|" + user_id
25 var path: String = "user://gift_pending_" + scope.sha256_text() + ".bin"
26 var pending: Dictionary
27 if FileAccess.file_exists(path):
28 var file := FileAccess.open(path, FileAccess.READ)
29 if file == null: return
30 var saved: Variant = file.get_var(false)
31 file.close()
32 if not HorizonGiftCodes.validIntent(saved, project, user_id): return
33 pending = saved # Invalid/V1 records stay untouched for reconciliation.
34 else:
35 pending = await Horizon.giftCodes.prepareRedemption("WELCOME")
36 if not HorizonGiftCodes.validIntent(pending, project, user_id) or FileAccess.file_exists(path): return
37 var file := FileAccess.open(path, FileAccess.WRITE)
38 if file == null: return
39 file.store_var(pending, false)
40 file.flush()
41 var saved_ok: bool = file.get_error() == OK
42 file.close()
43 if not saved_ok: return
44 var verify := FileAccess.open(path, FileAccess.READ)
45 if verify == null: return
46 var original: Variant = verify.get_var(false)
47 verify.close()
48 if original != pending: return
49 var result: Dictionary = await Horizon.giftCodes.redeemPrepared(pending)
50 if not result.get("success", false): return # Keep all seven original fields for retry.
51 verify = FileAccess.open(path, FileAccess.READ)
52 if verify == null: return
53 original = verify.get_var(false)
54 verify.close()
55 if original == pending: DirAccess.remove_absolute(ProjectSettings.globalize_path(path))
56 if result.get("playerValues") is Dictionary:
57 print(result.playerValues.values) # Current balances, never add grantedValues locally.
58 # Replay has alreadyApplied=true, giftData=null and empty grantedValues/grantedUnlocks.
打开完整SDK示例 ↗

测试你的新功能。

测试代码成功兑换。重复兑换遵循你的规则。

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

接口
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
API 参考中的全部接口
排行榜功能示意图
下一步建议

为每一局添加最高分。

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