Godot インストール

このページでは、既存の Godot プロジェクトへ IGP Godot SDK を追加する手順を説明します。通常の導入に必要なのは SDK ZIP とプラットフォームから発行された appId だけで、C#/.NET やゲーム実行ファイルのパスは不要です。

インストール前の確認

ファイル	ダウンロード条件
`igp-godot-sdk-core.zip`	常に必須
`igp-godot-sdk-compliance.zip`	実名認証とアンチアディクションを使う場合
`igp-godot-sdk-game-kit.zip`	Profile、プレイヤー情報、ランキング、共有を使う場合
`igp-godot-sdk-multiplayer.zip`	Godot ネイティブ multiplayer、Hosted Session、Arena TCP/UDP を使う場合
`igp-godot-sdk-test.zip`	完全なテストプロジェクトを使う場合。addon ではありません
`igp-godot-multiplayer-sample.zip`	完全な multiplayer プロジェクトとローカル E2E を使う場合。addon ではありません

異なる SDK バージョンや Godot variant の ZIP を混在させないでください。

ダウンロードした variant と完全に一致する Godot バージョンでプロジェクトを開きます。
AssetLib / Asset Store パネルでローカル Import を選び、igp-godot-sdk-core.zip を指定します。
インポート先はプロジェクトルート res:// のままにします。プレビューに addons/igp_sdk が直接表示され、addons/addons/igp_sdk になっていないことを確認します。
Project Settings > Plugins で IGP SDK を有効にします。
必要に応じて Compliance、GameKit、Multiplayer ZIP を同じ方法でインポートします。任意パッケージに追加のプラグイン設定はありません。
実行中のゲームを停止して再実行し、IGP Autoload に任意モジュールを再検出させます。

最終パスは次のとおりです。

res://addons/igp_sdk
res://addons/igp_sdk_compliance   # 任意
res://addons/igp_sdk_game_kit     # 任意
res://addons/igp_sdk_multiplayer  # 任意

手動インストールでは各 ZIP を展開し、その addons ディレクトリをプロジェクトルートへ統合します。任意パッケージを addons/igp_sdk の中へコピーしないでください。

Core を有効にした後：

Project Settings > Igp > General を開きます。
igp/general/app_id に IGP から発行された正の整数を設定します。
本番では igp/general/environment を prod のままにします。preview または開発環境を明示的に使う場合だけ変更します。
実行ディレクトリ、実行ファイルパス、pipe の設定は追加しません。通常の導入では使用しません。

プラグインが /root/IGP Autoload を登録します。同名の Autoload を手動で追加しないでください。

Project Settings > Plugins で IGP SDK が有効になっている。
GDExtension / GDNative のロードエラーなしでプロジェクトを起動できる。
/root/IGP が存在し、IGP.achievements、IGP.user、IGP.authorization を利用できる。
Compliance 導入後に IGP.compliance が null ではない。
GameKit 導入後に Profile、Players、Leaderboard、Share モジュールが null ではない。
Multiplayer 導入後に IGP.create_multiplayer_peer() が現在の Godot major version に対応する native peer を返す。

次に Godot Quick Start へ進みます。先に完全な UI を確認する場合は Godot テストプロジェクトを使用します。