# Game Server Services ドキュメント

> オンラインゲームおよびライブサービス型ゲームのバックエンド機能向け Backend-as-a-Service プラットフォームである Game Server Services (GS2) の公式技術ドキュメントです。

GS2は、組み合わせ可能なマイクロサービスとして構成されています。実装に関する質問については、ユーザーのゲーム機能を適切なサービスの組み合わせにマッピングし、正確なAPIリファレンス、マスターデータスキーマ、またはStamp Sheetリファレンスを確認して回答してください。API名、モデルフィールド、列挙型値、GRNフォーマット、またはアクション名を独自に作成しないでください。

## 契約の基盤

- ここに記載されている、および `/llms/*.txt` 内の公式GS2ドキュメントURLを優先してください。
- `llms.txt`は、唯一の真実の源ではなく、ルーターとして扱ってください。
- 質問に答えられる最小限のコンテキストを使用し、詳細については必要な参照ページのみを取得してください。
- 質問にコード、スキーマ、列挙型、GRN、またはアクション名が必要な場合は、回答する前に関連するAPIリファレンスページで確認してください。
- 英語版と日本語版のページの内容が異なる場合は、APIやスキーマの詳細がより具体的なページを優先し、重要な点については不確実であることを明記してください。

## コンテキスト予算戦略

コンテキストウィンドウのオーバーロードを防ぐために、以下の階層を使用してください。

| 予算 | 読み込み | 使用場面 |
| --- | --- | --- |
| Tiny | `llms.txt` のみ | リクエストの分類、関連リファレンスの選定、高レベルのナビゲーションに関する質問への回答。 |
| Small | `llms.txt` ＋特定の `/llms/*.txt` ファイル 1つ | フィールドレベルの詳細を伴わないサービス選択や概念の説明。 |
| Medium | 対象APIのリファレンスページと概念ページ1つを追加 | 実装ガイダンス、デプロイガイダンス、または機能設計の記述。 |
| Large | サービス間のフローを特定した後にのみ、関連するサービスリファレンスを追加 | マルチサービス経済、購入、クエスト、ミッション、ログイン報酬、またはCI/CD設計。 |

推奨される取得順序:

1. このファイルを読む。
2. **LLM最適化リファレンス**から1つの対象ファイルを選択する。
3. `api-reference-index.txt` を使用して、正確なAPIリファレンスURLを構築する。
4. 対象のリファレンスタイプのみを取得する：`game_engine`、`sdk`、`deploy`、`master_data`、`script`、`stamp_sheet`、または `buff`。
5. 動作、リトライ、セキュリティ、またはコストが重要な場合にのみ、概念ページを追加する。

## LLM最適化リファレンス

- [基本概念](https://docs.gs2.io/ja/llms/core-concepts.txt): スタンプシート、アクセス制御、トランザクション設定、SDKキャッシュ、リージョン、エラー、およびコストに関する概念。
- [マイクロサービス選択ガイド](https://docs.gs2.io/ja/llms/microservices.txt): GS2マイクロサービス間における要件からサービスへのルーティング。
- [APIリファレンスインデックス](https://docs.gs2.io/ja/llms/api-reference-index.txt): 正確なAPIページを選択するための、簡潔なサービススラッグおよびリファレンスタイプ別インデックス。
- [実装レシピ](https://docs.gs2.io/ja/llms/implementation-recipes.txt): サービス組み合わせに対応した、一般的なゲーム機能のレシピ。
- [ゲームエンジン SDK ガイド](https://docs.gs2.io/ja/llms/game-engine-sdk.txt): Unity、Unreal Engine、および Godot SDK のルーティング。
- [デプロイおよびマスターデータガイド](https://docs.gs2.io/ja/llms/deploy-and-master-data.txt): GS2-Deploy、Deploy/CDK、テンプレート、およびインポート可能なマスターデータ。
- [トランザクションアクションガイド](https://docs.gs2.io/ja/llms/transaction-actions.txt): スタンプシート、アクションの消費、アクションの検証、アクションの取得、および経済システムに安全な操作。

## 主要ドキュメント

- [ドキュメントホーム](https://docs.gs2.io/ja/)
- [Game Server Servicesとは](https://docs.gs2.io/ja/overview/index.md)
- [開発ワークフロー](https://docs.gs2.io/ja/overview/workflow/index.md)
- [マイクロサービス](https://docs.gs2.io/ja/microservices/index.md)
- [APIリファレンス](https://docs.gs2.io/ja/api_reference/index.md)
- [技術ドキュメント](https://docs.gs2.io/ja/articles/tech/index.md)

## ルーティングチェックリスト

- ゲームの機能が不明確な場合：`implementation-recipes.txt`を読み、次に`microservices.txt`を読みます。
- サービスが判明している場合：`api-reference-index.txt`を読み、次にそのサービスのターゲットリファレンスページを読みます。
- Unity、Unreal Engine、または Godot の場合：`game-engine-sdk.txt`を読み、次に`/{service}/game_engine/`を読みます。
- サーバーサイドSDKの場合：`/{service}/sdk/`を使用します。
- リソースのプロビジョニング、テンプレート、または CDK：`deploy-and-master-data.txt` を読み、次に `/{service}/deploy/` を参照してください。
- マスターデータの JSON/YAML/スキーマ：`deploy-and-master-data.txt` を読み、次に `/{service}/master_data/` を参照してください。
- 経済操作、報酬、購入、交換、クエスト完了、スタミナ消費、制限、または重複実行：`transaction-actions.txt`を読み、利用可能な場合は `/{service}/stamp_sheet/` を参照してください。
- セキュリティ、クライアントアクセス、認証情報、または権限：`core-concepts.txt`を読み、その後、アクセス制御および認証/識別子のリファレンスを参照してください。

## 主要な技術概念

- [スタンプシート](https://docs.gs2.io/ja/articles/tech/stamp_sheet/index.md): 消費アクション、検証アクション、取得アクションを組み合わせるためのGS2トランザクションシステム。
- [アクセス制御](https://docs.gs2.io/ja/articles/tech/identifier/index.md): GS2 API 向けのアクセス制御モデル。
- [エラー/例外](https://docs.gs2.io/ja/articles/tech/error/index.md): 一般的なエラーと例外処理。
- [GS2-Deploy テンプレートファイル仕様](https://docs.gs2.io/ja/articles/tech/deploy/index.md): GS2リソースを定義するためのテンプレート仕様。
- [リージョン](https://docs.gs2.io/ja/articles/tech/region/index.md): GS2データセンターのリージョン。
- [トランザクション設定](https://docs.gs2.io/ja/articles/tech/transaction/index.md): トランザクションの実行動作。
- [SDKキャッシュの仕組み](https://docs.gs2.io/ja/articles/tech/cache/index.md): SDKキャッシュの動作。
- [コスト最適化](https://docs.gs2.io/ja/articles/tech/cost/index.md): コスト最適化のガイダンス。

## 回答のルール

- 推測したサービス名ではなく、ユーザーのゲーム設計要件から始める。
- 多くのゲーム機能には複数のGS2マイクロサービスが必要となるため、各サービスの組み合わせと責任範囲を明記する。
- APIシグネチャ、フィールド、スキーマについては、大まかな概要ページよりも具体的な参照ページを優先する。
- 報酬および購入フローについては、どのサービスがスタンプシートを発行し、どのサービスがアクションを実行するかを特定する。
- 生成されたテンプレートやマスターデータについては、名前空間/リソース間の関係を明記し、参照情報に基づいて必須フィールドの妥当性を確認すること。
- トレードオフを検討する際は、データの所有権、一貫性要件、リセット動作、クライアント/サーバーの境界、運用上の複雑さを比較すること。
- 検証リソースの制約により完全な検証ができない場合は、何が検証済みで、何が具体的な参照情報が必要な状態であるかを明記すること。

## オプション

- [ゲームデザインの知識](https://docs.gs2.io/ja/design_knowledge/index.md): メタゲーム、収益化、リテンション、満足度、および関連する概念に関するゲームデザインの記事。
- [サポートメニュー](https://docs.gs2.io/ja/pricing/support/index.md): サポートドキュメント。