UnityMCPBridge v10.3.0

Runtime UI collections, mapped panels and bounded gameplay input

UnityMCPBridge v10.3.0 ships matching Unity package, Python server and CLI sources,
with 54 built-in MCP tool entrypoints.

Added

• Virtualized UI Toolkit ListView/TreeView addressing by index or item ID,
  read-only logical inspection, explicit reveal and opt-in ancestor expansion.
• Explicit flat-panel coordinates, RenderTexture UV coordinates and
  camera-to-mesh ray mapping, with bounded material/geometry validation and
  collider-based occlusion checks.
• input_play_mode: bounded keys/chords, mouse movement, left/right/middle click,
  drag, wheel, status and operation-ID-guarded cancellation through temporary
  Unity Input System devices. One gesture owns one durable command receipt.
• Matching CLI commands, generated contracts/references, recovery guidance and
  an updated repository README.

Boundaries

Gameplay input requires stable unpaused Play Mode, Dynamic Input System updates,
compatible unpaired actions and idle human input. Pointer gestures require an
unlocked cursor and the application's existing Game View focus policy. No OS
input, legacy input, PlayerInput/InputUser pairing, device-filtered actions,
gamepad, touch, text/IME or automatic rebinding/settings changes are provided.
Physical devices are not driven or reset.

Mapped RenderTexture panels are not native world-space UI Toolkit picking, which
remains unsupported. Collider occlusion does not promise pixel-accurate visibility.
The known shared-server shutdown issue with opted-in batch Editors remains open;
use a dedicated server for isolated live verification.

Verification

• 1,749 local Python tests passed; two environment-dependent tests skipped.
• 141 release/tool tests passed; contracts and generated-reference checks passed.
• Feature verification on Windows, Unity 6000.3.9f1: 39 UI EditMode tests,
  three UI Toolkit PlayMode tests, 20 input EditMode tests and six input PlayMode
  tests passed. Real MCP calls verified virtualized rows, mapped surface clicks,
  ordinary gameplay polling/InputAction edges and cancellation cleanup.
• Mac/Linux gameplay behavior, separately rendered URP mapping and injected
  reload/disconnect/quit faults have not been separately verified.
• Hosted Unity verification is an intentional credential-free skip, not a claim
  that Unity tests ran on GitHub.

Install the matched release

Unity Package Manager → Add package from git URL:

https://github.com/gitgomez/UnityMCPBridge.git?path=/MCPForUnity#v10.3.0

Leave Server Source Override empty for the matching default:

git+https://github.com/gitgomez/UnityMCPBridge.git@v10.3.0#subdirectory=Server

Do not mix this package with the upstream PyPI server. See the
README,
UI limits
and gameplay input/recovery.

UnityMCPBridge v10.2.9

UI Toolkit right-click support

• interact_play_mode(action="click_ui", ui_system="ui_toolkit", button="right", ...) dispatches a right click through normal panel hit-testing and pointer-event propagation.
• CLI: unity-mcp editor click-ui --ui-system ui_toolkit --document RuntimeUI --element-name workspace --button right.
• Omitted/null button remains left. Unsupported buttons/backends and busy pointers are rejected. Interrupted dispatch is explicit and synthetic pressed-button state is released.
• MCP, CLI, Unity handler, contracts, regression coverage, and agent documentation are synchronized. This is bounded runtime UI interaction, not general hardware/Input System input.

Installation

Keep the Unity package and Python server on the same immutable tag:

https://github.com/gitgomez/UnityMCPBridge.git?path=/MCPForUnity#v10.2.9
git+https://github.com/gitgomez/UnityMCPBridge.git@v10.2.9#subdirectory=Server

Verification

• 1,610 local server tests passed, 2 skipped; 141 tool/release tests passed.
• 26 targeted native Unity tests and the real MCP right-click navigation path passed during feature verification on Unity 6000.3.9f1.
• Fresh tagged Unity package import compiled successfully and resolved the release commit; tagged server CLI reports 10.2.9.
• PR and source-release checks passed. Hosted Unity verification remains an explicit non-blocking skip; no Unity credentials are required.

Release PR #4 · Full changelog

UnityMCPBridge v10.2.8

What's Changed

• Release v10.2.8: reliable texture import settings by @gitgomez in #3

Full Changelog: v10.2.7...v10.2.8

UnityMCPBridge v10.2.7

What's Changed

• Preserve noreply identity during release promotion by @gitgomez in #2

Full Changelog: v10.2.6...v10.2.7

UnityMCPBridge v10.2.6

Full Changelog: v10.2.5...v10.2.6

UnityMCPBridge v10.2.5

Full Changelog: v10.2.4...v10.2.5

UnityMCPBridge v10.2.4

Full Changelog: https://github.com/gitgomez/UnityMCPBridge/commits/v10.2.4