Files

1.3 KiB
Raw Permalink Blame History

Saving in Play Mode

Its often most convenient to adjust camera settings while the game is playing. But normally, Unity does not save your changes to the Scene when you exit Play Mode. Cinemachine has a special feature to preserve the tweaks you make during Play Mode. It doesnt save structural changes, like adding or removing a behavior. With the exception of certain properties, Cinemachine can preserve most of the settings in your CinemachineCameras when you exit Play Mode.

When you exit Play Mode, Cinemachine scans the Scene to collect any changed properties in the CinemachineCameras. Cinemachine saves these changes a second or so after exiting. Use the Edit > Undo command to revert these changes.

Check Save During Play on any CinemachineCamera in the Inspector to enable this feature. This is a global property, not per-camera, so you only need to check or uncheck it once.

Cinemachine components have the special attribute [SaveDuringPlay] to enable this functionality. Specific fields are excluded from being saved by having the [NoSaveDuringPlay] attribute added to the field.

Tip

You can use the [SaveDuringPlay] and [NoSaveDuringPlay] attributes in your own custom scripts, to acquire the same functionality for them as well.