The Real Airbag Suspension mod for Grand Theft Auto 5 is an enhancement for the game's vehicle handling function. With this mod, players can immerse themselves into a realistic driving experience by making suspension modifications in their in-game vehicles. Genuine to its name, the mod mimics the function of actual airbag suspensions found in real-world vehicles, drastically affecting the way cars react to bumps, jumps, and other fluctuations on the road.

This mod also includes gamepad support, which means players using a gamepad controller can control the suspension settings with ease. They can raise or lower the suspension according to their preference or needs, just as one might in a real-world customized car with airbag suspension. Whether lowering for show at a car meet or raising for an off-road journey, this mod adds a new layer of customization and realism to the vehicles in Grand Theft Auto 5. 

Please note that proper installation of this mod requires a good understanding of how to modify GTA 5 files, as incorrect installation might result in game instability.

Should work with update 1.0.678.1, and up to the Doomsday update. Might work all the way back to update 1.0.335.2, but it is not tested.

**You MUST run GTA 5 as Administrator or you will get an error!**

What is it?
This is now real on-the-fly suspension editing with custom sounds for lowering and raising your suspension. Keyboard and Gamepad support. Customize-able keys and buttons.

Check out @ikt's VStancer for in-game Camber, Track width, and Suspension height editing, complete with multiple preset saving and loading :)

The pre-2.0 versions of this script are like @ImNotMental's VStanced, @ikt's Slam It mod , and the feature of the same name in MAFINS' Menyoo mod menu. You can still use this method if you want by disabling the new system in the ini settings.

Features
- Choose between on-the-fly handling.meta suspension editing or fake/simulated suspension editing.
Note: You can actually set your default suspension with the real/handling.meta suspension editing, then modify it further with the simulated suspension editing.
- Choose 2 custom sounds that will play when you raise or lower your vehicle's suspension.
- Customize the volume of each sound to your liking, or disable it completely.
- Customize the speed at which your suspension changes. A lower number makes for a smoother animation.
- Enable or disable my Automated Suspension Adjustment system (only for the simulated suspension editing). This system changes your suspension as you drive, depending on conditions such as steering angle and speed.

Controls - all modifiable in the ini!
-For Keyboards-
Raise Suspension: T
Lower Suspension: Y
Reset Suspension: U

-For Gamepads-
Xbox-type controllers
Raise Suspension: X + Leftstick UP
Lower Suspension: X + Leftstick DOWN
Reset Suspension: X + A

Playstation-type controllers
Raise Suspension: Square (☐) + Leftstick UP
Lower Suspension: Square (☐) + Leftstick DOWN
Reset Suspension: Square (☐) + Cross (X)

Notes about the real/on-the-fly suspension system
- Raising the suspension too high can make your vehicle roll over easily when turning at certain speeds. (obviously)
- You cannot edit the suspension of motorcycles (I did not thoroughly test this, however). Use the old/fake suspension system if you'd like to do that.
- Lowering the suspension too low will make the wheels act weirdly, and you will not be able to drive. Use the Reset Suspension key/button to return your suspension to normal.
- Lowering the suspension to a certain point will make the vehicle very drifty. Not sure how to fix this, if it's even something that needs fixing.
- Since this on-the-fly method involves editing the handling.meta in the game memory, all vehicles that are the same model will have the suspension changes. Ex: if you raise the suspension of a banshee, all banshees will have the same suspension.

Notes about the older/"fake" suspension system
-The vehicle becomes easier to turn the lower the suspension is, but the ASA system will adjust your suspension to the default handling the longer you turn.
-Some vehicles become really "drifty" (see the video) when you raise the suspension too much, some just outright slide. The ASA system will make it much easier to turn when you use the handbrake.
-Motorcycles can do it too! A low suspension makes turning really quick (unrealistically), but raising the suspension can work pretty well. Of course, the ASA system will adjust your suspension accordingly.

Planned Features
- Add seperate suspension adjustments for the front and back of a vehicle. Suggested by @imyluck Update: Might be possible; anyone know how it is done in the handling.meta file?

- Add scraping sounds and sparks when suspension is really low. Suggested by @friedSOY This is possible, but I am having a hard time locating the in-game sound and fx for this. If anyone has any info on this, it would be greatly appreciated.

Requirements:
ScripthookV
ScripthookV.NET

Installation
Place the "scripts" folder in your GTA V directory where GTA5.exe is located

Credits:
stillhere,
Credits to ElyZium for the idea, for beta testing, and for finding the first custom sound! Of course, credits to whoever recorded/created the sound.
Credits to Remix for certain suggestions and testing as well.
For the on-the-fly suspension editing method, credits go to ikt for his Real Time Handling Editor source (and for personally helping me!) and to leftas for his vehicle struct research!