AUTHOR'S NOTE:

Immersive Pickups is a total overhaul of Grand Theft Auto V's pickups system for, as the name implies, immersion. Did you miss GTA IV's Pickups System? Or simply looking for a different, more immersive experience than what the game offers by default? Look no more, because this mod is tailored for you.





SUMMARY OF FEATURES:

- Organized all pickups.meta files and documented the main pickups.meta file to the best of my abilities (make sure Word Wrapping is turned off). This is thanks to all the people who have helped me become who I am today; without their teachings, my mods wouldn't exist. To all aspiring modders out there, I dare you to make this game even more beautiful than what the current community has made it to be!
- No scripts, purely file edits, so no dependencies nor performance issues! All you need is the base game (Not counting the extra Drop Weapons script made by jedijosh920, which is just an extra)
- Weapons now require button press to be picked up (E) on keyboard or (LB) with a controller. Say no more to unwanted weapons in your arsenal! 
- Refined collection range values so it's consistent with all pickups and more immersive for the player, now you need to be closer both in first person and third person to be able to pick stuff up
- Fixed/Added missing lines that R* failed to provide on several pickups, now they have proper first person pickup distance and definitive glow between FPS and TPS Camera Views
- Picked up weapons are now automatically equipped by the player
- All previously unobtainable weapons now have pickup data (Fire Extinguisher, Flare, Ball, and BZ Gas)
- Unique Ammo Types for Ray and Mk II Weapons! The Widowmaker will no longer refill when encountering a Normal Minigun from the ground, and likewise for the Mk II weapons when meeting their normal equivalents
- Enabled Physics for Money and Weapon Pickups! Collisions have been enabled so they react relative to external forces (e.g. falling from peds, getting hit by a vehicle, getting shot at by weapons, set on fire or thrown in the air from an explosion!) DISCLAIMER: This does NOT affect Health and Armour Pickups, they don't seem to be affected by the flag.
- Pickups now have some kind of health threshold so when damaged enough through shooting, setting them on fire, or causing them to explode, can lead to them becoming unobtainable.
- Added pickup effects! When shot, the fire extinguisher will spray CO2, the molotov will light a fire, the grenade would explode, teargas will spray gas, etc. Some guns also go boom!
- Gamepad/Controller vibrations now trigger for a fifth of a second when you obtain a pickup.
- Ability to drop weapons much like in Grand Theft Auto: Online via a SHVDN script, with a customizable hotkey (Thanks, jedijosh920!)
- Changed default money pickup to an alternate look for the cash pile that has only one stack of cash, much like in GTA IV.
- Clean installation method. Only touches update.rpf, and no redundant file replacements. Should be compatible with any mod excluding those that touch pickups.metas
- New entries for you vehicle modders (Does something with the mod installed, does nothing without the mod installed):

	REWARD_WEAPON_FIREEXTINGUISHER
	REWARD_AMMO_FIREEXTINGUISHER
	REWARD_WEAPON_BZGAS
	REWARD_AMMO_BZGAS
	REWARD_WEAPON_FLARE
	REWARD_AMMO_FLARE
	REWARD_WEAPON_BALL
	REWARD_AMMO_BALL
	REWARD_WEAPON_SNOWBALL
	REWARD_AMMO_SNOWBALL

- Supports all DLCs to date. Runs flawlessly on the latest patch, v1.0.2189.0 (The Cayo Perico Heist DLC) at the time of writing.
- OPTIONALS: Glowing Pickups, Non-Glowing Pickups, Different Money Pickups, Vanilla Ammo Types for Mk II Weapons, Vanilla Ammo Types for Ray Weapons
- EXTRAS: Glowing Pickups Config for kagikn's "Glowing Pickups" mod, Drop Weapons Script by jedijosh920





REQUIREMENTS:

- A copy of Grand Theft Auto V, recommended to be running AT LEAST Patch v1.50 or v1.0.1868.0 (Diamond Casino Heist DLC)
- OpenIV 





ABOUT THE INSTALLATION:

Automatic and Manual Installation methods are available. Instructions for Manual Install are located in their respective folders in the package. For the .OIVs, simply run (or open it with) OpenIV.

IMPORTANT!!! Automatic installation is known to not work for all users, so some of you will be forced to manually install the mod. So be sure to backup your update.rpf before attempting automatic installation.





COMPATIBILITY:

Immersive Pickups should be compatible with any mod, including weapon mods, save any other mod that alters pickups.meta files.





RECOMMENDED MODS:

These mods are not required, nor are they dependent of each other, but would greatly enhance the experience with this mod installed:

Glowing Pickups by kagikn: https://www.gta5-mods.com/scripts/glowing-pickup
Better Weapon Ragdoll by Cloud_Power: https://www.gta5-mods.com/scripts/better-weapon-ragdoll
Disarm by jedijosh920 or DisarmV by desuissparta: https://www.gta5-mods.com/scripts/disarm





CREDITS:

Take some time to appreciate the community and all the hard work they've put out for this game!

- Rockstar Games: for the original models and this masterpiece of a game!
- OpenIV Team: for making this, and a lot of awesome mods possible through OpenIV
- Stryfaar: Idea, Research, Documentation, Meta/XML Editing
- jedijosh920: Drop Weapons Script
- 420x420: Retextures from older versions of the mod (now removed due to lore inconsistencies), you can still find his money retexture in his mod page, though!
- Pyri: Testing, Screenshots, and Video Showcase
- Reyser: Testing & Screenshots
- A_mbien_t: Testing & Screenshots
- w/: Testing & Screenshots
- Razed: Testing & Screenshots
- theNGclan: Testing
- 11john11: Testing
- bravo-one-charlie: Testing 

Special thanks to alexguirre for discovering two hidden flags, and jevi for making it known to me. Currently, their effect/function is still unknown but they are documented inside pickups.meta





PERMISSIONS:

This mod is exclusive for download at GTA5-Mods.com only. Downloads from other sites is stolen. You are allowed to modify this mod and release a version of it as you please so long as you agree to the following conditions: 1) I am properly credited, 2) The comments stay in tact, 3) It isn't an exact duplicate of this mod/a straight reupload, 4) The original mod page is linked, 5) jedijosh920's script stays exclusive to this mod, 6) It is uploaded in GTA5-mods.com, 7) It is not used for commercial, financial, or personal gain, 8) These terms are adapted to your mod. Immersive Pickups is, and always will be, free for everyone to download and enjoy.