Behavior Presets

01Quick Start

The global preset system ships off (every vehicle uses its own inspector values). To turn it on:

1. Open Tools → BoneCracker Games → Realistic Car Controller → Edit RCC Settings.
2. Expand Behavior Settings and tick Override Behavior.
3. Click a preset button in the toolbar under the list: Balanced, Racing, Drift, Semi Arcade or Fun.
4. Enter Play mode. Every vehicle uses that preset.

Figure 01Open full size ↗

From code, one call does steps 2–3 at runtime:

using UnityEngine;

public class DriftModeOnStart : MonoBehaviour {

    private void Start() {

        // 0 Balanced, 1 Racing, 2 Drift, 3 Semi Arcade, 4 Fun
        RCC.SetBehavior(2);

    }

}

02Shipped Presets

The presets live in Resources/RCC Assets/RCC_Settings.asset → Behavior Types. The index is the position in that list.

Figure 02Open full size ↗

Comparison

Values from the shipped RCC_Settings.asset. A range a–b is a Minimum/Maximum pair (see How a Preset Is Applied).

Figure 03Open full size ↗

Figure 04Open full size ↗

All five use Steering Type Curve. The High Speed Steer Angle fields are listed in the field reference; they only matter for vehicles on the Simple steering type.

03How a Preset Is Applied

Figure 05Open full size ↗

• When: each vehicle applies the selected preset when it is created (Awake) and again whenever RCC_Events.OnBehaviorChanged fires (every RCC.SetBehavior call). Its wheels re-apply friction at the same moments.
• Toggles are copied to the vehicle: Steering Helper, Traction Helper, Angular Drag Helper, Counter Steering, Limit Steering (vehicle: Use Steering Limiter), Steering Sensitivity, ABS, ESP, TCS, Steering Type and Com Assister.
• Steering Curve replaces the vehicle's Steer Angle Curve when the steering type is Curve. Because the shipped presets set Curve, a vehicle set to Simple or Constant is switched to Curve.
• Minimum/Maximum pairs clamp the vehicle's own value. A value already inside the range is kept; a value outside is moved to the nearest end.
• Anti Roll … Minimum is a floor only. Gear Shifting Delay Maximum is a cap only.
• Angular Drag is written to the Rigidbody's angular damping. When Angular Drag Helper is on, the helper overwrites angular damping every physics step, so Angular Drag only has a lasting effect with the helper off (as in Drift).
• Friction: every preset writes its forward and sideways Extremum/Asymptote Slip and Value to all wheels. Stiffness still comes from ground materials.
• Apply External Wheel Frictions adds dynamic grip loss while wheels slip, plus a sideways push on rear wheels of RWD vehicles at high throttle.
• Apply Relative Torque adds yaw torque from steering input every physics step while grounded.
• Values a preset changed are not restored while the vehicle exists. There is no runtime call that turns presets off.

Figure 06Open full size ↗

Figure 07Open full size ↗

When presets are on, the vehicle inspector shows a warning and draws the sections a preset controls in red.

Figure 08Open full size ↗

04Field Reference

Labels as shown in Behavior Settings → Behavior Types → Element N.

What the friction values mean: How WheelColliders Work.

05Per-Vehicle Opt-Out

To keep one vehicle on its own settings while presets are on, tick Ignore Global Behavior Preset at the top of its RCC_CarControllerV4 inspector. That vehicle and its wheels skip every preset step above.

Changed in V6: this toggle was previously labelled Ineffective Behavior.

06Creating a Custom Preset

Edit outside Play mode.

1. Open Edit RCC Settings → Behavior Settings and tick Override Behavior (the list is disabled while it is off).
2. Expand Behavior Types and click + under the list. Unity adds a copy of the last entry as a new element.
3. Rename Behavior Name and change the values. A button with that name appears in the toolbar.
4. Select it with its button, or call RCC.SetBehavior(5) (its index in the list).

Reordering or removing entries changes the indices your code uses.

07Switching at Runtime

RCC.SetBehavior(int) turns Override Behavior on, sets the selected index and fires RCC_Events.OnBehaviorChanged. Every vehicle in the scene re-applies the preset; vehicles spawned later use it too. An index outside the list applies nothing.

A preset picker for a uGUI Dropdown:

using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;

public class BehaviorDropdown : MonoBehaviour {

    public Dropdown dropdown;

    private void Start() {

        List<string> names = new List<string>();

        foreach (RCC_Settings.BehaviorType preset in RCC_Settings.Instance.behaviorTypes)
            names.Add(preset.behaviorName);

        dropdown.ClearOptions();
        dropdown.AddOptions(names);
        dropdown.SetValueWithoutNotify(RCC_Settings.Instance.behaviorSelectedIndex);
        dropdown.onValueChanged.AddListener(RCC.SetBehavior);

    }

}

React to a change, for example to update a HUD label:

using UnityEngine;
using UnityEngine.UI;

public class BehaviorLabel : MonoBehaviour {

    public Text label;

    private void OnEnable() {

        RCC_Events.OnBehaviorChanged += UpdateLabel;
        UpdateLabel();

    }

    private void OnDisable() {

        RCC_Events.OnBehaviorChanged -= UpdateLabel;

    }

    private void UpdateLabel() {

        RCC_Settings.BehaviorType preset = RCC_Settings.Instance.selectedBehaviorType;
        label.text = preset != null ? preset.behaviorName : "Off";

    }

}

selectedBehaviorType returns null while Override Behavior is off.

Editing in Play Mode

In Play mode, Edit RCC Settings opens a runtime copy of the settings. Changes affect only that session and are lost when you stop. Clicking a preset button there does not re-apply presets to vehicles already in the scene; call RCC.SetBehavior instead.

08See Also

• How WheelColliders Work
• Vehicle Inspector Reference
• RCC Settings
• Scripting API
• Events System