Repository navigation
Releases
v1.2.1 - Clearer dashboard limits
Changes
- Show Dashboard request history as History: N/128 retained and request-scoped streaming connections as Active SSE responses: N/16.
- Add tooltips explaining history eviction, the latest-12 display, the full-active-history case and the separate streaming capacity limit.
- No protocol or client migration is required.
Installation
Unity registry: https://i1rr.github.io/unity-MCP, scope i1rr-unity-mcp, package version 1.2.1.
Git URL: https://github.com/i1rr/unity-MCP.git#v1.2.1
The attached archive is signed by Custom Logic. SHA-256:
48fde8d24ef2fd03993112a09816ad832cd247b472f533201041d48ddee84409
Commit: b1550812bc431639eb05e5ba0c389ec99c3116b0.
Validation
- Tested locally on Windows with Unity 6000.6.9f1, Direct3D 11.
- Clean package-only archive installation, Unity signature Valid, 21 focused and 153 full tools.
- Live stateless discovery and tool calls; old protocol versions and session headers rejected.
- 494 Editor tests and 49 Runtime tests passed, with zero failures or skips. No player-build verification or cloud validation was performed for this Dashboard-only patch.
v1.2.0 - Stateless MCP
MCP 1.2.0 requires stateless HTTP protocol 2026-07-28 in the Unity Editor and development players.
Breaking client requirements
The 2025-era initialization/session protocols are removed, including protocol session storage and reload persistence, session capacity/reclaim settings, HTTP DELETE termination, and JSON-RPC wire batches. Older requests and session headers are rejected before tool dispatch with upgrade guidance. The explicit batch_execute tool remains available.
Before connecting with Codex 0.169.0-alpha.11.1, enable modern mode in private project configuration and reconnect:
[features]
mcp_2026_07_28 = trueThis Codex build marks the flag under development. Other clients must support and select 2026-07-28; client product names alone do not establish compatibility. Claude Code was not exercised for this release.
Protocol callbacks now receive immutable request context. String-session callbacks and DeferredResult.SessionId are removed. Explicit test, import, UI and recording handles retain their application lifetimes. Deferred streaming, cancellation and interrupted-operation recovery remain request-scoped.
The Dashboard shows bounded request activity without legacy client sessions. HTTP and UDP discovery advertise only the stateless version. See the client migration instructions.
Local validation
- Exact signed archive: 494 Editor tests and 49 graphical runtime tests passed, zero failures/skips, Windows / Unity 6000.6.9f1 / D3D11.
- Clean package-only installation: version 1.2.0, Unity signature Valid / Custom Logic, 21 focused and 153 full tools. Native Codex modern discovery and old-protocol/session rejection verified.
- Implementation checks also passed: 8 native socket tests, SDK create/read/delete and deferred frame waiting, fresh reconnect, reload/subscription interruption and disconnect cleanup, and IL2CPP development/release builds with live development-player protocol checks. No cloud validation was dispatched.
Distribution
- Signed Unity registry:
https://i1rr.github.io/unity-MCP, scopei1rr-unity-mcp. - Immutable Git dependency:
https://github.com/i1rr/unity-MCP.git#v1.2.0. - Commit:
284f6ed1185f3733594f86894607a81a956afcbe. - Signed archive SHA-256:
792f3bc018f541c1caf7a4fcc584ac8da2269ea1e4b1ea15c3ecb8394aacdbd1.
Existing consumer projects are not upgraded by this publication.
v1.1.3
Remove recurring idle stream/runtime maintenance allocations while preserving request lifetime, quota, concurrency and cleanup behavior.
- Publish immutable stream membership snapshots only when requests open or close.
- Retain first/repeated empty and live tick coverage, callback membership changes, expiry and concurrent rate-limit admissions.
- No protocol, authentication or client migration is required; no tool or security setting changes.
Validated locally on Unity6000.6.9f1/Windows D3D11: exact signed archive passes541 Editor and45 graphical Runtime tests, zero failures/skips. Fresh package-only import reports Unity signature Valid, Custom Logic, and live initialize/get_editor_state plus21 focused/153 full tools. Prior exact-source isolated IL2CPP profiling confirms the maintenance repair; whole-game performance acceptance is a separate consumer task. Other Unity/platform versions were not newly tested. No cloud validation was dispatched.
Primary registry: https://i1rr.github.io/unity-MCP with scope i1rr-unity-mcp.
Git alternative: https://github.com/i1rr/unity-MCP.git#v1.1.3.
Source: 4dd67d302cc3a941d26071b915405e3d224100b6.
Archive SHA-256: dba9be03244eea66f93c2390a632f3bc4dfb084563a28c274008a1bb8fcfc6f3.
v1.1.2 — Non-inheritable native listener handover
1.1.2 completes Windows native listener handover by preventing socket-handle inheritance into Unity child processes.
- Retain 1.1.1's explicit physical-DLL binding and retirement of prior package providers.
- Create listening sockets atomically with WSA_FLAG_NO_HANDLE_INHERIT and clear inheritance on accepted sockets. Children can no longer keep a stopped MCP port bound without an accept thread.
- Rebuild deterministically with MSVC 14.51.36231 / Windows SDK 10.0.26100.0 and retain native provenance. The DLL SHA-256 is efd3d03afd39079e85e38a5ea3f8c66b8335e19bb3f1a5d7fccc0754946663e9.
Verified on Windows / Unity 6000.6.9f1: exact signed archive passes 537 Editor/41 graphical runtime tests with observed Mono cleanup, 8 native socket cases and 6 physical-provider cases. The child-inheritance test fails against the old DLL with WinError10048 and passes against this DLL. Same-process 1.1.1→signed 1.1.2→file→archive and ordinary managed reload preserve port 8287, both legacy sessions, token/preferences, interrupted-request outcome reporting, subscription closure and single cleanup. Clean package-only archive installation and valid Custom Logic signatures pass. Public registry SHA-256/SHA-512 match these signed bytes. The real previous-version Package Manager exposes Update to 1.1.2, and a live registry 1.1.1→1.1.2 consumer retains its original process/port, one intended MCP listener, both legacy sessions and Valid signature. The actual affected consumer also passes repeated signed archive/registry cycles, direct native chat continuity, four focused scene tests and a composited Boot/menu/lobby journey without restarting Unity or changing its client URL. Upstream #14 is closed with the evidence and migration limitation.
Existing handles inherited from older native DLLs cannot be retroactively revoked by an upgrade. A legacy affected Editor may require one-time cleanup of its confirmed idle child workers and an MCP server restart; the actual affected consumer was recovered without restarting Unity. Future listeners created by 1.1.2 do not leak into children. 1.1.1 alone is incomplete for that case; its immutable release notes now record the limitation.
No cloud CI, new development-player build, IL2CPP, other OS/native handover, additional Unity version, hardware or performance claim. Both legacy wire versions remain supported; modern 2026-07-28 clients keep stateless requests. Do not blindly replay interrupted mutations.
Commit: 3a4dfc8
Signed archive SHA-256: 4b2a4fb380fdec123c9f784f404a52993723e9c6c7f6823d4f65dbf58f49a058
Unity signing organization: Custom Logic
Git alternative: https://github.com/i1rr/unity-MCP.git#v1.1.2
Registry: https://i1rr.github.io/unity-MCP (scope only i1rr-unity-mcp)
Tracking: #14
v1.1.1 — Live Windows package upgrade handover
Known limitation found during final consumer acceptance: 1.1.1 retires the old native provider, but older sockets can still be inherited by Unity child processes and keep the retired port bound without an accept thread. The isolated transitions below passed; the real-consumer case is not fixed by 1.1.1 alone. A native inheritance repair is in progress in #14. Published tag/archive are unchanged.
Windows live MCP package upgrades now hand the native listener to the replacement package without restarting Unity.
- Bind the installed package's physical native DLL explicitly, retire prior-path keepers and prefer the existing owned endpoint.
- Keep ordinary same-path managed reloads, legacy sessions, staged outcomes and request cancellation behavior.
- Keep inactive native modules resident safely; do not forcibly unload Unity plugins.
Verified on Windows / Unity 6000.6.9f1: exact signed archive passes 537 Editor and 41 graphical runtime tests with observed Mono cleanup, plus 7 shipped-DLL socket checks and 6 physical-provider migration cases. Same-process file/archive/file/archive transitions and an ordinary managed reload preserve port8170, both legacy sessions, token/preferences, interruption outcomes and single cleanup. The incoming fix also replaces a running1.1.0 provider without restarting. Clean package-only archive installation passes; registry update acceptance follows publication.
No cloud run, new development-player build, IL2CPP, additional Unity version, non-Windows native handover, hardware or performance acceptance is claimed. Runtime bootstrap/transport and the native DLL bytes are unchanged. Downgrading to pre1.1.1 removes the handover fix and requires closing Unity first. An independently occupied old port can still require a new endpoint. Reconnect only after observing the actual responding project/package.
Commit: c5fed41
Signed archive SHA-256: b39aebde04335df13cdfa52f99ce65a7cfeaf89d7d2a605cbeb58e243dd07e0c
Unity signing organization: Custom Logic
Git alternative: https://github.com/i1rr/unity-MCP.git#v1.1.1
Registry: https://i1rr.github.io/unity-MCP (scope only i1rr-unity-mcp)
Tracking: #14
v1.1.0 — Stateless MCP with legacy compatibility
Adds MCP 2026-07-28 stateless HTTP while retaining the existing 2025-03-26 and 2025-11-25 clients and public callback/session APIs.
- Per-request discovery, version/capability metadata, routing-header validation and modern result envelopes.
- Bounded request-scoped SSE, disconnect/timeout cancellation and one-time deferred cleanup. Subscription acknowledgment grants no optional change feed; streams are not resumable.
- Separate modern Dashboard activity and owner cancellation from legacy sessions. Client labels never grant authority.
- Preserve explicit application handles and reject refresh-ID reuse with different import options. Unknown mutation outcomes still require inspection.
Validated on Windows with Unity 6000.6.9f1: the exact signed archive passes 531 Editor tests, 41 graphical runtime tests and 7 native socket tests. Unity reports its signature Valid. A clean package-only install works. A Mono development player passes modern SDK discovery, reads, deferred SSE, subscriptions, cancellation and required authentication, plus both legacy versions. The normal player contains neither the MCP runtime assembly nor its token.
Direct Codex MCP client 0.169.0-alpha.11.1 passes discovery, read, mutation/readback, deferred work and reconnect using legacy 2025-03-26. Official TypeScript client SDK 2.4.0 separately passes those workflows over 2026-07-28 without initialize or session headers. Updating the server does not upgrade a client's selected protocol. Independent Claude Code/Cursor and non-Windows acceptance remain unverified. Cloud CI was not run; these are local results, with no IL2CPP or broad performance/conformance claim.
Known update limitation: #14 tracks stale native keepers when a live Windows UPM change moves the plugin path. Close the Editor before changing the installed package source/cache path, reopen it and reobserve the endpoint. A restart is a workaround, not a hot-update fix. Same-path managed reload behavior is separately verified.
Install through the signed Unity registry at https://i1rr.github.io/unity-MCP, scoped only to i1rr-unity-mcp, or use the immutable Git URL:
https://github.com/i1rr/unity-MCP.git#v1.1.0
Commit: d797e561f24c6771a65e4df3da69989c0dfd41bf
Signed archive SHA-256: f35fcf346c5d107fb6d3c1be667803dbbc0d147b749998df3909723c1eef5450
The package still declares Unity 2022.3 as its minimum; that declaration is not a fresh test result for that Editor version.
v1.0.3
Fix false range rejection when an inspected fractional UI Slider/Scroller endpoint is submitted unchanged.
- Preserve exact floating values and bounds through JSON serialization.
- Read numeric action tokens directly, retaining strict finite/range checks and single-use handles.
- No client migration or change to tool availability/default permissions.
Validated on Unity 6000.6.9f1: the new wire regression fails on the old code and passes after repair. The exact signed archive passes all 488 Editor and 32 runtime tests. A fresh package-only install reports a valid Custom Logic signature, 21 focused/153 full tools, and a live MCP initialize/get_editor_state handshake. Other Unity versions were not newly tested.
Install/update through https://i1rr.github.io/unity-MCP with scope i1rr-unity-mcp.
Git alternative: https://github.com/i1rr/unity-MCP.git#v1.0.3.
Source: 5b3df0d6fe6f9b704d8aba253a9a1539f08cbe7f.
Archive SHA-256: 6f72bf55470226a11561f7b8c09a8b3a4073d511f7ded29c38f30cd0421a6831.
v1.0.2
Install and update through the dedicated Unity registry:
- Registry URL: https://i1rr.github.io/unity-MCP
- Scope:
i1rr-unity-mcp - Existing npm users: change the scoped registry URL, then refresh Package Manager.
- Git installation remains available:
https://github.com/i1rr/unity-MCP.git#v1.0.2.
The registry serves signed GitHub release archives and keeps real Unity dependencies intact. Public npm publishing is retired because Unity dependency IDs collide with unrelated npm packages flagged as malware. See security details.
Arbitrary C# execution remains off by default. Tool descriptions now make clear that time budgets cannot interrupt running code; completed code calls report budget overruns without implying cancellation.
Validated on Unity 6000.6.9f1: 487 Editor tests and 32 PlayMode tests passed. Fresh archive install has a valid Custom Logic signature.
Archive SHA-256: 0c9c1b5a978c53248f92ba998d12eac61e8f7d24a35adb692614041153294c95.
1.0.1
1.0.1
Install
Follow the Unity Package Manager installation steps to use the public npm registry and receive package updates.
Git installation is also available:
https://github.com/i1rr/unity-MCP.git#v1.0.1
Changes
- Publish releases to npm for Unity Package Manager updates.
- Sign the downloadable package with the Custom Logic Unity organization.
- Keep Git installation and the existing package ID.
SHA-256 of the signed archive: ced3086839050ce45b9be7cd1d169fc9055b2bbd2f2863afdabb9da5b695b75e.
License
The i1rr Community License allows commercial development and selling what you build. Selling, hosting or bundling the MCP as a paid offering requires written permission: i1rr.dev@gmail.com.
1.0.0
1.0.0
Install
In Unity Package Manager, choose Install package from Git URL:
https://github.com/i1rr/unity-MCP.git#v1.0.0
Open Tools > i1rr-unity-mcp Dashboard and connect your MCP client to the endpoint in Overview.
Capabilities
- Inspect and edit scenes, objects, components and assets.
- Run tests, inspect gameplay and capture Game View output.
- Create and share project modules.
- Record and read local AI-reported MCP issues.
License
The i1rr Community License allows commercial development and selling what you build. Selling, hosting or bundling the MCP as a paid offering requires written permission: i1rr.dev@gmail.com.