unity-cinemachine

Cinemachine Skills

Requirements

• com.unity.cinemachine (≥ 3.1). Recipes target Cinemachine 3 API only (CinemachineCamera, Priority.Value). If the package is missing, install via Unity_PackageManager_ExecuteAction with operation=Add, package=com.unity.cinemachine, version=3.1.6.

Overview

Control Cinemachine virtual cameras, brains, extensions, and blend settings.

Common Mistakes

DO NOT (common hallucinations):

• cinemachine_create does not exist → use cinemachine_create_vcam for virtual cameras
• cinemachine_set_target / cinemachine_set_follow / cinemachine_set_lookat do not exist → use cinemachine_set_targets (sets both Follow and LookAt in one call)
• cinemachine_add_brain does not exist → CinemachineBrain is auto-added to Main Camera
• The runtime type is CinemachineCamera (CM3), not CinemachineVirtualCamera (CM2). Priority reads/writes go through .Priority.Value.

Routing:

• For basic Game Camera operations → use camera module
• For Scene View camera → use camera module's camera_set_transform/camera_look_at
• For camera animation sequences → use timeline module with Cinemachine track

Skills

cinemachine_create_vcam

Create a new Virtual Camera. Parameters:

• name (string): Name of the VCam GameObject.
• folder (string): Parent folder path (default: "Assets/Settings").

cinemachine_inspect_vcam

Deeply inspect a VCam, returning fields and tooltips. Parameters:

• vcamName (string, optional): Name of the VCam GameObject.
• instanceId (int, optional): VCam instance ID.
• path (string, optional): VCam hierarchy path.

cinemachine_set_vcam_property

Set any property on VCam or its pipeline components. Parameters:

• vcamName (string): Name of the VCam.
• instanceId (int, optional): VCam Instance ID.
• path (string, optional): VCam hierarchy path.
• componentType (string): "Main" (VCam itself), "Lens", or Component name (e.g. "OrbitalFollow").
• propertyName (string): Field or property name.
• value (object): New value.
• fov (float, optional): Lens FOV shortcut. When supplied without propertyName, routes to cinemachine_set_lens.
• nearClip (float, optional): Lens near clip shortcut.
• farClip (float, optional): Lens far clip shortcut.
• orthoSize (float, optional): Lens orthographic size shortcut.