TCS Module

TCSModule inspector

Traction Control System (TCS) prevents wheel spin during acceleration by applying counter-torque when longitudinal slip exceeds a threshold. This improves traction, vehicle stability, and reduces tire wear on slippery surfaces.

How It Works

TCS monitors driven wheels for excessive slip during acceleration. When slip exceeds the threshold, the system applies counter-torque at the friction level to reduce wheel spin. Only powered wheels are monitored (FWD, RWD, or AWD configurations).

Settings

Property Range Description
Slip Threshold 0-1 Longitudinal slip value at which TCS activates at high speeds. Default: 0.1
Low Speed Slip Threshold 0-1 More permissive slip threshold at low speeds to prevent false triggers during turns. Default: 0.25
Lower Speed Threshold m/s Minimum speed for TCS activation. Below this, TCS is disabled. Default: 2.0
Upper Speed Threshold m/s Speed at which TCS reaches full intensity. Threshold interpolates from low to high between lower and upper speeds. Default: 10.0
Active - Read-only indicator showing if TCS is currently limiting power

Typical Values

Comfort/Safety (maximum traction):

slipThreshold: 0.06
lowSpeedSlipThreshold: 0.20
lowerSpeedThreshold: 1.5
upperSpeedThreshold: 8.0

Sport (balanced):

slipThreshold: 0.12
lowSpeedSlipThreshold: 0.25
lowerSpeedThreshold: 2.0
upperSpeedThreshold: 10.0

Performance (allows wheel spin):

slipThreshold: 0.20
lowSpeedSlipThreshold: 0.35
lowerSpeedThreshold: 3.0
upperSpeedThreshold: 12.0

Behavior Notes

  • Only monitors powered wheels (those receiving motor torque) with per-wheel control at the friction level
  • Slip threshold automatically interpolates from lowSpeedSlipThreshold to slipThreshold as speed increases from lowerSpeedThreshold to upperSpeedThreshold
  • Higher threshold at low speeds prevents false triggers from differential behavior during turns
  • Ignores slip during gear changes to prevent false triggers
  • TCS slip threshold should typically be lower than ABS threshold since acceleration slip peaks at lower values
  • Works independently of ABS and ESC modules

Events

  • onTCSActive - Unity event triggered each physics frame while TCS is active. Use for dashboard lights, engine sound changes, or telemetry.

Scripting

// Check if TCS is currently active
bool isTcsActive = vehicleController.moduleManager.tcs.active;

// Adjust thresholds at runtime
vehicleController.moduleManager.tcs.slipThreshold = 0.08f;
vehicleController.moduleManager.tcs.lowSpeedSlipThreshold = 0.20f;

// Change speed range for interpolation
vehicleController.moduleManager.tcs.lowerSpeedThreshold = 1.5f;
vehicleController.moduleManager.tcs.upperSpeedThreshold = 8.0f;

// Disable TCS for drift mode
vehicleController.moduleManager.tcs.Disable();