[ BETA ] Mobility Update v2.11.6-beta

[Tyunge]

ACF MOBILITY UPDATE V1.0.0-beta

This update brings new logic to ACF3 mobility. This update will NOT affect existing dupes that are using the legacy mobility components. Updated components must be spawned new as they do not share the same class as legacy components.

Legacy components cannot be auto updated by using the ACF spawner tool to use the new mobility logic. THEY MUST BE SPAWNED NEW

Legacy Components CANNOT be linked to updated components and vice-versa.

Please view the Other Changes sections for how to enable/disable this update, and to spawn updated components.

**this update is experimental and may have adverse effects to your health
**please be patient as bugs may increase in prevalence to its stage of development

Engine Component Changes

• Engine Feedback - engine rpm is matched to gearbox rpm
• Engine Braking - braking torque is applied to wheels in the absence of throttle input
• Engine Over-rev - engines are no longer limited to their redline
• Improved Flywheel Response - flywheel mass has an improved response to sudden load
• Idle Throttle - engines will roll in gear

Gearbox Component Changes

• Gear Ratios Use Realistic Ratios - gear ratios no longer follow a 0 ...1 format
• Improved Clutch Simulation
• Gearboxes Have RPM - rpm is retrieved from connected wheels relative to gear ratio
• Differentials are Open - differentials are no longer limited slip
• Ratio Converter -Converts old ratios to new ratios and vice-versa
• Past Data -Ability to paste data from the copy tool to gearbox ratios

Other Changes

• New Server Setting - server setting to allow client spawning of new engine components
  - New Client Setting - client setting to spawn updated components
  - New Client CMD - acf_mobilityupdate can be used to enabled/disable this update
  - Update Eligibility - notification description added to all engines and gearboxes.
  !
  

Future Updates

• Limit slip slider added to differentials
• Automatic Gearbox Update
• CVT Gearbox Update
• Double Differential Update
• Auto Clutch
• Engine Over Rev Damage
• Clutch Slip Due to Over Torque
• Clutch Damage

For Developers

Creating Eligible Components
To create or update existing engine addons, all engines must have the following variables in their registry:

• Displacement
• FlywheelMassUpdate

Important Info
Updated mobility components are NOT acf_engine acf_gearbox classes.
Updated mobility components are acf_engine_update acf_gearbox_update classes.
The reason for this was to create a separation of legacy and updated mobility components to maintain a stable mobility components as changes are made to the mobility update.
The legacy components should be considered depreciated.

[Tyunge]

I notice the calcMass test is failing for KEShove, I was told that it was caused from an unrelated change to KEShove. Is there something I need to update or change for this pull request?

[thecraftianman]

Merge the latest commit from dev and the tests should be good now

[Tyunge]

This also closes #136 & #103 bug and suggestion

[TwistedTail]

I have a couple of suggestions but I wasn't entirely sure with bringing them up because they could certainly end up being controversial.

One of the topics that has been brought up in the discord when it comes to mobility components is the inconsistency on the units used by them:

• Clutches use 0-1
• Throttle uses 0-100
• Brakes use 0-100 unless you need more then it goes all the way up to 5000 (iirc)

Which makes me think, would it be possible to standarize all these inputs to use a single unit? Changing Throttle and Brake to work with 0-1 would certainly make everything much simpler for the end user, but it'd also break every single old contraption prior this change.

[Tyunge]

Yeah I could make them all use a 0-1 value and for brakes to use 0-50 to keep it relative. The input manager for throttle converts 0-100 to a 0-1 value immediately anyways so that would make the code a lot more simple.

Not sure how the manager for brake converts but i assume it’s the same. I could make a maximum brake force slider for gearboxes so that the brake input could also default to 0-1.

It wouldn’t necessarily break old contraptions, but if they did use say 50 throttle it would be similar to using 100% throttle since the value would be clamped to 1 as a maximum.

I do like this update because it would allow users to use nothing but a chair and a wire POD controller for mobility if they don’t have access to ecu codes