Creating a new camera

Cameras have been completely redesigned and simplified for greater accessibility. To set up a new camera profile, just add a new entry inside the cameraData.lua file.

Cameras MUST have their key value as a integer (1,2,3,4,5) etc. Do not use strings "my camera" or floats.

FPV Cameras and TPV Cameras have different type of fields. Pay attention when creating new cameras to fill the fields properly.

-- Valid Third Person View Camera
[1] = { -- Key value must be int
    name = "Chase - Near",
    isFpv = false, 
    carHeightOffsetMulti = 0.9,
    idleRearProximityMulti = 1.1,
    cameraFollowSpeedMulti = 0.84,
    cameraPitchSpeedRate = 0.075,
    cameraBrakingFollowSpeedMulti = 1.125,
    cameraBrakingSpeedRate = 0.025,
    cameraBrakingSpeedReturnRate = 0.01075,
    accelerationPitch = 1.0,
    coastingPitch = 0.85,
    brakingPitch = 0.525,
    idlePitch = 0.675,
    baseFOV = 48.5,
    bikeFpvFOV = 0.0,
    dynamicFOVGain = 24.25,
    highSpeedShakeVibrationIntensityFactor = 0.15,
    highSpeedShakeVibrationSpeedFactor = 100.0,
    orbitCamSensitivityMouse = 15.0,
    orbitCamSensitivityGamepad = 15.0,
    enableBikeYawCorrection = true,
},
-- Valid First Person View Camera
    [3] = {
        name = "Cockpit - Driver",
        isFpv = true,
        driverHeightOffsetMulti = 0.65,
        cameraFollowSpeedMulti = 0.84,
        cameraPitchSpeedRate = 0.100,
        accelerationPitch = 1.0,
        coastingPitch = -1.0,
        brakingPitch = -2.0,
        idlePitch = -2.5,
        baseFOV = 48.0,
        bikeFpvFOV = 90.0,
        dynamicFOVGain = 6.0,
        highSpeedShakeVibrationIntensityFactor = 0.133,
        highSpeedShakeVibrationSpeedFactor = 5.0,
        cameraSlipSpeedRate = 0.333,
        cameraSlipMaxAngle = 15,
        cameraSlipSpeedReturnRate = 0.075,
        lookArroundCamSensitivityMouse = 6.25,
        lookArroundCamSensitivityGamepad = 6.0,
        enableBikeYawCorrection = false, -- set it to false in fpv.
    }

Inside the camera profile, you'll find the following parameters:

isFpv

Flag this as true, if this camera is intended to be in First Person View.

carHeightOffsetMulti

A Multiplier for the base Z Axis height for this camera, lower values, more close to the ground, higher values, further from the ground.

idleRearProximityMulti

A Multiplier for the distance to the rear of the car when idling.

cameraFollowSpeedMulti

A Multiplier for the camera follow speed, the less the further behind the camera is from the car when moving.

cameraPitchSpeedRate

A Fixed rate value controlling how fast the pitch effects will be applied.

cameraBrakingFollowSpeedMulti

A Multiplier controling how close the camera goes towards the vehicle when braking.

cameraBrakingSpeedRate

A Fixed rate value controlling how fast the camera goes towards the vehicle when braking.

cameraBrakingSpeedReturnRate

A Fixed rate value controlling how fast the camera returns to normal after releasing the brakes.

accelerationPitch

How much the camera looks up when accelerating

coastingPitch

How much the camera looks up when accelerating, but not pressing the throttle.

brakingPitch

How much the camera looks up when braking.

idlePitch

How much the camera looks up when idling.

baseFOV

The base field of view value, in degrees.

bikeFpvFOV

The base field of view value, in degrees, but specifically for bikes, if it is a FPV camera. You can have this set to 0, on TPV cameras.

dynamicFOVGain

The fov gain rate with speed. The more, the larger your FOV get's with speed. Good to increase the sense of speed at high speeds.

highSpeedShakeVibrationIntensityFactor

A Fixed value that controls the intensity of the vibration at high speeds.

useInvertedOrbitCamControls

If enabled, inverts left/right on the orbit cam.

orbitCamSensitivityMouse

Fixed value controlling the mouse sensitivity for the orbit camera.

orbitCamSensitivityGamepad

Fixed value controlling the sensitivity for the orbit camera, with a gamepad.

orbitCamAutoReturn

Controls if the camera auto returns to center when you stop moving the mouse.

orbitCamAutoReturnTime

The ammount of time in MS for the camera to auto return to center when you stop moving the mouse.

enableBikeYawCorrection

Toggles the bike yaw correction, acting like a gyroscope for the camera, set it to false in a FPV camera.

cameraSlipSpeedRate

FPV Camera exclusive field, controls the rate that the camera corrects it's viewing when the car's sliding.

cameraSlipMaxAngle

FPV Camera exclusive field, controls the maximum view correction angle for when the car's sliding.

cameraSlipSpeedReturnRate

FPV Camera exclusive field, controls the rate that the camera returns from the corrected view to the normal view.

lookArroundCamSensitivityMouse,lookArroundCamSensitivityGamepad

FPV Camera exclusive field, do the exact same as their "orbit cam" counterpart.