Handling Replacement (Library) 1.1.0

[greenie]

https://www.gta5-mods.com/tools/handlin ... oad/175563

Handling Replacement is a library/tool for script developers, to manage vehicle handling changes in a non-intrusive way. It clones the handling of a vehicle, and assigns the copy to the vehicle, so only that vehicle is affected by changes to its handling data.

This is useful for scripts that want to continuously vary certain handling parameters, without affecting other instances of that vehicle model.

An example is my variable drive bias, which changes fDriveBiasFront constantly.

Installation
Grand Theft Auto V (b1868+) required.
Extract HandlingReplacement.asi to GTA V's main folder.

Development
Check HandlingReplacement.h on the repository for the three functions. The asi loader should already have loaded and initialized things, so one can just start using it right away.

An usage example can also be found there.

GitHub repository

If you have any questions, hop on my Discord server.

Compatibility
Changes made to the original CHandlingData instance activation on a vehicle, will not be applied to that vehicle any more
Changes made to the CHandlingData from the vehicle instance itself, will apply normally. These changes do not propagate to the original CHandlingData instance.
As with the default method of directly changing handling data, other scripts can interfere when multiple scripts are setting the same fields.
No CHandlingData is provided, use your own one.


The following list shows scripts currently using this library and what fields they access. Please let me know when you want to use the library, I'll update the list so you know what fields might be affected.

Manual Transmission - (5.0.0)
fDriveBias - constantly written to when variable AWD is enabled

Real Time Handling Editor - (2.0.1)
Everything - depending on setting, original or replaced handling may be edited at any time

(Your script) - (Starting version using it)
(CHandlingData field) - set constantly, periodically, occasionally



Acknowledgements
FiveM - On some bits on how to properly replace/clone subhandlingdata, and the rage alloc/free.

Changelog

1.1.0
* Compatibility patch for game version v1.0.2845.0 and newer
* Tested on v1.0.3337.0

Remarks:

This is a worse solution than 1.0.0:

* Leaks 1.5kB memory every instance (memory does not deallocate)
* SubHandlingData is NOT replaced anymore, the original instance is active

This is due prior method of re-using FiveM's usage of using GTA V's allocator not being functional anymore (after... 2845), and me having not the slightest clue how to properly do this again. I just need a release out of the door to fix Manual Transmission crashing upon usage of dynamic AWD, and this (sloppily) fixes it.

If you know how GTA V's allocator can be used, I'd be happy to hear it and release a proper update. Check https://github.com/ikt32/GTAVHandlingReplacement for the source code.