インベントリ入門
注釈：本資料はAI技術を用いて翻訳されています。
インベントリサービスはリクエストに応じて利用可能です。このサービスを環境に統合するには、AccelByte カスタマーサポートポータルからリクエストを開いてください。
はじめに
AccelByte Gaming Services (AGS) インベントリサービスは、略奪、作成、取引、贈答などのさまざまな方法でゲーム中に収集したアイテムを保管し管理する場所をプレイヤーに提供するように設計されています。
プレイヤーがアイテムを柔軟に管理できるようにサポートするだけでなく、インベントリはコマースと連携してアイテムの購入を可能にし、ストアカタログをアイテムメタデータの主要なソースとして統合できるようにします。
インベントリサービスを使用すると、次のことができます。
- プレイヤーがさまざまなスロット容量を持つ複数のストレージを持つことを許可する（例：バックパック、チェスト、ストレージ、バッグなど）
- プレイヤーが次のように自分のアイテムを管理および整理することを許可する：
- インベントリ間でアイテムを移動する
- インベントリ内でアイテムを並べ替えて整理する
主要な概念
インベントリサービスとのシームレスな統合を確実にするために、ドキュメント全体で使用されるサービスの主要な概念を理解することが重要です。
インベントリ設定
インベントリ設定は、ゲームがサポートするインベントリのタイプを決定するために管理者が設定する情報とルールのセットです。
インベントリの管理
このセクションでは、インベントリサービスで実行できるインベントリ管理アクション、つまりアイテムの表示、消費、削除について説明します。
インベントリの表示
プレイヤーが自分のインベントリを表示できるようにすることができます。設定によっては複数のインベントリを持つことができます。
アイテムの消費
アイテムの消費とは、プレイヤーがインベントリからアイテムを使用することを指します。通常、アイテムは一度しか使用できず、その効果は一時的なものです。例えば、ヘルスポーション、マナポーション、食べ物などです。アイテムを消費すると、アイテムの数量が減少します。アイテムの数量が1つしかない場合、消費するとプレイヤーのインベントリからアイテムが削除され、スロットが解放されます。
アイテムの削除
アイテムの削除とは、プレイヤーのインベントリからアイテムを取り出すことを指します。プレイヤーがインベントリからアイテムを削除できるようにすることができますが、これは元に戻すことができません。
インベントリ間でのアイテムの移動
プレイヤーがインベントリ間でアイテムを移動できるようにすることで、ゲームプレイと戦略的な意思決定の体験を向上させることができます。これにより、プレイヤーはアイテムをより効率的に管理できます。
アイテムの取得
サーバーは、プレイヤーのインベントリにアイテムを付与するサーバー権限アクションを実行できます。例えば、サーバーは、モンスターを倒す、略奪するなどのアクションに対してプレイヤーにアイテムを付与できます。
インベントリの付与
インベントリ設定で設定された最大インスタンス数を超えない限り、プレイヤーに新しいインベントリを付与できます。
アイテムのカスタム属性
カスタム属性を使用すると、インベントリ内のアイテムに追加情報を保存できます。追加情報には、customAttributes と serverCustomAttributes の2つのタイプがあります。
カスタム属性
カスタム属性は、プレイヤーとゲームサーバーによって更新できます。これは、プレイヤーがアイテムに関連する追加情報を保存できるようにしたい場合に適しています。保存される属性は通常、ゲームプレイメカニクスに影響を与えないものです。例：アイテムのスタイル/コスメティック。
サーバーカスタム属性
サーバーカスタム属性は、必要な権限を持つゲームサーバーによってのみ変更できます。アイテムの統計修飾子など、ゲームプレイ体験に影響を与える属性を更新できます。この属性は serverCustomAttributes フィールドに保存されます。例えば、追加ダメージ、クリティカル、耐久性などを持つアイテムです。
アイテムタグ
ゲームクライアントとゲームサーバーは、タグ付けとグループ化の目的でアイテムにタグを追加できます。例えば、タイプ、レアリティ、機能、またはその他の関連する基準によってです。タグは事前定義されており、管理者のみが事前定義されたタグを追加または変更できます。アイテムのタグ付けは、サーバーとクライアントの両方の権限アクションをサポートします。
- サーバーは、サーバーからのみアイテムにタグを追加および削除できます。
- クライアントは、サーバーとクライアントの両方からアイテムにタグを追加および削除できます。
スロットと数量
スロットは、プレイヤーのインベントリアイテムを管理するためのより柔軟性を提供します。この機能により、同じアイテムを同じスロットにスタックしたり、複数のスロットに分散したりできます。一方、アイテムの数量は特定のアイテムに関連付けられており、スロットとは異なります。アイテムは1つのスロットを占有し、複数の数量を持つことができます。同じアイテムが複数のスロットを占有し、各スロットで異なる数量を持つこともできます。スロットと数量を活用して、ゲームのユースケースに応じてアイテムを柔軟に保存できます。
次のステップ
管理者ポータル、ゲームクライアント、ゲームサーバーを使用してインベントリ設定とプレイヤーのインベントリを管理する方法を学びます。次の記事を参照してください。