{{{ #!Markdown

# CarSettings

Optional script that provides high-level properties for configuring the vehicle's features and driving aids. Controls specific properties at [CarControl](wiki:CarControl) for implementing these features. [CarMain](wiki:CarMain) and [CarTelemetry](wiki:CarTelemetry) read values here for displaying their data.

This script is added to the root GameObject of the vehicle, besides to the [CarControl](wiki:CarControl) script.

#### Properties of CarControl controled here:

>autoMotorMax  
autoBrakeMax  
autoSteerLevel  
motorBalance  
motorForceFactor  
antiRollLevel

These properties of [CarControl](wiki:CarControl) cannot be modified when the CarSettings script is enabled (they revert to the values calculated here). You must use the parameters of CarSettings instead.

## Vehicle's available features

__Description__: intended for the name or denomination of the vehicle. Used by [CarMain](wiki:CarMain) for displaying the vehicle's name at the dashboard.

__hasABS__: the vehicle has anti-blocking brakes. Wheels don't lock when braking.

__hasTC__: the vehicle has traction control. No burnouts or throttle-powered drifting are possible.

__hasESP__: the vehicle limits its steering angle with speed. Avoids the front tires' sideways friction to surpass their maximum grip value, increasing stability.

__hasTractionModes__: defines whether the drive wheels can be configured in-game:

>0: fixed drive axle, no wheel drive can be changed.  
1: can switch among the main drive axle (_mainTractionAxle_, see below), and 4x4 full wheel drive only.  
2: can switch among front axle, rear axle, and 4x4 full wheel drive.  

__mainTractionAxle__: 0 front, 1 rear, 2 both (4x4). The drive axle can be changed or not according to the previous _hasTractionModes_ value.

__hasVariableStabilizer__: defines whether the anti-roll bars' rigidness can be configured in-game.

__mainStabilizerMode__: stabilizer mode to be used on startup and when the previous _hasVariableStabilizer_ value is false:

>0: auto - chooses the mode according to the vehicle's speed  
1: offroad  
2: comfort  
3: sport  
4: stabilizer bars disabled - vehicle's stability based on individual wheel's suspension only  

The anti-roll bars or stabilizer bars make the vehicle more difficult to roll over in turns. _Offroad_ is the softest mode, good for low speeds and bumpy terrains. _Sport_ is the most rigid mode, good for high speeds and race tracks.

## Vehicle's in-game settings

These settings are suitable to be changed in-game. They will have effect or not according to their availability defined before. In the [Live Demo][1] these properties are controlled with the keys 1-5.

__abs__: enables the anti-blocking brakes. Wheels don't lock when braking.

__tc__: enables the traction control. No burnouts or throttle-powered drifting are possible.

__esp__: enables the limit of the steering angle with speed. Front wheels won't slide when steering at high speeds.

__tractionAxle__: defines the drive axle:

>0: front  
>1: rear  
>2: 4x4 full drive  

__stabilizerMode__: configures the rigidness mode for the anti-roll bars:

>0: auto - chooses the mode according to the vehicle's speed  
1: offroad  
2: comfort  
3: sport  
4: stabilizer bars disabled - vehicle's stability based on individual wheel's suspension only  

The anti-roll bars or stabilizer bars make the vehicle more difficult to roll over in turns. _Offroad_ is the softest mode, good for low speeds and bumpy terrains. _Sport_ is the most rigid mode, good for high speeds and race tracks.

## Tunning parameters

__stabilizerFactor__: multiplier for the anti-roll bars' rigidness. Allows to fine-tune the vehicle's stabilization without having to reconfigure the properties at the AntiRollBar scripts. 1.0 is the original value, 2.0 doubles the rigidness, 0.0 disables the anti-roll bars.

__espLevel__: influence of the ESP feature (limits the steering angle with speed) on the steering angle limit. 

- 1.0 is the original value. Avoids the front wheels to surpass their maximum sideways grip.
- <1.0 reduces the influence. The less value, the more the front wheels are allowed to surpass their point of maximum sideways grip. 0.0 is the same as disabling the ESP.
- \>1.0 multiplies the influence. The more value, the less steering angle is allowed when increasing the speed.

## Other

__bypassTC__: allows the "bypass the traction control (TC)" feature without having to deal with the _esp_ property.

__serviceMode__: disables the script. Used from _CarTest_ for retrieving the vehicle's raw data.


[1]: http://www.edy.es/dev/vehicle-physics/live-demo
}}}