Godot Changelog

本页只记录 Godot SDK 各版本的实际变更，不使用 Unity SDK 或精确 Godot 引擎版本号作为发布版本。

Godot 4.7.1、4.4.1 与 3.6.2 是同一个 Godot SDK 版本下的引擎 variants。下载包和支持的精确引擎版本请查看 Release Notes。

0.1.7 - 2026-08-24

• 为所有 Godot variants 新增登录、当前是否可玩、是否已实名和剩余可玩秒数的只读接入属性。
• 新增 IGP.compliance.refresh()，一次刷新现有防沉迷状态并返回三个常用派生值；Desktop 协议未增加字段。

0.1.6 - 2026-08-18

• 从不透明 descriptor 的 expiresAtUnixSeconds 读取 Arena 数据面过期时间，并使用 Unix 秒进行比较。
• descriptor 缺少过期时间或仍使用旧的毫秒值时直接拒绝，不再回退到外层 Hosted Session 时间戳。

0.1.5 - 2026-08-17

• 修正 Godot 3.6.2 Multiplayer 的 NativeScript 参数绑定，避免连接数据面与发送数据包时引用临时 Dictionary 或 PoolByteArray。
• 移除 Godot 3.6.2 NetworkedMultiplayerCustom wrapper 重复发送的连接生命周期信号，由 set_connection_status() 作为唯一信号来源。

0.1.4 - 2026-08-17

• 为 Godot 3.6.2 新增可选原生 Multiplayer 包，通过 NetworkedMultiplayerCustom 接入 Hosted Session、Arena TCP 可靠传输和 UDP 不可靠传输。
• 为共享 Godot 4 peer 新增 Arena 测试上下文直连，并补齐 Godot 4.7.1、4.4.1 与 3.6.2 的完整联机工程。
• 每个精确版本新增独立 igp-godot-multiplayer-sample.zip 附件，包含完整工程目录文档和本地双实例 E2E runner。

0.1.3 - 2026-08-13

• 将 Godot 的实名和公开防沉迷 API 从 Core 迁移到可选 Compliance addon，并移除未发布的 IGP.anti_addiction 与根级 anti_addiction_changed alias。
• 新增 IGP.compliance.real_name、IGP.compliance.anti_addiction、稳定状态去重，以及仅包含 url 和 expires_at 的实名网页会话结构。
• 新增默认开启且文案可配置的 Compliance 全屏输入阻断弹窗，覆盖实名要求和其他全部 BLOCK 状态；不暂停 SceneTree、不轮询、不显示倒计时，也不打开 WebView。
• Godot Core 的公开 current_session 和 desktop_attached payload 不再包含防沉迷状态；底层 Desktop command 与 notification 传输保持不变。

0.1.2 - 2026-08-13

• 将精确 Godot 版本对应的 SDKTest 独立发布为 igp-godot-sdk-test.zip，Core、Compliance 和 GameKit 包不再包含嵌套 Godot 工程。
• 版本化 Godot 接入资料目录由 sample/ 改名为 integration/，并以该名称进入 addon 包。
• 新增 Godot 4.4.1 Windows x86_64 variant，包含匹配的 godot-cpp binding、接入样例、打包流程和 headless smoke 覆盖。
• 将 App ID 和环境配置统一放到 Project Settings 的 Igp > General 下。
• Godot ZIP 改用可移植的正斜杠文件条目，并且不再写入显式目录条目。

0.1.1 - 2026-08-12

• 为 Godot 4.7.1 与 3.6.2 新增原生授权失败兜底窗口，提供 Quit 和 Retry 操作。
• 兜底窗口仅在 Desktop attach 成功、当前进程从未进入 ready 且首次授权失败时显示；运行中的续期失败不会弹窗。
• 默认文案改为同时适用于账号访问权限与网络异常，不再将所有授权失败都描述为网络不可用。

0.1.0 - 2026-08-11

• 首次公开 Godot SDK 预览包，支持 Godot 4.7.1 与 3.6.2、Windows x86_64；两个引擎 variant 共用 Godot SDK 0.1.0 版本。
• 新增必需的原生 Core 包，以及可选的纯 GDScript Compliance 和 GameKit 包；所有包均可直接导入 res://addons。
• 新增 Desktop Session 启动与连接、授权、成就、用户/资料/头像、防沉迷、玩家、排行榜和分享 API。appId 是主要接入配置，不要求填写游戏可执行文件或运行目录。
• 新增连接、授权、防沉迷、离线地图启动、优雅退出和错误等 Godot Core 运行时 signal，并统一在 Godot 主线程交付。
• Godot 4.7.1 使用 C++ GDExtension，Godot 3.6.2 使用 C++ GDNative；接入项目不需要 C#/.NET 或额外 protobuf runtime。
• 为两个支持的 Godot 版本补齐接入指南、包内文档、全模块样例、原生测试、smoke 工程以及按版本隔离的构建、打包和测试工具。
• 0.1.0 只包含 Desktop Session 能力，不包含 Multiplayer、Hosted Session、Realtime、KCP/UDP、Mirror 或 ownership API。