Manual DriveBy Refixed

This mod allows free aiming and shooting, as well as throwing grenades and using sprayable weapons, from inside any vehicle.
It is based on MixMods version (03/07/22) of Manual Driveby Remake, but practically remade from scratch, fixing crashes, numerous bugs and adding new features.

---- Update v.26.08.25

- Minor Fixes

---- Update v.26.08.03

- Added the ability to use the camera inside vehicles (taking snapshots). For zooming, use my Weapon Zoom Unlimited mod.
- Added sniper rifle support (uses the normal crosshair while in vehicles).
- Refixed the crosshair expansion bug and added an option to use the same weapon spread and crosshair expansion system as on foot.
- The original Rockstar code for this was somewhat unfinished, which caused excessively large crosshairs, especially when using the Desert Eagle.
- Fixed an issue where it was impossible to start a driveby in certain situations after stealing a car while using the DrIVe mod.
- Fixed the camera turning backwards when starting to aim from the vanilla first-person or cinematic view.
- Fixed grenades and other throwable weapons flying in the wrong direction while looking left or right using the side-look buttons.
- Improved the code for throwable weapons. Molotov cocktails are now less likely to break against your own vehicle.
- Many other minor fixes and improvements.
- Gamepad users:
  - Disabled drivebys in aircraft when using driveby control types 3, 4, 5, or 6, as they conflict with the left/right turning controls.
  - Fixed an issue where looking left/right was impossible in certain situations.
  - Fixed an issue where the camera could not be moved when using sprayable or throwable weapons in a vehicle with hydraulics.


---- REQUIREMENTS:

- Essentials Pack
  - https://www.mixmods.com.br/2019/06/sa-essentials-pack

- CLEO 4.4.4 or newer (already included in Essentials Pack), CLEO 5 recommended

- CLEO+ v1.2.0 or newer (a plugin for CLEO, already included in Essentials Pack)
  - https://www.mixmods.com.br/2023/10/cleoplus


---- INSTRUCTIONS:

- Delete any previous versions of "Manual Driveby Remake/ Refixed" completely.
- Place the folder "Manual Driveby Refixed" in your modloader directory   
- Open the file "DrivebySettings.ini" to customize everything to your liking

- If you want the old animations, replace the .ifp file with the one in the "optional" folder  
- For full vanilla animations, simply delete the .ifp file (not recommended, looks unrealistic)

- If you're using "Realistic Weapons Settings" mod then put the file "ManualDrivebyRefixed.cs" into the cleo folder of your game's root directory.

- If you're using "Advanced Aiming Mod", make sure you have set 'UPDATE_SETTINGS_PERMANENTLY 0' in aimingSets.dat 

- If you're using "Mixsets", set 'NoFixHandsToBars = 1' in Mixsets.ini to prevent a visual bug with stretched arms on bikes.

- I recommend using one of these mods that fix car animations because in vanilla the throwing animation looks buggy on bikes:
  - https://libertycity.net/files/gta-san-andreas/222557-animation-fix-new-car-anim-lcs-vcs.html
  - https://www.mixmods.com.br/2022/02/animation-fix-v1-5-corrigir-bugs-de-animacoes

- If aiming with your mouse doesn't work make sure that you have Silent Patch installed (included in Essentials Pack). Otherwise install this:
  - https://github.com/Bupropion78/mouse-fix

- Gamepad users: "ginput" recommended. If you use the controls layout 2, you must set driveby control type 5 or 6.

 
- For some extra fun, type the cheatcode 'MYNAMEISRAMBO' and see what happens and "MOMSREVENGE" if you want your homies to be like Rambo. ;)



---- FIXES FROM MANUAL DRIVEBY REMAKE:

- Fixed a possible crash, a camera zoom bug and visible crosshair when exiting vehicles
- Fixed crosshair getting larger after first shot
- Fixed automatic switching to submachine guns
- Fixed car moving while aiming and pressing 'E' or 'Q'
- Better gamepad support
- Fixed driveby shoot rate and missing reactions from NPCs
- Fixed an issue where nitro was triggered by shooting — now only the secondary fire button activates it  
- Fixed a conflict between bunnyhop and aiming on bicycles
- Fixed never falling off the bike while aiming


---- NEW FEATURES:

- Using throwable and sprayable weapons inside any vehicle (grenades, flamethrower etc)
- Using weapons in boats, helicopters, planes and trains
- Fully configurable key settings and mouse wheel support for weapon switching  
- Fully configurable shoot rate and availability for each weapon. Modders can use this to make any specific weapon selectable in vehicles  
- Recruiting gang members directly from within a vehicle, and provoking gang wars via driveby
- Aiming as a passenger
- Switching weapons during the missions "Just Business" and "End of the Line" 
- Option to automatically roll up car windows when exiting  
- Option to break the windshield when shooting forward  
- Keeps vanilla driveby available if you press the fire button before "look left/right"
- Option to disable manual driveby during missions  
- Option to exclude any vehicle from manual driveby  
- Enhanced camera options  
- Improved animations by ArtemQa146  
- Compatible with void’s "Modernized Driveby" mod  
- Compatible with the "Weapon Zoom Unlimited" mod
- Compatible with the "Easy Throw" mod


---- Known issue with First Person Mod v3.0/3.5:

- The camera turns backward when exiting aim mode in first-person view.  
- Some workaround options are included, but the issue must be fixed in the First Person Mod itself.
- Use "GFPSA" or "Ultimate First Person Mod". They are fully compatible.



---- Manual Driveby Authors:

- "Remake"
Original Author: ThirteenAG
Fixes and improvements: Junior_Djjr
Original .ifp Author: Zacthe_nerd

- "Refixed"
Author: CatchyKetchup
Improved .ifp Author: ArtemQa146
Contribution of memory addresses: vladvo

Special Thanks to ArmanCan, H4D3S_HUEHUE, KaiQ, Kaoru Tanamachi, BrandonBaja, vladvo, ArtemQa146, K29, Bennymax, Cattuba, cemeteryblunts, Reaper ... and all other people that suggested ideas and reported bugs :)