Official Cinemachine release announcements

Hi everyone, we're going to close the previous release/discussion thread for 2.7.1 (and 2.7.2) and centralize new release announcements in this read-only thread. Click the "Watch Thread" link above if you'd like to receive an email when this thread is updated.

For more information about Cinemachine, please take a look at our documentation.

Please create a new thread for feature requests, bug reports, or general discussion. For bug reports in particular, it helps us immensely if you prepare a minimal project that reproduces your issue. Submit a bug report using the Unity Bug Reporter and include the id you receive (via email) in your post.

 

Hot off the buildfarm are two new versions of Cinemachine, 2.6.4 and 2.7.3. These patch releases are chock-full of bug fixes and are officially verified in 2019 LTS & 2020 LTS (2.6.4) and released in 2021.1+ (2.7.3).

Both releases are available now in Package Manager:

Both versions are compatible with Unity 2018 LTS and up.

Changes in 2.6.4 (from 2.6.3):

• Bugfix: 3rdPersonFollow collision resolution failed when the camera radius was large.
• Bugfix: 3rdPersonFollow damping was done in world space instead of camera space.
• Bugfix: 3rdPersonFollow stuttered when z damping was high.
• Bugfix: 3rdPersonFollow FOV blended incorrectly when ReferenceLookAt was set to a faraway target.
• Bugfix: Position predictor was not properly reset.
• Bugfix: FramingTransposer's TargetMovementOnly damping caused a flick.
• Bugfix: CM StoryBoard lost viewport reference after hot reload.
• Bugfix: CM StoryBoard had a 1 pixel border.
• Bugfix: SaveDuringPlay also works on prefab instances.
• Bugfix: Re-awakened long-idle vcams could have a single frame with a huge deltaTime.
• Bugfix (1290171): Impulse manager was not cleared at playmode start.
• Bugfix (1272146): Adding a vcam to a prefab asset caused errors in the console.

The full changelog is available here and documentation is here.

Changes in 2.7.3 (from 2.7.2):

• Bugfix: 3rdPersonFollow collision resolution failed when the camera radius was large.
• Bugfix: 3rdPersonFollow damping was done in world space instead of camera space.
• Bugfix: 3rdPersonFollow stuttered when z damping was high.
• Regression fix: CinemachineInputProvider stopped providing input.
• Bugfix: Lens aspect and sensorSize were not updated when lens OverrideMode != None.

The full changelog is available here and documentation is here.

As always, we love to hear from you. Please feel free to create new threads for reporting bugs, requesting features, or just general discussion.

> How to report bugs <

 

Hi folks!

We're pleased to announce that we have published a new version of Cinemachine: 2.8.0-pre.1.

What's New
We've refactored Impulse to make it easier to use. What's Impulse? Impulse is a system for connecting events in your game (like an explosion) to camera reactions (shakey shakey). Previously, the all of the properties of the impulse signal (and reactions to it) were controlled by the Impulse Source. Instead, we've moved the properties controlling the reaction of the camera to the Impulse Listener.

This feature is very fresh… so fresh, in fact, that we don't have documentation for it yet. In short, the Impulse Source now generates four different types of impulse:

Uniform
A Uniform impulse is received instantaneously, no matter how far the listener is from the source.[/td]

Dissipating
Similar to Uniform, a Dissipating impulse is received instantaneously. However the farther the listener is from the source, the weaker the signal.

Propagating
Unlike Uniform and Dissipating, a Propagating impulse has a propagation speed. The farther the listener from the source, the longer it takes for the signal to reach the listener.

Legacy
Same controls as available prior to Cinemachine 2.8.

Properties that control how the Impulse Listener reacts to the impulse signal were added to the Listener. This permits different Game Objects to react to the same signal in different ways, no matter the impulse type.

But that's not all! More info can be found in the changelog.

Minimum Requirements
Unity 2019.4

To Install Cinemachine 2.8.0-pre.1, do one of the following:

• In Unity 2021.1 and above, click the [+] button at the top left of the Package Manager, select Add package by name... and enter com.unity.cinemachine in the Name field and 2.8.0-pre.1 in the Version field.
  
  OR
  
  
• In Unity 2020.3 and above, click the [+] button at the top left of the Package Manager, select Add package by git URL... and enter com.unity.cinemachine@2.8.0-pre.1.
  
  OR
  
  
• In any supported version of Unity, edit Packages/manifest.json and add the following line to the top of the list of dependencies:
  
  "com.unity.cinemachine": "2.8.0-pre.1",
  
  (or update the existing version to 2.8.0-pre.1).

Thanks!

> How to report bugs <

 

I'm happy to announce that Cinemachine 2.6.5 and 2.7.4 are now available. These are patch releases and officially verified in 2019 LTS and 2020 LTS (2.6.5) and released in 2021.1 (2.7.4). If you're using 2021.2, the 2.8.0-pre.1 release contains the same fixes.

To install Cinemachine 2.6.5 or 2.7.4, open Package Manager, find Cinemachine, select the appropriate release, and click the "Install" button.

For the full changelog, see here (2.6.5) or here (2.7.4).

Thanks!

> How to report bugs <

 

My apologies for this announcement being over a month late: Cinemachine 2.8.0, 2.7.8, and 2.6.10 are now available. These are all effectively patch releases that fix bugs and update samples.

To install Cinemachine 2.8.0, 2.7.8 or 2.6.10, open Package Manager, find Cinemachine, select the appropriate release, and click the "Install" button.

Please note the recommended versions for each release of the Unity Editor:

• Unity 2021.2 beta -> Cinemachine 2.8.0
  
• Unity 2021.1 -> Cinemachine 2.7.8
• Unity 2020 LTS and Unity 2019 LTS -> Cinemachine 2.6.10

Full changelogs are available here: 2.8.0, 2.7.8, 2.6.10.

Thanks!

> How to report bugs <

 

Fresh releases are here! Cinemachine 2.8.2, 2.7.9 and 2.6.11 are now available.

These are patch releases fixing a bunch of bugs. Full changelogs are available here: 2.6.11, 2.7.9, 2.8.2.

Please note that this is the final release of the 2.7.x branch as 2021.1 is no longer under support. Please upgrade to the 2.8.x branch to benefit from future patch releases.

 

Cinemachine 2.8.3 is now available in Package Manager with the following changes:

• Bugfix: Negative Near Clip Plane value is kept when camera is orthographic.
• Removed legacy .unitypackages
• Regression fix: could not change the projection of the main camera if a CM virtual camera is active
• Regression fix: compilation errors when physics module is not present

You can find the full changelog here (it might still say 2.8.2 - the docs should update shortly).

 

Cinemachine 2.8.4 is now available in Package Manager:

• Regression fix: virtual cameras no longer forget that they are targeting groups on domain reload.
• Bugfix: 3rdPersonFollow logged console messages when looking straight up or down.
• BugFix: InputProvider no longer causes a tiny gc alloc every frame.
• Regression fix: CinemachineCollider smoothing time did not reset correctly, so it was working once only.
• Bugfix: Confiner2D now displays the calculated confining area when its vcam is selected.

You can find the full changelog here.

 

Cinemachine 2.9.0-pre.6 is available in Package Manager! This is the second public release of 2.9.0-pre, but I just realized I forgot to announce the first.

Cinemachine 2.9 makes use of the new scene view overlay/toolbar system in 2021.2, and adds new tool modes and handles for manipulating Cinemachine cameras. Not all of the scene view overlay functionality made it into 2021.2, so this feature works best in Unity 2022.1+.

You can find the full changelog here.