Cars – Suspension

Alternative ways of applying torque to suspension (fix for Kunos bug that caused inaccuracies with anti-effects geometry)

suspensions.ini

[_EXTENSION]
TORQUE_MODE_EX=0 ; options: 0, 1, 2 --- 0 is default, 1 is broken, 2 recommended

---

Fix for progressive spring rates (Kunos bug)

suspensions.ini

[_EXTENSION]
FIX_PROGRESSIVE_RATE=1

---

New double-wishbone suspension extension (including input for motion ratio lookup tables, bumpstop lookup tables, progressive rate fix, with more to come)

Example implementation:

suspensions.ini

[_EXTENSION]
USE_DWB2=1

[FRONT]
MOTION_RATIO=motion_ratio_f.lut    ;motion ratio lookup table (deflection from zero-point|motion ratio)
BUMP_STOP_LUT=bsf.lut    ;deflection|force - setup adjustments to come

[HEAVE_FRONT]
MOTION_RATIO=motion_ratio_hf.lut
BUMP_STOP_LUT=bshf.lut

[REAR]
MOTION_RATIO=motion_ratio_r.lut
BUMP_STOP_LUT=bsr.lut

[HEAVE_REAR]
MOTION_RATIO=motion_ratio_hr.lut
BUMP_STOP_LUT=bshr.lut

---

New labeled spring adjustments for cars using DWB2

Example implementation: note: suspensions.ini format does not change. setup.ini

[SPRING_LF] ; LF, RF, RR, LR - replaces old SPRING_RATE_LF entry
SHOW_CLICKS=0
TAB=SUSPENSIONS
NAME=Spring Rate LF
LUT=suspension_springs.lut ; format: name|rate
POS_X=0
POS_Y=1
HELP=HELP_LF_WHEELRATE ; same as vanilla AC options, for now..
DISPLAY_VALUE_IN_BRACKETS=1 ; 1 - displays value in brackets next to name in setup window.

---

Added anti-roll bar motion ratios

---

New labeled anti-roll bar adjustments for extended cars

Example implementation:

suspensions.ini

[ARB]
EXTEND=1 ; required to enable extended ARBs
FRONT_MOTION_RATIO=1.0
FRONT=100000 ; Front anti-roll bar stifness in N/m
REAR_MOTION_RATIO=1.0
REAR=10000 ; Rear anti-roll bar stifness in N/m

note: setup.ini entries not required for motion ratios to function, but the EXTEND line under [ARB] is.

setup.ini

[ARB_F] ; F, R - replaces old vanilla AC entry
SHOW_CLICKS=0
TAB=SUSPENSIONS
NAME=ARB Front
LUT=suspension_arb_front.lut ; format: name|rate
POS_X=0.5
POS_Y=0
HELP=HELP_FRONT_ARB ; same as vanilla AC options, for now...
DISPLAY_VALUE_IN_BRACKETS=0 ; 1 - displays value in brackets next to name in setup window.

---

Steering ratio setup adjustments** (note: breaks AI and animations, so not recommended)

Example implementation:

setup.ini

[STEERING_RATIO]
SHOW_CLICKS=0
TAB=SUSPENSIONS ; desired tab
NAME=Steering Ratio
LUT=suspension_steer.lut ; format: display_name|ratio
POS_X=0.5
POS_Y=4
HELP=NULL ; no suitable option at the moment
DISPLAY_VALUE_IN_BRACKETS=1 ; 1 - displays value in brackets next to name in setup window.

---

Adjustable double wishbone suspension geometry (requires DWB2)

Example implementation:

setup.ini

[FRONT_GEOMETRY]
SHOW_CLICKS=0
TAB=SUSPENSIONS
NAME=Front Geometry
LUT=suspensions_setup_front_geometry.lut    ; name|index
GEO_0=suspensions_front_1.ini    ; ini file with the changed items (options: hub_mass and all pickup points) - same format as suspensions.ini - only modified items are required (if values are not present, it will load from the suspensions.ini)
GEO_1=suspensions_front_2.ini
DEFAULT=0    ; default GEO_ index to load
POS_X=0.5
POS_Y=3
HELP=NULL ; not available currently

[REAR_GEOMETRY]
SHOW_CLICKS=0
TAB=SUSPENSIONS
NAME=Rear Geometry
LUT=suspensions_setup_rear_geometry.lut
GEO_0=suspensions_rear_1.ini
GEO_1=suspensions_rear_2.ini
DEFAULT=0;
POS_X=0.5
POS_Y=4
HELP=NULL

---

Damper Lookup tables for cars using DWB2 suspension (Note: motion ratio will be applied to dampers)

Example implementation:

suspensions.ini

[_EXTENSION]
DAMPER_LUTS=1    ; currently required

dampers.ini Note: New File

[HEADER]
ENABLE=1 ; 0 to disable

[FRONT]
BUMP_SLOW_0=damp_bump_slowf_0.lut   ;format: speed (m/s) | force (Newtons - sign does not matter).
BUMP_SLOW_4=damp_bump_slowf_4.lut
BUMP_SLOW_9=damp_bump_slowf_9.lut    ; note: you must at least have a lut for your first and final adjustment (if not adjustable, you only need the _0 entry). Linear interpolation between surrounding entries will be done for entries that are not present (1-3 and 5-8 in this example).
REBOUND_SLOW_0=damp_reb_slowf_0.lut
REBOUND_SLOW_4=damp_reb_slowf_4.lut
REBOUND_SLOW_9=damp_reb_slowf_9.lut
BUMP_FAST_0=damp_bump_fastf_0.lut
REBOUND_FAST_0=damp_reb_fastf_0.lut

setup.ini

[DAMPER_BUMP_LF]    ; the names are the same as Kunos entries except DAMP has been replaced by DAMPER
SHOW_CLICKS=2
TAB=DAMPERS
NAME=Bump
MIN=0    ; minimum setting
MAX=11    ; maximum setting
STEP=1
DEFAULT=7   ; default setting
POS_X=0
POS_Y=0
HELP=HELP_LF_DAMPER_BUMP

---