Donnerstag, 3. Mai 2012

Unity3D: 3rd Person Shooter Camera

I reviewed and updated this C# script from the Unity3D 3rdPersonShooter project, so you can just add it to your camera and drag your player onto the "player" variable and thats it. You don't need to do anything other. Originally there was support for a crosshair and an xbox (or another) controller with two joysticks - you can activate that by uncommenting some stuff. It is described there.

For the super lazy people: you can download it HERE

Have Fun!

Here is the script:

// Camera code is from this Project:
// Thank you guys.

// Add this script to the main camera.
// In the inspector, there is a variable "player" - drag your player on it.
// Press Play!

using UnityEngine;
using System.Collections;

// 3rd person game-like camera controller
// keeps camera behind the player and aimed at aiming point
public class ShooterGameCamera : MonoBehaviour {
    public Transform player;
    // public Texture crosshair; // crosshair - removed it for quick and easy setup. ben0bi
    // if you add the crosshair, you need to drag a crosshair texture on the "crosshair" variable in the inspector
    protected Transform aimTarget; // that was public and a gameobject had to be dragged on it. - ben0bi
    public float smoothingTime = 10.0f; // it should follow it faster by jumping (y-axis) (previous: 0.1 or so) ben0bi
    public Vector3 pivotOffset = new Vector3(0.2f, 0.7f,  0.0f); // offset of point from player transform (?) ben0bi
    public Vector3 camOffset   = new Vector3(0.0f, 0.7f, -3.4f); // offset of camera from pivotOffset (?) ben0bi
    public Vector3 closeOffset = new Vector3(0.35f, 1.7f, 0.0f); // close offset of camera from pivotOffset (?) ben0bi
    public float horizontalAimingSpeed = 800f; // was way to lame for me (270) ben0bi
    public float verticalAimingSpeed = 800f;   // --"-- (270) ben0bi
    public float maxVerticalAngle = 80f;
    public float minVerticalAngle = -80f;
    public float mouseSensitivity = 0.3f;
    private float angleH = 0;
    private float angleV = 0;
    private Transform cam;
    private float maxCamDist = 1;
    private LayerMask mask;
    private Vector3 smoothPlayerPos;
    // Use this for initialization
    void Start ()
        // [edit] no aimtarget gameobject needs to be placed anymore - ben0bi
        GameObject g=new GameObject();
        // Add player's own layer to mask
        mask = 1 << player.gameObject.layer;
        // Add Igbore Raycast layer to mask
        mask |= 1 << LayerMask.NameToLayer("Ignore Raycast");
        // Invert mask
        mask = ~mask;
        cam = transform;
        smoothPlayerPos = player.position;
        maxCamDist = 3;
    // Update is called once per frame
    void LateUpdate () {
        if (Time.deltaTime == 0 || Time.timeScale == 0 || player == null)
        // if you want to set up an xbox controller or something, you need to uncomment the
        // commented axes below in the source.
        // (unity->edit->Project Settings->input, check the parameters behind the @ below.)
        // you can set up a new axis in the inspector by typing in a bigger number in the size property at the top.
        // I removed this, so you can quick and easy add this script to your game. - ben0bi
                                                     // @joystick 3rd axis
        angleH += Mathf.Clamp(Input.GetAxis("Mouse X") /* + Input.GetAxis("Horizontal2") */ , -1, 1) * horizontalAimingSpeed * Time.deltaTime;
                                                     // @joystick 4th axis
        angleV += Mathf.Clamp(Input.GetAxis("Mouse Y") /* + Input.GetAxis("Vertical2") */ , -1, 1) * verticalAimingSpeed * Time.deltaTime;
        // limit vertical angle
        angleV = Mathf.Clamp(angleV, minVerticalAngle, maxVerticalAngle);
        // Before changing camera, store the prev aiming distance.
        // If we're aiming at nothing (the sky), we'll keep this distance.
        float prevDist = (aimTarget.position - cam.position).magnitude;
        // Set aim rotation
        Quaternion aimRotation = Quaternion.Euler(-angleV, angleH, 0);
        Quaternion camYRotation = Quaternion.Euler(0, angleH, 0);
        cam.rotation = aimRotation;
        // Find far and close position for the camera
        smoothPlayerPos = Vector3.Lerp(smoothPlayerPos, player.position, smoothingTime * Time.deltaTime);
        smoothPlayerPos.x = player.position.x;
        smoothPlayerPos.z = player.position.z;
        Vector3 farCamPoint = smoothPlayerPos + camYRotation * pivotOffset + aimRotation * camOffset;
        Vector3 closeCamPoint = player.position + camYRotation * closeOffset;
        float farDist = Vector3.Distance(farCamPoint, closeCamPoint);
        // Smoothly increase maxCamDist up to the distance of farDist
        maxCamDist = Mathf.Lerp(maxCamDist, farDist, 5 * Time.deltaTime);
        // Make sure camera doesn't intersect geometry
        // Move camera towards closeOffset if ray back towards camera position intersects something
        RaycastHit hit;
        Vector3 closeToFarDir = (farCamPoint - closeCamPoint) / farDist;
        float padding = 0.3f;
        if (Physics.Raycast(closeCamPoint, closeToFarDir, out hit, maxCamDist + padding, mask)) {
            maxCamDist = hit.distance - padding;
        cam.position = closeCamPoint + closeToFarDir * maxCamDist;
        // Do a raycast from the camera to find the distance to the point we're aiming at.
        float aimTargetDist;
        if (Physics.Raycast(cam.position, cam.forward, out hit, 100, mask)) {
            aimTargetDist = hit.distance + 0.05f;
        else {
            // If we're aiming at nothing, keep prev dist but make it at least 5.
            aimTargetDist = Mathf.Max(5, prevDist);
        // Set the aimTarget position according to the distance we found.
        // Make the movement slightly smooth.
        aimTarget.position = cam.position + cam.forward * aimTargetDist;
    // so you can change the camera from a static observer (level loading) or something else
    // to your player or something else. I needed that for network init... ben0bi
    public void SetTarget(Transform t)
    // uncomment this if you want to have a crosshair - ben0bi
    void OnGUI ()
        if (Time.time != 0 && Time.timeScale != 0)
            GUI.DrawTexture(new Rect(Screen.width/2-(crosshair.width*0.5f), Screen.height/2-(crosshair.height*0.5f), crosshair.width, crosshair.height), crosshair);


  1. Hi! I'm using your fantastic script and trying to make my camera not going into walls when it collides with them... Can you help me? Thanks!!! :)

    1. It is already in the script at ....if(Physics.raycast ......) - did you forget that or what do you mean?

  2. Hi. I'm a little bit curious here. What if the player or the character that going to be followed by the camera is instantiated first. I can't drag the character prefab that's not in the scene to the script.

    1. You could get the camera in the player script and then set the player from there.

      (Player script (C#)):
      Camera cam = Camera.main; // or something other to get the camera
      cam.getComponent().player = this.gameObject;

      ..where "CameraScript" is the name of the script file above and player is the variable to set - it must be public.

      Hope that helps.

    2. Sorry: cam.getComponent(CameraScript)() -> the first two braces are > and < in the other way. Html error here. ;)

  3. how i can make the player rotate where the camera is loking. like h1z1 camera. player rotate in horizontal axis and the camera follow the player