README.md

June 4, 2026 ยท View on GitHub

Unity AI Cinemachine

MCP OpenUPM Unity Editor r
Discord Stars License Stand With Ukraine

Cinemachine

AI-powered tools for the Unity Cinemachine workflow. Create and configure virtual cameras, set Follow / Look At targets, build the camera pipeline (Body / Aim / Noise / Lens), tune priorities and default blends, and modify any Cinemachine component field directly through natural language commands โ€” no manual inspector navigation. Wraps com.unity.cinemachine 3.1.6. Ideal for rapid camera blocking, cutscene setup, and procedural camera rigs. Built on top of the AI Game Developer platform.

How to use

DOWNLOAD INSTALLER

Stability status

Unity VersionEditmodePlaymodeStandalone
2022.3.62f3rrr
2023.2.22f1rrr
6000.3.1f1rrr

AI Cinemachine Tools

14 tools, grouped by purpose:

Camera lifecycle

  • cinemachine-camera-create - Create a CinemachineCamera GameObject in the active scene
  • cinemachine-camera-list - List all Cinemachine cameras in the scene
  • cinemachine-camera-get - Get a Cinemachine camera's data (priority, lens, pipeline, targets)
  • cinemachine-brain-ensure - Ensure a CinemachineBrain exists on the main/target Unity Camera

Targets & framing

  • cinemachine-set-targets - Set the Follow and/or Look At targets on a camera
  • cinemachine-set-priority - Set a camera's priority (which camera the Brain activates)
  • cinemachine-set-lens - Set lens settings (FOV / focal length, near/far clip, dutch)

Pipeline components

  • cinemachine-set-body - Set the Body (position-control) component (e.g. CinemachineFollow)
  • cinemachine-set-aim - Set the Aim (rotation-control) component (e.g. CinemachineRotationComposer)
  • cinemachine-set-noise - Set the Noise (CinemachineBasicMultiChannelPerlin) component
  • cinemachine-add-extension - Add a Cinemachine extension (e.g. Deoccluder, Confiner)

Blends & generic

  • cinemachine-set-default-blend - Set the Brain's default blend (style + time)
  • cinemachine-get - Generic read: serialize any Cinemachine component on a GameObject
  • cinemachine-modify - Generic write: apply a SerializedMember diff to any Cinemachine component via ReflectorNet (escape hatch for fields not covered by the dedicated tools)

Installation

Option 1 - Installer

  • Download Installer
  • Import installer into Unity project
    • You can double-click on the file - Unity will open it automatically
    • OR: Open Unity Editor first, then click on Assets/Import Package/Custom Package, and choose the file

Option 2 - OpenUPM-CLI

openupm add com.ivanmurzak.unity.mcp.cinemachine