Core Behaviors

1. Input Handling

• Accepts player input (throttle, brake, steer, etc.) via RCC_InputManager or can be overridden for AI/external control.

• Supports manual, automatic, and semi-automatic gear shifting.

2. Physics & Dynamics

• Uses Unity’s Rigidbody for physics.

• Manages wheels via custom RCC_WheelCollider components.

• Calculates and applies torque, brake, and steering per wheel.

• Implements anti-roll bars, downforce, and dynamic center of mass adjustment for stability.

3. Driving Assistance

• Features ABS, TCS, ESP, steering/traction helpers, and angular drag helper for realistic handling and safety.

• Drift detection and drift mode support.

4. Engine & Gearbox

• Simulates engine torque curve, RPM, inertia, and rev limiter.

• Handles fuel consumption, engine heat, and turbo/NOS boost.

5. Audio & Visuals

• Dynamically manages engine, wind, brake, and collision sounds.

• Animates steering wheel and manages vehicle lights and indicators.

6. Damage & Collisions

• Supports mesh deformation, collision particles, and crash sounds.

• Can auto-reset if flipped or stuck.

7. Customization & Events

• Integrates with a customizer for visual upgrades.

• Fires events on spawn, destroy, and collision.

Update & FixedUpdate Loops

• Update(): Handles input, audio, visual feedback, and drift logic.

• FixedUpdate(): Manages physics, engine, steering, wheels, driving assists, and applies forces.

Extensibility

• Highly modular: Many features can be toggled or overridden.

• Supports both player and AI control.

---

Summary:

RCC_CarControllerV4 is a feature-rich, modular car controller for Unity, simulating realistic vehicle physics, input, audio, and visual feedback, with extensive support for driving assists, damage, and customization.

1. ABS (Anti-lock Braking System)

• Purpose: Prevents wheel lockup during heavy braking.

• Implementation:

• Controlled by the ABS boolean.

• Threshold: ABSThreshold (default 0.35).

• Behavior:

• When braking, the script monitors wheel slip.

• If slip exceeds ABSThreshold, ABS modulates brake torque to prevent lockup.

• The flag ABSAct is set true when ABS is active.

• Note: The actual modulation logic is likely handled inside the RCC_WheelCollider or related methods, as this class sets up the flag and threshold.

---

2. TCS (Traction Control System)

• Purpose: Prevents excessive wheel spin during acceleration.

• Implementation:

• Controlled by the TCS boolean.

• Strength: TCSStrength (default 0.5).

• Behavior:

• When accelerating, the script checks for wheel slip.

• If slip exceeds TCSStrength, throttle or torque is reduced to regain traction.

• The flag TCSAct is set true when TCS is active.

• Note: Like ABS, the actual torque reduction is likely handled in wheel or engine logic.

---

3. ESP (Electronic Stability Program)

• Purpose: Maintains vehicle stability by correcting understeer/oversteer.

• Implementation:

• Controlled by the ESP boolean.

• Threshold: ESPThreshold (default 0.5), Strength: ESPStrength (default 0.25).

• Behavior:

• In ESPCheck():

• Calculates frontSlip and rearSlip from wheel colliders.

• If frontSlip exceeds ESPThreshold, sets underSteering = true.

• If rearSlip exceeds ESPThreshold, sets overSteering = true.

• If either is true, ESPAct = true and the system may apply corrective braking/torque.

• If ESPBroken is true, ESP is disabled.

• Note: Actual corrective actions are likely applied in the Wheels() method when ESPAct is true.

---

4. Steering Helper

• Purpose: Helps correct small steering errors and maintain intended direction.

• Implementation:

• Controlled by the steeringHelper boolean.

• Strengths: steerHelperLinearVelStrength, steerHelperAngularVelStrength.

• Behavior:

• In SteerHelper():

• Compares the vehicle’s velocity direction and steering direction.

• Applies a corrective torque to the Rigidbody to align the car’s movement with its steering.

• Adjusts linear velocity to reduce unwanted yaw.

• Only active when the car is grounded.

---

5. Traction Helper

• Purpose: Reduces over-rotation/spin at moderate slip angles.

• Implementation:

• Controlled by the tractionHelper boolean.

• Strength: tractionHelperStrength.

• Behavior:

• In TractionHelper():

• Calculates the angle between the car’s forward direction and its velocity.

• If the yaw angle and steering angle are opposed, reduces the sideways stiffness of the front wheels (via tractionHelpedSidewaysStiffness).

• This makes the car less likely to spin out at moderate slip angles.

---

6. Angular Drag Helper

• Purpose: Dynamically increases angular drag at higher speeds to reduce spin.

• Implementation:

• Controlled by the angularDragHelper boolean.

• Strength: angularDragHelperStrength.

• Behavior:

• In AngularDragHelper():

• Sets Rigid.angularDamping based on speed and the helper’s strength.

• Higher speeds result in more angular damping, making the car less likely to spin uncontrollably.

---

7. Steering Limiter & Counter-Steering

• Purpose:

• Steering Limiter: Reduces max steering input when sliding to prevent oversteer.

• Counter-Steering: Automatically applies counter-steer input when drifting.

• Implementation:

• Controlled by useSteeringLimiter and useCounterSteering.

• In SteeringAssistance():

• Calculates average sideways slip.

• If useSteeringLimiter is true, clamps steerInput based on slip.

• If useCounterSteering is true, sets counterSteerInput proportional to driftAngle and counterSteeringFactor.

---

8. Summary Table

| Feature | Toggle/Strength Fields | Main Method(s) | Effect | |---------------------|-------------------------------|------------------------|------------------------------------------------------------------------| | ABS | ABS, ABSThreshold | (Wheel logic) | Modulates brake to prevent lockup | | TCS | TCS, TCSStrength | (Wheel/engine logic) | Reduces torque to prevent wheel spin | | ESP | ESP, ESPThreshold, ESPStrength | ESPCheck, Wheels | Detects/corrects under/oversteer, applies corrective braking/torque | | Steering Helper | steeringHelper, steerHelper* | SteerHelper | Applies torque to align velocity and steering | | Traction Helper | tractionHelper, tractionHelperStrength | TractionHelper | Reduces front wheel grip to prevent spin at moderate slip | | Angular Drag Helper | angularDragHelper, angularDragHelperStrength | AngularDragHelper | Increases angular drag at high speed | | Steering Limiter | useSteeringLimiter | SteeringAssistance | Reduces max steering input when sliding | | Counter-Steering | useCounterSteering, counterSteeringFactor | SteeringAssistance | Adds counter-steer input when drifting |

---

In summary:

Each assist feature is modular, can be toggled or tuned, and works together to provide a realistic, stable, and user-friendly driving experience. The actual intervention (e.g., torque/brake modulation) is often handled in the wheel or engine logic, with this class orchestrating the detection and activation of each assist.