Cinemachine Collider

Cinemachine Collider is an extension for the Cinemachine Virtual Camera. It post-processes the final position of the Virtual Camera to attempt to preserve the line of sight with the Look At target of the Virtual Camera. It does this by moving away from the GameObjects that obstruct the view.

Add a Cinemachine Collider extension to a Cinemachine Virtual Camera to do any of the following tasks:

• Push the camera away from obstructing obstacles in the Scene.

• Place the camera in front of obstacles that come between the Virtual Camera and its Look At target.

• Evaluate shot quality. Shot quality is a measure of the distance of the Virtual Camera from its ideal position, the distance of the Virtual Camera to its target, and the obstacles that block the view of the target. Other modules use shot quality, including Clear Shot.

The Collider uses a Physics Raycaster. Therefore, Cinemachine Collider requires that potential obstacles have collider volumes. There is a performance cost for this requirement. If this cost is prohibitive in your game, consider implementing this functionality in a different way.

Properties:

Property:		Function:
Collide Against		Cinemachine Collider considers GameObjects in these layers to be potential obstacles. It ignores GameObjects that are not in the selected layers.
Minimum Distance From Target		Ignore obstacles that are less than this distance from the target's pivot point.
Avoid Obstacles		Check to allow the Collider to move the camera in the Scene when the target is obscured by an obstacle. Use the Distance Limit, Camera Radius, and Strategy properties to adjust how to avoid obstacles. If left unchecked, the Cinemachine Collider will report shot quality based on obstacles, but will not attempt to move the camera to improve the shot.
Distance Limit		The maximum raycast distance when checking if the line of sight to this camera’s target is clear. Enter 0 to use the current actual distance to the target. Available when Avoid Obstacles is checked.
Camera Radius		Distance to maintain from any obstacle. Try to keep this value small for best results. Increase it if you are seeing inside obstacles due to a large FOV on the camera. Available when Avoid Obstacles is checked.
Strategy		The way in which the Collider attempts to preserve sight of the target. Available when Avoid Obstacles is checked.
	Pull Camera Forward	Move the camera forward along its Z axis until it is in front of the obstacle that is nearest to the target.
	Preserve Camera Height	Move the camera to an alternate point of view while attempting to keep the camera at its original height.
	Preserve Camera Distance	Move the camera to an alternate point of view while attempting to keep the camera at its original distance from the target.
Smoothing Time		Minimum number of seconds to hold the camera at the nearest point to the target. Can be used to reduce excess camera movement in environments with lots of obstacles. Available when Avoid Obstacles is checked.
Damping		How quickly to return the camera to its normal position after an occlusion has gone away. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly. Available when Avoid Obstacles is checked.
Damping When Occluded		How quickly to move the camera to avoid an obstacle. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly. Available when Avoid Obstacles is checked.
Optimal Target Distance		If greater than zero, give a higher score to shots when the target is closer to this distance. Set this property to 0 to disable this feature.
Transparent Layers		Objects on these layers will never obstruct the view of the target.
Minimum Occlusion Time		Do not take action action unless the occulsion has lasted at least this long.
Maximum Effort		Upper limit on how many obstacle hits to process. Higher numbers may impact performance. In most environments four (4) hits is enough.
Ignore Tag		Obstacles with this tag will be ignored. It is recommended to set this field to the target's tag.