=====================================
 Weapon Crate Drop Mod for GTA V StoryMode – README
=====================================

📦 Version: 1.0  
🛠 Author: MO3IZO  
🌐 GitHub: https://github.com/Mouataz86/WeaponCrateDrop  

**** IMPORTANT ****  
⚠️ DO NOT USE THIS MOD IN ONLINE MODE! DOING SO MAY RESULT IN A PERMANENT BAN.  
Make sure Rockstar Launcher and BattleEye are not running in online mode.

-------------------------------------
📋 What is This Mod?
-------------------------------------
**WeaponDrop** is a simple and immersive GTA V mod that allows players to spawn a weapon crate near their character with a single key press.  
The crate provides a randomized weapon from a predefined list, along with randomized ammo.
Perfect for roleplay, survival scenarios, or quick loadouts.

Further updates are coming! happy to receive any suggestion!

-------------------------------------
🧩 Features
-------------------------------------
✔ Spawn a supply crate using a hotkey (default: **F6**)  
✔ Automatically gives a random weapon and ammo when picked up  
✔ Crate despawns if the player moves more than 10 meters away  
✔ Prevents crate drop while:
   • Driving  
   • Flying  
   • Boating  
   • Falling  
   • Swimming  
✔ Customizable settings via `.ini` file  
✔ Only 1 crate can exist at a time  ( You can edit the max but I don't know if game can handle that )

Everything in this mod has a warning & Error trigger, If any problem occur a notification will be shown.

-------------------------------------
🧩 Requirements
-------------------------------------
To use this mod, you need:

✔ Grand Theft Auto V (PC version)  
✔ ScriptHookV by Alexander Blade  
✔ ScriptHookVDotNet v3.x (latest nightly recommended)

🔗 ScriptHookVDotNet:  
https://github.com/crosire/scripthookvdotnet

🔗 SHVDN Nightly Release (v3.7.0+):  
https://github.com/scripthookvdotnet/scripthookvdotnet-nightly/releases

-------------------------------------
📁 Installation
-------------------------------------
1. Create a `scripts` folder in your GTA V game directory if it doesn’t exist.  
2. Copy the following files into the `scripts` folder:
   • `WeaponDrop.dll`  
   • `WeaponCrateDrop.ini`  
3. Launch GTA V.  
4. In-game, press [F6] to drop a crate.  
5. Walk into the crate to collect your randomized weapon and ammo.

-------------------------------------
⚙ Configuration (WeaponCrateDrop.ini)
-------------------------------------

[General]
DropKey=F6
EnableNotifications=true
CrateModel=prop_box_wood05a
PickupDistance=2.5
MinAmmo=30
MaxAmmo=150
MaxCrates=1
MaxDistance=10.0

[Weapons]
Weapon1=SMG
Weapon2=CarbineRifle
Weapon3=CombatPistol
Weapon4=Knife
