ゲームのアイデアと機能

次に追加する機能

プレイヤー数値

サーバーが管理する通貨、カウンター、エネルギー。プロジェクトごとに残高、オファー、検証付き変更を定義します。

SDK:developプレイヤーセッションが必要
Godot
プレイヤー数値のイラスト
確認できる結果

ゲームに設定済みの残高とオファーが表示されます。購入すると現在のプレイヤー状態が返されます。

動画は後日公開

この手順の動画はまだありません。ガイドとMCPへの依頼は利用できます。

プレイヤー数値

同じプロジェクトを準備する

  1. ゲームの設定と同じプロジェクトをダッシュボードで選択してください。

    プレイヤー数値 →
  2. ダッシュボードのフォームで次のテスト項目を作成するか、既存の項目を使います。表示値は例であり、現在のプロジェクトのデータではありません。

    数値
    coins: initialBalance=100, maxBalance=1000000; energy: initialBalance=10, maxBalance=100
    直接変更を許可
    false
    オファー
    energy-pack: costs=[{"key":"coins","amount":20}], rewards=[{"key":"energy","amount":5}]

    初期残高はキーごとに1度だけ付与されます。直接変更は初期状態で無効です。Validated Actions のプレイごとの制限は維持され、1日と残高の上限はこの定義に従います。任意の上限を空欄にすると無制限になります。

  3. 実行前に保存、再読み込み、確認を行います。他の定義は保持してください。

この機能を実装する

ガイドは閲覧できます。実行には有効なプロジェクトキーが必要です。 プロジェクトを準備する

SDK をインストールし、プロジェクト設定をインポート済みで、プレイヤーがログインしていること。

この SDK サンプルは develop を使用します。必要な API がインストール済みの SDK にあるか確認してください。

クイックスタートで対象プレイヤーを接続します。ボタンやシーンの明示的な操作からrun_reviewed_action()を呼び出してください。ファイルを開くだけではリクエストは送信されません。

GDScript
res://scripts/player_values.gd
horizOn 呼び出し
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5func run_reviewed_action() -> void:
6 if not Horizon.auth.isSignedIn():
7 return
8 var user_id: String = Horizon.auth.getCurrentUser().userId
9 var current: Dictionary = await Horizon.playerValues.getState(user_id)
10 if not current.success:
11 push_error(current.errorCode)
12 return
13 print(current.state.values)
14 # Authoritative balances only; never add a copied historical reward locally.
15 # Purchases and exact original retry use the official player_values_example.gd
16 # and pending_purchase.gd. Persist the original user/offer/operationId before send.
17 # Keep an uncertain or expired original; do not silently create another ID.
完全なSDKサンプルを開く ↗

新しい機能をテストしましょう。

ゲームに設定済みの残高とオファーが表示されます。購入すると現在のプレイヤー状態が返されます。

ゲームの設定と同じプロジェクトをダッシュボードで選択してください。

エンドポイント
  • GET/player-values
  • GET/player-values/offers
  • POST/player-values/purchase
  • POST/player-values/adjust
API リファレンスのすべてのエンドポイント
リーダーボードのイラスト
次のステップへのおすすめ

毎ラウンドにハイスコアを。

ラウンド終了後にスコアを保存し、上位のプレイヤーを表示します。現在の接続とプレイヤーセッションを引き続き使用します。