Struct DifferentialConfig

Namespace

LibreRally.Vehicle.Physics

Assembly

LibreRally.dll

Configuration for a single differential unit. Used for front, rear, or center differentials in an AWD drivetrain.

public struct DifferentialConfig

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

ValueType.ToString()

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Fields

BiasRatio

Bias ratio for limited-slip differentials (typically 1.5–4.0). Defines the maximum torque ratio between the two output shafts: T_slow / T_fast ≤ biasRatio. A value of 1.0 = open; higher = more locking tendency. Reference: Milliken, RCVD §6.4.2.

public float BiasRatio

Field Value

float

CoastLockingCoefficient

Locking coefficient used while coasting/engine braking (input torque < 0). If zero, LockingCoefficient is used for both directions.

public float CoastLockingCoefficient

Field Value

float

LockingCoefficient

Locking coefficient for clutch-type LSDs (0.0–1.0). Controls how aggressively the LSD locks under acceleration. 0 = pure open behaviour, 1 = immediate full lock.

public float LockingCoefficient

Field Value

float

PreloadTorque

Base clutch preload torque for limited-slip differentials (N·m). Applied as baseline locking before torque-proportional lock is added.

public float PreloadTorque

Field Value

float

Type

Type of differential behaviour.

public DifferentialType Type

Field Value

DifferentialType

Methods

CreateLimitedSlip(float, float, float, float)

Creates a default limited-slip differential with typical rally bias.

public static DifferentialConfig CreateLimitedSlip(float biasRatio = 2.5, float lockingCoeff = 0.3, float coastLockingCoeff = 0, float preloadTorque = 0)

Parameters

biasRatio float

Maximum torque bias ratio between the two outputs.

lockingCoeff float

Locking coefficient under power.

coastLockingCoeff float

Locking coefficient while coasting or engine braking.

preloadTorque float

Preload torque applied before torque biasing.

Returns

DifferentialConfig

A limited-slip differential configuration.

CreateLocking()

Creates a locking differential.

public static DifferentialConfig CreateLocking()

Returns

DifferentialConfig

A fully locking differential configuration.

CreateOpen()

Creates a default open differential.

public static DifferentialConfig CreateOpen()

Returns

DifferentialConfig

An open differential configuration.