cinemachine

Unity Open MCP — Cinemachine Extension

Skill for AI agents driving the Unity Cinemachine package (com.unity.cinemachine ≥ 3.x) in a Unity project through the unity-open-mcp MCP server.

This domain is reflection-gated and opt-in. Unlike other domain packs, the bridge assembly always compiles — but each tool detects Cinemachine 3.x presence at call time. When 3.x is absent (package missing or Cinemachine 2.x installed), every tool returns a clear install / upgrade error envelope. The tool group is hidden from ListTools until the connected session activates it.

Preconditions

• Unity Editor is open with the target project.
• unity_open_mcp_ping returns connected: true.
• The project has com.unity.cinemachine ≥ 3.x installed. Cinemachine 2.x is not supported — the tools return cinemachine_3x_required when 2.x is detected. If capabilities reports the cinemachine group as compiled in but a tool returns cinemachine_package_required, install the package via the Package Manager.
• The cinemachine tool group is activated — call unity_open_mcp_manage_tools(action="activate", group="cinemachine") before invoking any cinemachine_* tool. Fresh sessions start with two default-on groups (core and gate-and-verify); activate the other groups you need on demand.

Tool prefix

All tools in this pack use unity_open_mcp_cinemachine_*. Mutating tools accept the standard paths_hint (the host's scene path) and run the full gate path; the read-only tool (cinemachine_camera_list) is gate-free.

Vocabulary

A CinemachineCamera (3.x) is the virtual camera component. It composes a camera shot from four pipeline slots:

• Body — position control (e.g. CinemachineFollow, CinemachineFramingTransposer, CinemachineHardLockToTarget).
• Aim — rotation control (e.g. CinemachineRotationComposer, CinemachineHardLookAtTarget).
• Noise — shake / handheld motion (e.g. CinemachineBasicMultiChannelPerlin).
• Lens — field of view, near/far clip, dutch (roll).