=====================================
💸 MoneyDrop Mod for GTA V StoryMode – README
=====================================

📦 Version: 1.2  
🛠 Author: MO3IZO  
🌐 GitHub: https://github.com/Mouataz86/MoneyDrop

⚠️ IMPORTANT – DO NOT USE ONLINE!
This mod is for **Single Player Story Mode only**.  
❗ Using it in GTA Online will likely result in a permanent ban.  
✅ Make sure any anti-cheat systems like BattleEye are disabled.

-------------------------------------
📋 What is This Mod?
-------------------------------------
**MoneyDrop** is a clean, customizable GTA V mod that allows you to drop **money briefcases** with a hotkey. Walk into them to collect the cash instantly.

Now includes an **in-game configuration menu** for quick changes, limits, and toggles.

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

✔ Grand Theft Auto V (PC)  
✔ [ScriptHookV](http://www.dev-c.com/gtav/scripthookv/) by Alexander Blade  
✔ [ScriptHookVDotNet v3.7.0+](https://github.com/scripthookvdotnet/scripthookvdotnet-nightly/releases)  
✔ [LemonUI SHVDN3 version](https://github.com/LemonUIbyLemon/LemonUI)

📝 Make sure you're using **SHVDN3** build and the correct `LemonUI.SHVDN3.dll` in your `scripts` folder.

-------------------------------------
📁 Installation
-------------------------------------
1. Go to your GTA V root directory. Make sure you have a `scripts` folder. If not, create one.

2. Place these files into the `scripts` folder:
   • `MoneyDrop.dll`  
   • `MoneyDrop.ini`  
   • `LemonUI.SHVDN3.dll` (required for the menu)  

3. Launch GTA V (Story Mode only).

4. In-game controls:
   • Press `F5` to drop a money briefcase (default)  
   • Press `F10` to open the mod configuration menu (can be changed)

-------------------------------------
⚙ Configuration (MoneyDrop.ini)
-------------------------------------
You can edit the configuration manually or from the in-game menu (F10).

**File:** `scripts/MoneyDrop.ini`

```ini
[General]
DropKey=F5
MenuKey=F10
ModEnabled=true
MaxBags=3
MoneyAmount=2500
ModelName=prop_cash_case_01
```

**Explanation:**
- `DropKey` – Key to drop briefcases (any valid keyboard key)
- `MenuKey` – Key to open the settings menu
- `ModEnabled` – Toggle mod on/off
- `MaxBags` – Maximum active briefcases (1–10)
- `MoneyAmount` – Money per briefcase (2500–10000)
- `ModelName` – Change the briefcase model if desired

✅ All of these options can be adjusted in-game via the menu and saved directly to this file.

-------------------------------------
🕹 Gameplay Features (v1.2)
-------------------------------------
✅ Drop briefcases instantly  
✅ Collect money by walking over them  
✅ Briefcases auto-despawn if player walks too far  
✅ Limit the number of active bags  
✅ Prevent drops during:
   - Cutscenes
   - Driving/flying
   - Falling or ragdoll

✅ In-Game Menu (LemonUI):
   - Enable/disable the mod
   - Adjust max bag count
   - Adjust money amount
   - Load from INI
   - Save settings

-------------------------------------
❓ Troubleshooting
-------------------------------------
• **Briefcase not spawning?**  
   - Check that `MoneyDrop.dll` and `LemonUI.SHVDN3.dll` are in the `scripts` folder  
   - Ensure SHVDN 3.7.0+ is installed correctly

• **Game crashes on start?**  
   - Verify ScriptHookV and SHVDN match your GTA V version  
   - Double-check you are not using the mod in GTA Online

• **Menu doesn’t open?**  
   - Verify `MenuKey` in your INI file is a valid key  
   - Ensure LemonUI.SHVDN3.dll is present

-------------------------------------
📃 License
-------------------------------------
This project is open-source and free to use under the MIT License.  
🚫 Commercial redistribution is not allowed.

-------------------------------------
🙌 Credits
-------------------------------------
• Developed by **MO3IZO**  
• Powered by [ScriptHookVDotNet](https://github.com/scripthookvdotnet/scripthookvdotnet)  
• Menu powered by [LemonUI](https://github.com/LemonUIbyLemon/LemonUI)  
• Thanks to the GTA V modding community for support!

-------------------------------------
🆕 Stay Updated
-------------------------------------
Source code, issue tracker, and future updates:
🔗 https://github.com/Mouataz86/MoneyDrop
