Unity C# Third Person Camera Occlusion Script

Here is a C# script for Unity that ensures a third-person camera moves closer to the player when an object obstructs the view. This script utilizes raycasting to detect occlusion and adjust the camera’s position accordingly.

using UnityEngine;

public class ThirdPersonCamera : MonoBehaviour
{
    public Transform player;
    public float defaultDistance = 5f;
    public float minDistance = 1f;
    public float smoothSpeed = 10f;
    public Vector3 offset;

    private float currentDistance;

    void Start()
    {
        currentDistance = defaultDistance;
    }

    void LateUpdate()
    {
        HandleCameraOcclusion();
    }

    void HandleCameraOcclusion()
    {
        Vector3 desiredPosition = player.position - transform.forward * defaultDistance + offset;
        RaycastHit hit;

        if (Physics.Raycast(player.position + offset, -transform.forward, out hit, defaultDistance))
        {
            currentDistance = Mathf.Clamp(hit.distance, minDistance, defaultDistance);
        }
        else
        {
            currentDistance = defaultDistance;
        }

        Vector3 newPosition = player.position - transform.forward * currentDistance + offset;
        transform.position = Vector3.Lerp(transform.position, newPosition, Time.deltaTime * smoothSpeed);
        transform.LookAt(player.position + offset);
    }
}

How It Works:

1. The camera starts at a default distance from the player.
2. A raycast is fired from the player toward the camera.
3. If the ray hits an obstacle, the camera moves closer, adjusting its position to maintain visibility.
4. If no obstacle is detected, the camera stays at the default distance.
5. The camera smoothly transitions to the new position.

You can adjust:

• defaultDistance for normal camera distance.
• minDistance to set the closest the camera can get.
• smoothSpeed to control movement smoothness.