Changes between Initial Version and Version 1 of CarSettings

Timestamp:

2011-09-17 12:23:08 (13 years ago)

Author:

edy

Comment:

--

CarSettings

@@ +1 @@
+{{{ #!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. [CarInput](wiki:CarInput) 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 [CarInput](wiki:CarInput) 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/unity/offroader.html
+}}}