Overview
Cinemachine is Unity’s package for procedural and editor-driven camera behaviour. It is designed to reduce the amount of low-level camera code teams write by providing ready-made tools for follow cameras, framing, blending, noise, impulse, and cinematic composition. (Unity Documentation, Cinemachine, see source-cinemachine)
Setup
Typical use (Cinemachine 3, the version used with Unity 6):
- Install Cinemachine through the Package Manager.
- Create a camera with GameObject > Cinemachine > Cinemachine Camera. Check that the main camera has a Cinemachine Brain component; the Cinemachine manual’s setup steps tell you to verify this, so add one if it is missing.
- Set the Tracking Target on the Cinemachine Camera component.
- Choose behaviours: set Position Control (for example Follow, Position Composer, Orbital Follow or Third Person Follow) and Rotation Control (for example Rotation Composer or Pan Tilt). Unity adds the matching component, such as Cinemachine Follow or Cinemachine Rotation Composer (Unity Technologies, Cinemachine 3.1 manual: Add procedural behavior to a Cinemachine Camera).
- Tune framing, dead zones, damping and noise in the Inspector.
Cinemachine 2 vs Cinemachine 3
Many tutorials and older pages were written for Cinemachine 2, which used virtual cameras with Body and Aim sections. Cinemachine 3 replaced these with new component types (not just renames); the old components still exist but are deprecated, and scripts must use the new Unity.Cinemachine namespace instead of Cinemachine (Unity Technologies, Cinemachine 3.1 manual: What’s new in Cinemachine 3).
| Cinemachine 2.x | Cinemachine 3.x |
|---|---|
CinemachineVirtualCamera, CinemachineFreeLook | CinemachineCamera |
| Body: Transposer / Framing Transposer / Orbital Transposer | Position Control: CinemachineFollow / CinemachinePositionComposer / CinemachineOrbitalFollow |
| Aim: Composer / POV | Rotation Control: CinemachineRotationComposer / CinemachinePanTilt |
Cinemachine3rdPersonFollow | CinemachineThirdPersonFollow |
CinemachineCollider | CinemachineDeoccluder |
CinemachineConfiner | CinemachineConfiner2D, CinemachineConfiner3D |
CinemachinePath, CinemachineDollyCart | Unity Splines (SplineContainer), CinemachineSplineCart |
When following a tutorial written for Cinemachine 2, translate the component names with this table rather than installing the old package version.
Usage
Cinemachine is most useful when:
- a platformer or action game needs tuned follow-camera behaviour
- designers want to iterate camera feel in the inspector
- the project needs screen shake / impulse without inventing a whole camera framework
This makes it a strong bridge between design pages like platformer-design and feel pages like game-feel.
For 3D work, Cinemachine is usually the first thing to reach for when the question is about camera follow, framing, damping, or blending rather than low-level rendering. Unity’s designer-facing playbook treats Cinemachine as a practical tool for camera iteration and sequencing, not just a cinematic extra (Unity, The Unity Game Designer Playbook, see source-unity-game-designer-playbook).
Typical 3D camera workflow
- Put a Cinemachine Brain on the main camera.
- Create a Cinemachine Camera for the gameplay shot.
- Set its Tracking Target (and a separate look-at target only if the shot needs one), then choose Position Control and Rotation Control behaviours.
- Tune distance, damping, framing, and obstruction handling in the inspector.
- Test the camera while moving through real level geometry, not just in an empty scene.
Gotchas
- Cinemachine is powerful, but it does not remove the need for camera design judgement.
- Upgrading older Cinemachine projects requires migration: Cinemachine 3 provides an upgrader for scene data, but scripts referencing the old classes must be updated by hand.
- With Cinemachine Follow and camera-relative player movement, the default binding mode can make the camera rotate with the player and send it spinning; a World Space or Lazy Follow binding mode avoids this.
- A bad camera setup with Cinemachine is still a bad camera setup; the package is not an automatic quality guarantee.
Related
unity-urp-lighting-and-render-features · unity-lod-groups · platformer-design · game-feel · unity-animator-controller · source-cinemachine · unity-reflection-probes-and-specular · unity-pixel-perfect-camera · unity-rigidbody2d · unity-character-controller