Godot 安装

本页说明如何把 IGP Godot SDK 加入已有 Godot 项目。常规接入只需要 SDK ZIP 和平台分配的 appId，不需要安装 C#/.NET 或配置游戏可执行文件路径。

安装前确认

• 操作系统为 Windows x86_64。
• 项目使用 Godot 4.7.1、4.4.1 或 3.6.2 中的一个精确版本。
• 已取得当前游戏的正整数 appId。
• 已从 Release Notes 的同一个 Godot SDK 版本、同一个 Godot variant 下载所需文件。

文件	何时下载
igp-godot-sdk-core.zip	必须下载
igp-godot-sdk-compliance.zip	需要实名与防沉迷时下载
igp-godot-sdk-game-kit.zip	需要 Profile、玩家资料、排行榜或分享时下载
igp-godot-sdk-multiplayer.zip	需要 Godot 原生联机、Hosted Session 或 Arena TCP/UDP 时下载
igp-godot-sdk-test.zip	需要完整测试工程时下载；它不是 addon
igp-godot-multiplayer-sample.zip	需要完整联机工程和本地 E2E 时下载；它不是 addon

不要把不同 SDK 版本或不同 Godot variant 的 ZIP 混在同一个项目中。

在编辑器中导入

1. 用与下载 variant 完全一致的 Godot 版本打开项目。
2. 在 Godot 的 AssetLib / Asset Store 面板选择本地 Import，导入 igp-godot-sdk-core.zip。
3. 保持导入目标为项目根目录 res://。预览列表应直接显示 addons/igp_sdk，不能出现 addons/addons/igp_sdk。
4. 完成导入后打开 Project Settings > Plugins，启用 IGP SDK。
5. 按需用同样方式导入 Compliance、GameKit 和 Multiplayer ZIP。可选包不需要再次启用插件。
6. 停止正在运行的游戏并重新启动，让 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 内部。

配置 appId

启用 Core 插件后：

1. 打开 Project Settings > Igp > General。
2. 将 igp/general/app_id 设置为平台分配的正整数。
3. 正式接入保持 igp/general/environment 为 prod；只有明确使用预览或开发环境时才修改。
4. 不要添加运行目录、exe 路径或 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 主版本匹配的原生 multiplayer peer。

安装完成后继续 Godot Quick Start。如果希望先观察完整界面，可直接使用 Godot 测试工程。