Scripting API

RCC lives in Scripts/RCC.cs. All of its methods are static: call them on the type, e.g. RCC.SpawnRCC(...). Every call must come from Unity's main thread.

01Quick Start

1. Add a camera: Tools → BoneCracker Games → Realistic Car Controller → Create → Cameras → Add RCC Camera To Scene.
2. Create an empty GameObject and add the script below.
3. Drag a vehicle prefab from Prefabs/Vehicles/ into Vehicle Prefab, and any Transform into Spawn Point.
4. Press Play. The car spawns with its engine running, waits 3 seconds, then takes your input.

using System.Collections;
using UnityEngine;

public class RaceStart : MonoBehaviour {

    public RCC_CarControllerV4 vehiclePrefab;
    public Transform spawnPoint;

    private IEnumerator Start() {

        // Spawn, register as the player vehicle, not controllable yet, engine running.
        RCC_CarControllerV4 car = RCC.SpawnRCC(vehiclePrefab, spawnPoint.position, spawnPoint.rotation, true, false, true);

        yield return new WaitForSeconds(3f);

        RCC.SetControl(car, true);

    }

}

You don't need to add an RCC Scene Manager first: RCC_SceneManager.Instance creates one if the scene has none.

02The RCC Class

Figure 01Open full size ↗

Instead of the two placeholders, set the fields directly: RCC_Settings.Instance.units = RCC_Settings.Units.MPH; (changes the displayed unit only) and vehicle.automaticGear = false;.

SetBehavior and SetMobileController change RCC_Settings. In Play mode RCC_Settings.Instance is a copy, so these changes are not saved to the asset.

03Spawning and Registering

The player vehicle is RCC_SceneManager.Instance.activePlayerVehicle. The camera follows it and the dashboard shows it.

• SpawnRCC(..., registerAsPlayerVehicle: true, ...) or RegisterPlayerVehicle(...) sets it.
• The Scene Manager's Register Last Spawned Vehicle As Player Vehicle (on by default) also registers every vehicle that becomes active, unless it is externally controlled (AI, replay, network). Turn it off if you spawn non-player vehicles at runtime — otherwise the last one spawned becomes the player vehicle even with registerAsPlayerVehicle: false.

Figure 02Open full size ↗

Figure 03Open full size ↗

Changed in V6: registering a different vehicle takes player control away from the previous one (SetCanControl(false)), so only one car responds to your input. A previous vehicle that is externally controlled or driven by OverrideInputs is left alone. Registering an externally controlled vehicle (for example to point the camera at an AI car) takes control from nothing.

Figure 04Open full size ↗

To switch the player back to a car you left earlier, use an overload that sets control — the one-argument version keeps it uncontrollable:

RCC.RegisterPlayerVehicle(otherCar, true);

Other useful Scene Manager members:

04Control and Engine

• RCC.SetControl(vehicle, false) — the vehicle ignores player input and holds its handbrake. Use it for countdowns, menus and cutscenes.
• RCC.SetEngine(vehicle, true) plays the starter sound and the engine runs after about 1 second. For an instant start call vehicle.StartEngine(true).

05Behavior Presets

RCC.SetBehavior(index) selects a preset from RCC Settings. Shipped indices: 0 Balanced, 1 Racing, 2 Drift, 3 Semi Arcade, 4 Fun. The call turns on RCC Settings → Override Behavior, so the preset is applied even though the system ships off. Vehicles with Ignore Global Behavior Preset ticked are not affected. What each preset changes: Behavior Presets.

06Camera

RCC.ChangeCamera() steps through TPS → FPS (hood) → WHEEL → FIXED → CINEMATIC → TOP, skipping modes that are turned off on the RCC Camera or whose camera is missing. It does nothing if the scene has no RCC Camera.

Figure 05Open full size ↗

To jump straight to a mode:

RCC_SceneManager.Instance.activePlayerCamera.ChangeCamera(RCC_Camera.CameraMode.TOP);

This sets the mode without checking whether it is available. See Camera System.

07Record and Replay

1. Add a Scene Manager: Tools → BoneCracker Games → Realistic Car Controller → Create → Managers → Add RCC Scene Manager.
2. Tick Use Record / Replay on it before entering Play mode. A recorder is attached to each vehicle when it spawns, so vehicles spawned while the option is off have none. A Scene Manager created automatically has it off.
3. Call RCC.StartStopRecord() to start, and again to stop and save.
4. Call RCC.StartStopReplay() to play the recording back. During playback the vehicles are externally controlled; control returns when playback stops.

All three calls act on every recorded vehicle in the scene (AI included) and do nothing while Use Record / Replay is off. The default keys are listed in Input System.

Figure 06Open full size ↗

08Transport and Repair

Transport (both overloads) moves the vehicle with its Rigidbody, zeroes its velocity and that of its child Rigidbodies, releases the throttle, applies full brake, drops engine RPM to idle and sets the gear index to 0.

RCC.Transport(respawnPoint.position, respawnPoint.rotation);

Repair starts restoring a damaged vehicle: deformed meshes, wheel positions (and deflated tyres), detachable parts and broken lights. How fast it happens depends on the vehicle's Deformation Mode:

vehicle.damage.repaired becomes true when the repair is complete. See Damage System.

using UnityEngine;

public class RepairZone : MonoBehaviour {

    private void OnTriggerEnter(Collider other) {

        RCC_CarControllerV4 vehicle = other.GetComponentInParent<RCC_CarControllerV4>();

        if (vehicle)
            RCC.Repair(vehicle);

    }

}

09Useful Vehicle Members

All on RCC_CarControllerV4.

RCC_CarControllerV4 car = RCC_SceneManager.Instance.activePlayerVehicle;

if (car) {

    car.lowBeamHeadLightsOn = true;
    car.indicatorsOn = RCC_CarControllerV4.IndicatorsOn.All;
    Debug.Log(car.speed.ToString("0") + " km/h, gear " + (car.currentGear + 1));

}

The full field list is in Vehicle Inspector Reference.

10Reading Inputs

Current player input is in RCC_InputManager.Instance.inputs (throttleInput, brakeInput, steerInput, handbrakeInput, boostInput, clutchInput). GetInputs() returns nothing — read the field. See Input System.

11Events

To react to spawns, player changes, collisions or input actions, subscribe to RCC_Events — see Events System.

12See Also

• How To Override Inputs
• Events System
• Behavior Presets
• Camera System
• Scripts Reference