Releases: ForkHorizon/NexusUnity
Nexus Unity 1.4.2
Added
- Added Python unit coverage for MCP bridge schema shape and type expectations.
Changed
- Expanded the
unity_hierarchy_managerMCP 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
air17so local Git contributor reports resolve historicalair17@github.comcommits 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
.metaGUID warnings andCould not find any registered modulesConsole 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
.metafiles fordocs/,docs/assets/, andEditor/tests, preventing fresh package installs from logging missing-meta warnings and skipping those folders. - Hardened the pre-push
.metapairing check so it validates the git-tracked tree and requires tracked.metafiles 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.1andv1.4.1consistently.
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-unityin a project-root.mcp.json, using theclaudeCLI 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 testsGitHub Actions job after static validation.- Maintainer-dispatched external PR replay workflow for trusted
trusted/pr-NCI reruns.
Changed
- Python MCP bridge internals now split logging and HTTP transport helpers into
nexus_bridge/_logging.pyandnexus_bridge/_transport.py. - Bridge CLI mode now uses
argparse, validateskey=valuearguments, and parses JSON-looking values. - MCP bridge schemas include clearer per-action descriptions and static resource metadata for
resources/list. Validate packagewarns 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
whereon Windows. - Generated MCP configs resolve Python as
python3, thenpython, then Windowspy. - Invalid
NEXUS_UNITY_PORTvalues are ignored cleanly.
Validation
- PR #36 passed
PR target policy,Static validation,Python unit tests,Documentation quality AI, andUnity 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
EntityIdhierarchy 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.
Nexus Unity v1.0.0
[1.0.0] - 2026-05-18
Added
- First public open source release for
com.forkhorizon.nexus.unity. - Raw HTTP JSON-RPC API with 111 Unity Editor tools discoverable through
list_tools. - Consolidated MCP bridge API with 14
unity_manager and macro tools for AI clients. - Modular Python bridge package under
nexus_bridge/. unity_write_and_compilemacro for write, wait, and compiler-feedback workflows.- Editor tests for path security, port behavior, manager routing, raw registry consistency, and bridge contract consistency.
- Release-readiness docs:
SECURITY.md,CONTRIBUTING.md, andRELEASE.md. GPL-3.0-onlylicense.
Changed
- Public repository target is
https://github.com/ForkHorizon/NexusUnity.git. - Public documentation now treats Nexus Unity as a standalone open source package.
- The Unity installer deploys both
nexus_unity_bridge.pyand the requirednexus_bridge/module to the project root. - Package version, server version, bridge version, and public docs now use
1.0.0. - Package metadata now includes public repository, documentation, changelog, and license URLs.
Removed
- Removed generated Graphify cache files from the package repo.
- Removed tracked
.jules/,.DS_Store, Python bytecode, and local validation artifacts from public package contents. - Experimental native bridge artifacts are not included in the public release.
Install
Use Unity Package Manager > Add package from git URL:
https://github.com/ForkHorizon/NexusUnity.git#v1.0.0