Docs/Tools & Features/Unity Integration

Unity Integration

Dynamo's Unity support comes via the dynamo-unity engine package and its bundled MCP bridge. Once it's connected, the assistant can read your project, drive the Editor, and — unlike most setups — inspect and control your game while it runs in Play Mode.

What you get

  • ●Project awareness — the local context engine indexes your C# types, scenes, prefabs, singletons, and input bindings, so answers come from your project, not a guess.
  • ●Editor control over MCP — load and save scenes, query the hierarchy, read prefabs and scriptable objects, run menu items, trigger builds, and read the console straight from chat.
  • ●Live Play Mode — the bridge keeps its connection open in Play Mode, so the assistant can enter play, inject input, teleport objects, capture and analyze screenshots, snapshot FPS/GC/memory, and assert on live component values.
  • ●Tests & builds — run edit-mode and play-mode tests with structured per-test results; trigger player, Addressables, and AssetBundle builds.

Roughly 70 tools become available in chat when the bridge is connected.

Setup

  1. 1.Install the `dynamo-unity` package in your Unity project (Unity 6+). It bundles the MCP bridge.
  2. 2.Start the bridge from its Editor window so the server is listening.
  3. 3.Register the server in dynamo.yaml (see MCP Tooling for the exact config), then run dynamo from your project — it connects on startup.
  4. 4.For Play Mode control, import the one-time Play Mode Toggle sample from the package's Samples. It exposes the menu items the assistant uses to enter and exit play.

You can also point Dynamo at your project explicitly:

yaml
engines:
  unity:
    project_path: "./MyUnityProject"

Connecting

On launch, Dynamo reports the bridge state — connected (with a tool count), reachable but the Editor isn't responding, or not installed (with an install hint). If you open or restart the Editor after Dynamo is already running, use /connect to reconnect. Use /mcp to see live server state and tool counts.

Try it

Once connected, just ask:

  • ●"Load the MainMenu scene and tell me what's in the canvas."
  • ●"Enter play mode, press the jump button, and screenshot the result."
  • ●"Run the edit-mode tests and summarize the failures."
  • ●"What writes to the PlayerHealth field?"

Extending the bridge

You can add your own project-specific tools to the bridge without forking it — see the dynamo-unity package documentation for the extension attribute and the runtime-check DSL.

Permissions & SecurityGit Integration