ゲームのアイデアと機能

次に追加する機能

アイテム

選択したプロジェクトの個別装備、プロパティ、カタログ規則とインベントリを管理します。

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

保存後、カタログにstarter_swordが入ります。確認済みのサンプル購入後、現在のインベントリに固有のinstanceIdが表示されます。

動画は後日公開

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

アイテム

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

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

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

    キー
    starter_sword
    名前
    Quickstart Sword
    種類
    equipment
    レア度
    common
    有効
    true
    基本プロパティ
    {"damage":5}
    プロパティ規則
    []

    アイテムは個別の ID とプロパティを持ちます。数量で扱う資源はプレイヤー値、外見専用の装飾はプレイヤープロフィールに保存します。

    プレイヤー値のガイドでcoinsを準備します。有効なオファーstarter-swordを保存し、コストを10 coins、アイテム報酬を1 starter_swordにします。

    プレイヤー数値 →
  3. 実行前に保存、再読み込み、確認を行います。他の定義は保持してください。

この機能を実装する

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

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

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

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

GDScript
res://scripts/items.gd
horizOn 呼び出し
1extends Node
2​
3# Connect and restore the existing player first. Each function is an explicit action.
4func read_inventory() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.items.getInventory(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 for item in result.data.instances:
13 print(item.instanceId, ": ", item.itemKey)
14 # Keep result.data.revision for a separately reviewed mutation.
15​
16func read_catalog_page() -> void:
17 var user = Horizon.auth.getCurrentUser()
18 if user == null:
19 return
20 var result = await Horizon.items.getCatalog(user.userId, "", 1)
21 if not result.success:
22 push_warning(result.errorCode)
23 return
24 print("Catalog revision: ", result.data.revision)
25 # Explicit Next retains revision and nextAfterKey; no automatic page loop.
26# Durable mutations: addons/horizon_sdk/examples/features/items_example.gd.
27# Preserve original instance/body/revision and the original PV purchase operationId.
28# Initial success may include item references; retained replay may return empty applied/items.
29# Read the current inventory separately; never reconstruct earlier item references.
30# A failed refresh never authorizes another purchase or a local item grant.
完全なSDKサンプルを開く ↗

保存したアイテムを使う

公式サンプルと補助ファイルをインポートします。オファーを確認して、既存プレイヤーで以下の順番を実行します。各手順の完了を待ち、購入確認は1回だけ行います。応答が不明な場合は元のリクエストを保持します。

items_example.gd: load_catalog_page() → review_offer("starter-sword") → purchase_reviewed_offer() → refresh_inventory()

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

保存後、カタログにstarter_swordが入ります。確認済みのサンプル購入後、現在のインベントリに固有のinstanceIdが表示されます。

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

エンドポイント
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
API リファレンスのすべてのエンドポイント
リーダーボードのイラスト
次のステップへのおすすめ

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

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