Wasim Unity Bridge

This release uses a two-process design:

ChatGPT -> ngrok -> PowerShell companion on 127.0.0.1:38421
                              |
                              v
               Library-based request/response queue
                              |
                              v
                         Unity Editor

The PowerShell companion owns the network socket and ngrok. Unity can recompile and reload every Editor C# assembly without releasing or rebinding the MCP port. The Unity package reconnects by resuming its local queue worker after the reload.

Requirements

• Windows PowerShell 5.1 or newer
• Unity 2022.3 LTS
• ngrok when a public HTTPS endpoint is required
• ChatGPT Developer Mode / custom MCP app

Start

Open Window -> Wasim Development -> Unity MCP Bridge and press Start Companion. The package launches the bundled Companion~/wdmcp-companion.ps1 in a separate PowerShell process. No visible PowerShell window is required.

The companion configuration and logs are stored under:

Library/WasimUnityMcpBridge/Companion/

Domain reload behavior

When any C# script is saved:

1. Unity writes a reloading heartbeat.
2. The companion and ngrok stay running.
3. ChatGPT remains connected to the same MCP endpoint.
4. A tool call during the reload returns a temporary retry message.
5. The new Unity scripting domain resumes queue processing automatically.

Security

The companion listens only on 127.0.0.1 and requires the private capability path. It can call only tools exported by the Unity package. It cannot execute arbitrary commands received from ChatGPT.