Release Notes
This page lists the currently published engine SDK package versions, download links, and checksums in IGP Developer Docs.
Each version has a fixed download link and matching SHA256SUMS. For production projects, always pin an exact version instead of using latest.
To see the concrete changes in each version, read Changelog.
Current latest versions: Unity 0.2.14, GameMaker 0.0.6.
0.2.14 highlights:
- Rebuilt Unity SDK
0.2.14packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules. - Restored hosted RPC contracts and the Unity/Godot register, unregister, call, and response APIs. Hosted command numbers
12through14,rpc_name, andmodeare active again. - Mirror Transport diagnostics now report the Mirror
logicalChannelseparately from theeffectiveTransport(kcporraw-udp) used for each send, including explicit KCP fallback diagnostics when raw UDP is unavailable. - Hosted KCP adds
KcpHealthStateandKcpLastFaultReason; dead links, fatal socket errors, and hard send-queue overflow close the current data plane, setConnectionFailed, and report throughonError. A bound Mirror Transport clears queued inbound messages and dispatches the corresponding Mirror disconnect callbacks once. - The built-in overlay is now
ShowNetworkDiagnostics/showNetworkDiagnosticsand displays health, the last fault, RTT, queues, and UDP statistics. - KCP applies send backpressure at
WaitSnd >= 1024and adaptively drains UDP bursts beyond the 256-datagram soft budget. - Arena KCP uses MTU 1200 with expanded per-remote UDP/KCP progress diagnostics, while Mirror Transport reliable batching now defaults to 1024 bytes.
- Hosted KCP and raw UDP unreliable now emit structured warnings for latency at or above
200msand traffic at or above1000 datagrams/sor1 MiB/s. - Mirror Transport warns on reliable payloads larger than
16 KiBor expected to fragment, and on inbound queues above4096items or16 MiB. - High-latency, high-traffic, and Mirror payload/queue warnings remain
action=observe-onlyand do not change networking behavior. - The first anomaly is logged immediately, ongoing anomalies are summarized at most once every 30 seconds, and recovered latency/traffic is logged once after five stable seconds.
0.2.13 highlights:
- Published Unity SDK
0.2.13packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules. - Reorganized the main Unity package source into
Core,Platform,Capabilities,Multiplayer,Diagnostics, andInternalcategories without changing public APIs, namespaces, assembly identity, or Unity asset GUIDs. - Unity in-game ready APIs now live on
IGPRuntimeManagerand reuse Arena player state atPlayer.State["gameReady"]; batch queries read the current room snapshot. - Removed the Mirror Transport ready APIs and dedicated KCP
41004ready message path. Game ready state does not control Mirror connections. - Runtime Manager diagnostics now use the shared
IGPLogpipeline, includingInfogame-ready logs underscope=game-ready. - Unity GameKit adds
IGPProfile.GetProfileAsyncto fetch the signed-in user’s complete current profile through desktop session commandGetDesktopUserProfile. - Profile responses include avatar and background selections, avatar-frame render metadata, bio, name-change state, activity time, and pending nickname review state; avatar PNG bytes remain on
GetDesktopUserAvatarAsync.
0.2.12 highlights:
- Published Unity SDK
0.2.12packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules. - Unity Mirror Transport now sends
Channels.Unreliablethrough a raw UDP unreliable lane by default, withUse Raw UDP Unreliable Laneavailable as an opt-out back to the legacy reliable KCP path. - Unity hosted data-plane descriptors now include raw UDP lane fields:
unreliableUdpHost,unreliableUdpPort,unreliableUdpToken,unreliableUdpExpiresAtUnixMs, andunreliableUdpPayloadMaxBytes. - Unity SDK adds the internal UDP client handshake, session-targeted envelopes, negotiated/default
1200byte unreliable packet max, and receive dispatch used by Mirror transport. - Unity GameKit adds desktop-owned Share with text, multi-image binary payloads, and game-defined extension data; desktop session command frames now allow binary
contentBytesup to the raised SDK frame limit.
0.2.11 highlights:
- Published Unity SDK
0.2.11packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules. - Unity
IGPConfig.debugLoggingis now anIGPLogLeveldropdown withOff,Error,Warning,Info, andDebuglevels. Infokeeps lifecycle and staged diagnostics quiet enough for normal debugging; per-message send/receive, frame, payload, ping, and pong logs are reserved forDebug.- Unity Mirror Transport keeps low-frequency
Infosummaries for reliable payloads over 16 KiB or expected to fragment, including direction, peer, original/wire bytes, compression state, and estimated fragments. - Unity RTT HUD diagnostics now show UDP datagram rates, packet totals, and socket byte totals alongside App RTT, KCP
srtt/rto, 1-second Queue averages, and 5-secondQ peakvalues. - The Unity
0.2.11packages were rebuilt so KCP/RTT diagnostics stay observational: heartbeatIsKcpAliveno longer gates P2P/Mirror sends, and readingKcpTransportStatsno longer advances UDP rate sampling.
0.2.10 highlights:
- Published Unity SDK
0.2.10packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules. - Unity Mirror Transport now defaults connection retry attempts to every 60 seconds, connection timeout to 300 seconds, and peer silence timeout to 300 seconds.
- Unity hosted KCP now supports binary envelope v2 for reliable chunk payloads while keeping the JSON/base64 fallback path.
- Unity Mirror transport now logs compression decisions and exposes a separate reliable batch threshold.
0.2.8 highlights:
- Published Unity SDK
0.2.8packages for the main SDK, Mirror transport, Compliance, Lying Bottle, Cloud Archive, and GameKit modules. - Unity network logs now include a per-process
runIdandevent=session-startsummary for startup context. - Unity KCP and P2P diagnostics now use explicit player id fields, add heartbeat timing details, and summarize payload bytes/checksums without full base64 payloads.
0.2.7 highlights:
- Published Unity SDK
0.2.7packages for the main SDK, Mirror transport, Compliance, and GameKit modules. - Unity achievement unlock and progress calls now generate an
eventIdwhen callers omit one. - Unity achievement progress reports now accept optional
progressValueModeforSETversusINCREMENTsemantics.
0.2.6 highlights:
- Published Unity SDK
0.2.6packages for the main SDK, Mirror transport, and Compliance modules. - Unity internal hosted session, KCP, P2P, and hosted realtime logs now share the structured
[IGP SDK]format with timestamp, level, scope, path, and event fields. - Unity KCP receive-drain diagnostics now include payload, payload byte, frame, queue, RTT, and window snapshots in the unified SDK log stream.
- Unity Mirror Transport now compresses payloads from 2 KiB by default before SDK size classification.
0.2.5 highlights:
- Published Unity SDK
0.2.5packages for the main SDK, Mirror transport, and Compliance modules. - Unity hosted KCP now prints structured
[IGP KCP]diagnostics for handshake, send/drop, UDP read, KCP receive, heartbeat RTT, and internal queue/window state. - Unity
IGPKcpClient.DiagnosticsSummarycan be exported by diagnostics tools for readable KCP queue, RTT, and window snapshots.
0.2.4 highlights:
- Published Unity SDK
0.2.4packages for the main SDK, Mirror transport, and Compliance modules. - Unity hosted KCP now emits only
controlanddatatransport channels, matching Arena’s current control/data queue split.
0.2.3 highlights:
- Published Unity SDK
0.2.3packages for the main SDK, Mirror transport, and Compliance modules. - Unity Mirror Transport now exposes
PeerSilenceTimeoutSeconds, defaults peer silence detection to 120 seconds, and refreshes peer activity while large reliable messages are still being reassembled. - Unity Mirror Transport logs now include timestamps when
IGPRuntimeManager.DebugLoggingis enabled.
0.2.2 highlights:
- Published Unity SDK
0.2.2packages for the main SDK, Mirror transport, and Compliance modules. - Unity
IGPNetworkcan now disable retaining incoming packets for polling when an event-only consumer such as Mirror Transport is bound, preventing duplicate receive queues from accumulating the same realtime data. - Unity Mirror Transport now follows
IGPRuntimeManager.DebugLoggingand stays silent when no Runtime Manager is bound.
0.2.1 highlights:
- Unity hosted KCP now clears pending large-payload reassembly state when Arena sends
reliable-message-aborted. - Late chunks for the same aborted
reliableMessageIdare ignored until the reassembly timeout window expires. - Published Unity SDK
0.2.1packages for the main SDK, Mirror transport, and Compliance modules.
After downloading, you can use SHA256SUMS to verify the file:
sha256sum -c SHA256SUMSOn Windows you can also compare hashes with PowerShell:
Get-FileHash -Algorithm SHA256 .\cn.indiegp.sdk.unity-0.2.14.unitypackage
Current versions
Section titled “Current versions”| Version | File | Purpose / when needed | Download |
|---|---|---|---|
0.2.14 | cn.indiegp.sdk.unity-0.2.14.unitypackage | Required core package for every Unity integration. Includes initialization, auth, license validation, achievements, rooms, realtime messages, and state sync. | Download |
0.2.14 | cn.indiegp.sdk.unity.mirror-transport-0.2.14.unitypackage (optional) | Mirror transport adapter. Needed only when the project already uses Mirror and wants Mirror networking to join IGP rooms. | Download |
0.2.14 | cn.indiegp.sdk.unity.compliance-0.2.14.unitypackage (optional) | Real-name and anti-addiction module. Needed only when reading compliance status, age group, or remaining play time. | Download |
0.2.14 | cn.indiegp.sdk.unity.game-kit-0.2.14.unitypackage (optional) | GameKit extension package. Needed only when integrating GameKit features such as leaderboards or share. | Download |
0.2.14 | SHA256SUMS | Checksum file for verifying package integrity. | View |
0.2.6 | cn.indiegp.sdk.unity-0.2.6.unitypackage | Required core package for every Unity integration. Includes initialization, auth, license validation, achievements, rooms, realtime messages, and state sync. | Download |
0.2.6 | cn.indiegp.sdk.unity.mirror-transport-0.2.6.unitypackage (optional) | Mirror transport adapter. Needed only when the project already uses Mirror and wants Mirror networking to join IGP rooms. | Download |
0.2.6 | cn.indiegp.sdk.unity.compliance-0.2.6.unitypackage (optional) | Real-name and anti-addiction module. Needed only when reading compliance status, age group, or remaining play time. | Download |
0.2.6 | cn.indiegp.sdk.unity.game-kit-0.2.6.unitypackage (optional) | GameKit extension package. Needed only when integrating GameKit features such as leaderboards or share. | Download |
0.2.6 | SHA256SUMS | Checksum file for verifying package integrity. | View |
- Installation: see Unity Installation
GameMaker
Section titled “GameMaker”| Version | File | Purpose / when needed | Download |
|---|---|---|---|
0.2.14 | igp-gamemaker-sdk-0.2.14.zip (preview) | GameMaker preview package with the Windows runtime, bridge, and sample project. | Download |
0.2.14 | SHA256SUMS | Checksum file for verifying package integrity. | View |
- Usage: after extracting the zip, open
samples/gamemaker/windows-auth-achievements/project/IGP.WindowsAuthAchievements.yypin GameMaker. See GameMaker Quick Start.
The Godot adapter has not been publicly released yet. See Godot Overview.
Unreal
Section titled “Unreal”The Unreal adapter has not started yet.
Upgrade guidance
Section titled “Upgrade guidance”Suggested upgrade rules while the packages are still in preview:
- Pin versions: record the exact Unity or GameMaker SDK version in use. Do not point to
latest/. - Keep a copy of old packages: back up previous
.unitypackageor.zipfiles before upgrading so rollback stays easy. - Verify the download: run
sha256sum -c SHA256SUMSafter downloading to confirm the file is intact. - Expect breaking changes: preview patch releases may still contain breaking changes. Release notes will call those out when they happen.