Brakes
The Brakes component manages brake torque distribution to wheels, handbrake operation, and automatic braking behaviors.
Properties
| Property | Description |
|---|---|
Max Torque |
Maximum brake torque in Nm that can be applied to each wheel. Avoid excessively high values to prevent physics jitter. Adjust per-axle bias through WheelGroup brake coefficients |
Actuation Time |
Time in seconds for brakes to reach full actuation. Simulates hydraulic brake system response time. Low (0.05-0.1s): Quick for racing, Medium (0.1-0.2s): Realistic car-like response, High (0.3-0.5s): Sluggish for heavy vehicles |
Handbrake Type |
Standard: Active only while input is held (good for racing/drifting). Latching: Toggle on/off with each press (parking brake behavior) |
Brake While Disabled |
Applies brakes when the vehicle component is disabled to prevent rolling |
Brake While Idle |
Applies brakes when in neutral with no throttle input to prevent rolling when parked |
Brake On Reverse Direction |
Automatically applies brakes when movement direction opposes input direction (e.g., rolling backwards while pressing forward throttle) |
Off-Throttle Braking
| Property | Description |
|---|---|
Brake Off Throttle Intensity |
Braking force as percentage of max torque (0-1) when throttle is released. Simulates engine compression braking or EV regenerative braking. Values: 0.0 = no braking (coasts freely), 0.1-0.3 = light (gasoline compression), 0.4-0.7 = medium (diesel or strong regeneration), 0.8-1.0 = strong (low gear or max regeneration) |
Events
| Event | Description |
|---|---|
onBrakesActivate |
Called when brakes are applied |
onBrakesDeactivate |
Called when brakes are released |
Brake Torque Modifiers
External systems (ABS, ESC, stability control) can register modifier functions that multiply the final brake torque:
- 1.0 = No modification (neutral)
- 0.0-0.99 = Reduce braking (ABS intervention)
- 1.01+ = Increase braking (brake assist)
All modifiers are multiplied together for the final coefficient.