Nexus Unity 1.6.0

Highlights

• Bounded UI hierarchy, query, and snapshot traversal with clear truncation behavior.
• Non-blocking WebSocket request handling and persistent MCP authentication across Unity restarts.
• Safer destructive asset operations, type/path resolution, PlayerPrefs handling, and scene dependency scanning.
• Improved editor readiness, test-result reporting, and focus behavior.

Validation

• 43 Python bridge tests passed.
• 11 Unity integration suites / 355 checks passed.
• Live MCP smoke verified 117 raw tools and 14 consolidated manager tools.
• All GitHub Actions checks passed, including documentation quality.

Install

https://github.com/ForkHorizon/NexusUnity.git#v1.6.0

See CHANGELOG.md for the complete list of changes.

Nexus Unity 1.5.0

Nexus Unity 1.5.0

This release promotes the current development line to the public package.

Highlights

• Nexus Unity is now licensed under MIT.
• Local HTTP and WebSocket requests require the per-session auth token.
• Script writes and bulk PlayerPrefs deletion require explicit confirmation.
• Batches are bounded, readiness stays honest through import and Play Mode transitions, and GameObject read-back is richer.
• MCP client setup, bridge resources, path-security checks, test reporting, and cross-platform CLI handling are improved.

See CHANGELOG.md for the complete 1.5.0 change list and migration-relevant details.

Nexus Unity 1.4.2

Added

• Added Python unit coverage for MCP bridge schema shape and type expectations.

Changed

• Expanded the unity_hierarchy_manager MCP schema into per-action shapes with clearer required parameters and aliases.
• Refined Python MCP bridge routing with shared JSON-RPC payload types and more structured handler code.
• Added a repository mailmap entry for air17 so local Git contributor reports resolve historical air17@github.com commits to the GitHub account's canonical no-reply identity.

Fixed

• Removed direct Unity Project Auditor package dependencies and made Unity Project Auditor execution optional, so clean installs avoid duplicate immutable .meta GUID warnings and Could not find any registered modules Console spam.
• Fixed bridge-side compilation wait timeout handling after asset refresh and tightened test-result polling payload handling.

Nexus Unity 1.4.1

Nexus Unity 1.4.1

Patch release focused on package integrity for fresh Unity installs.

Fixed

• Added the missing folder .meta files for docs/, docs/assets/, and Editor/tests, preventing fresh package installs from logging missing-meta warnings and skipping those folders.
• Hardened the pre-push .meta pairing check so it validates the git-tracked tree and requires tracked .meta files for imported folders as well as files.

Documentation

• Finalized 1.4.1 release references in README, DOCUMENTATION, RELEASE, API reference, and changelog.
• Updated release examples to use 1.4.1 and v1.4.1 consistently.

Validation

• Python unit tests passed.
• Static package validation passed.
• Documentation quality AI passed.
• Unity package smoke validation passed.

Nexus Unity 1.4.0

Nexus Unity 1.4.0

Added

• Claude Code integration card that registers nexus-unity in a project-root .mcp.json, using the claude CLI at project scope when available and falling back to writing the file directly.
• Dedicated Python bridge unit tests for routing, compilation/test-result polling helpers, transport config, and JSON-RPC payload construction.
• Python unit tests GitHub Actions job after static validation.
• Maintainer-dispatched external PR replay workflow for trusted trusted/pr-N CI reruns.

Changed

• Python MCP bridge internals now split logging and HTTP transport helpers into nexus_bridge/_logging.py and nexus_bridge/_transport.py.
• Bridge CLI mode now uses argparse, validates key=value arguments, and parses JSON-looking values.
• MCP bridge schemas include clearer per-action descriptions and static resource metadata for resources/list.
• Validate package warns for external fork pull requests and continues the CI pipeline; trusted-branch replay remains available for internal reruns.
• Local static/pre-push validation now runs Python bridge unit tests without generating forbidden bytecode.
• Bridge log level is configurable with NEXUS_UNITY_LOG_LEVEL.

Fixed

• Claude Desktop auto setup on macOS now writes the macOS app config path.
• CLI client detection resolves executables with where on Windows.
• Generated MCP configs resolve Python as python3, then python, then Windows py.
• Invalid NEXUS_UNITY_PORT values are ignored cleanly.

Validation

• PR #36 passed PR target policy, Static validation, Python unit tests, Documentation quality AI, and Unity package smoke.

Nexus Unity 1.3.0

Added

• Integration cards now detect stale project-root MCP bridge deployments and client configs that point at a different Unity project.

Changed

• The Server tab bridge summary now shows the deployed bridge version and flags package/deployed bridge mismatches.
• Integration setup success messages now explicitly tell users to restart the affected MCP client session after redeploying the bridge.

Fixed

• Unity 6.3 editor compilation now works again by guarding Unity 6.4-only EntityId hierarchy event and serialized object-reference APIs behind 6.4+ fallbacks.

Install

https://github.com/ForkHorizon/NexusUnity.git#v1.3.0

Nexus Unity 1.2.0

Nexus Unity 1.2.0 focuses on reliable AI-driven Unity scene building and stronger release validation.

Highlights:

• Adds tolerant MCP manager aliases for common raw-style action names such as list_scenes, create_scene, create_gameobject, rename, and tool-usage diagnostics.
• Expands scene-building manager support for primitive names, parents, transforms, material paths, object rename, transform updates, and create_hierarchy.
• Adds material base color and emission color support for more visible AI-generated scene changes.
• Improves invalid-action errors so agents receive valid action names and can recover deterministically.
• Adds Local-Ollama pull request checklist review through NexusQualityGate --checklist-ai.
• Strengthens CI with package smoke import and generated EditMode smoke tests on the self-hosted Unity runner.

Install pinned release:

https://github.com/ForkHorizon/NexusUnity.git#v1.2.0

Nexus Unity 1.1.2

Nexus Unity 1.1.2 is the superseding clean-install hotfix for the v1.1.x Unity Package Manager install issues.

Fixed

• Moved package-internal NUnit test sources into Unity-ignored Tests~/ so normal user projects do not compile test files during package import.
• Added the required com.unity.inputsystem dependency for input simulation tools that compile against UnityEngine.InputSystem.
• Kept the v1.1.1 runtime assembly definition and tools~/ .meta cleanup fixes.

Updating from v1.1.0 or v1.1.1

Update pinned Git installs to:

https://github.com/ForkHorizon/NexusUnity.git#v1.1.2

If Unity keeps stale import errors, close Unity, delete the old Library/PackageCache/com.forkhorizon.nexus.unity@... folder from the affected project, and reopen the project.

Validation

• GitHub PR checks passed: target policy, static validation, documentation quality AI, Unity EditMode job.
• Clean Unity 6000.4.3f1 temporary project installed the package from the release branch with no C# compile errors and no orphan/immutable .meta warnings.

Nexus Unity 1.1.1 (superseded)

Superseded by Nexus Unity 1.1.2. Use https://github.com/ForkHorizon/NexusUnity.git#v1.1.2 for clean Unity Package Manager installs.

Nexus Unity 1.1.1 fixed the v1.1.0 runtime assembly and tools~/ metadata issues, but v1.1.2 also fixes clean-project test source compilation and declares the required Input System dependency.

Original 1.1.1 notes

Nexus Unity 1.1.1 is a patch hotfix for the v1.1.0 Unity Package Manager install failure.

Fixed

• Added an auto-referenced UnityMCP.Runtime assembly definition so editor code resolves runtime APIs when the package is installed through UPM PackageCache.
• Removed Unity .meta files from the ignored tools~/ validation tooling folder, including the orphan root tools~.meta that caused immutable PackageCache import warnings.
• Hardened local/static validation so .meta files under Unity-ignored ~ folders are rejected before release.

Nexus Unity 1.1.0 (superseded)

Superseded by Nexus Unity 1.1.2. Use https://github.com/ForkHorizon/NexusUnity.git#v1.1.2 for clean Unity Package Manager installs.

v1.1.0 introduced the public validation and integration improvements below, but its package install has known UPM issues fixed by v1.1.2.

Highlights

• Added the public contribution validation gate with deterministic Roslyn documentation checks, file/method size warnings, and local test coverage.
• Added required self-hosted Ollama documentation review for pull requests, including model unload cleanup after each run.
• Rebuilt the main Nexus Unity window around compact Server, Integrations, Resources, and Settings tabs.
• Added integration config generation for Codex, Claude Desktop, Gemini, Antigravity, Cursor, Windsurf, VS Code-compatible clients, and generic MCP JSON clients.
• Added raw agent diagnostics, bridge-side test polling, UI automation diagnostics, window snapshots, and scoped tool usage reset.
• Added Nexus Unity Console logging controls with Important, All, and Custom modes.

Technical package version: 1.1.0. Human-facing release name: 1.1.