================================================================================
                         MILITARY PROTECTION SCRIPT
                              for GTA V (SHVDN3)
================================================================================

WHAT THIS MOD DOES
================================================================================

When you get a wanted level, military soldiers will spawn to PROTECT YOU and
fight the cops. They are on YOUR side.

- 1-2 Stars: Military trucks with soldiers arrive
- 3 Stars: Helicopters start coming too
- 4 Stars: Tanks arrive + soldiers get heavy weapons (RPG, Minigun)
- 5 Stars: Full military response - tanks, attack helicopters, heavy troops

When your wanted level goes away, the military packs up and leaves.

Press F10 anytime to turn the script on or off.


REQUIREMENTS
================================================================================

You need these installed FIRST before this mod will work:

1. Script Hook V
   Download: http://www.dev-c.com/gtav/scripthookv/

2. Script Hook V .NET (SHVDN3)
   Download: https://github.com/scripthookvdotnet/scripthookvdotnet/releases

Make sure you have the latest versions of both.


HOW TO INSTALL
================================================================================

1. Download and install Script Hook V (if you dont have it)
   - Extract dinput8.dll and ScriptHookV.dll to your GTA V folder
   
2. Download and install Script Hook V .NET (if you dont have it)
   - Extract ScriptHookVDotNet.asi and ScriptHookVDotNet3.dll to your GTA V folder
   - Create a folder called "scripts" in your GTA V folder if it doesnt exist

3. Put these two files in your scripts folder:
   - MilitaryProtection.dll (or MilitaryProtection.cs)
   - MilitaryProtection.ini

Your GTA V folder should look like this:

   Grand Theft Auto V/
   ├── GTA5.exe
   ├── dinput8.dll
   ├── ScriptHookV.dll
   ├── ScriptHookVDotNet.asi
   ├── ScriptHookVDotNet3.dll
   └── scripts/
       ├── MilitaryProtection.dll
       └── MilitaryProtection.ini

4. Start the game and play!


HOW TO USE
================================================================================

Just play the game normally. When you get a wanted level, military will come
to help you automatically.

CONTROLS:
- F10 = Turn script ON or OFF

You will see notifications when:
- Script is turned on/off
- Military vehicles arrive
- Tanks are deployed
- Helicopters are incoming


WHAT SPAWNS
================================================================================

GROUND VEHICLES:
- Crusader (military jeep) - 2 soldiers
- Mesa (army SUV) - 4 soldiers
- Barracks (troop truck) - 8 soldiers
- Insurgent (armored truck) - 5 soldiers
- Technical (truck with gun) - 4 soldiers
- Rhino Tank - 1 soldier (4+ stars only)

HELICOPTERS (3+ stars):
- Buzzard (attack helicopter)
- Annihilator (transport helicopter)
- Valkyrie (heavy gunship)
- Savage (attack helicopter)
- Cargobob (transport helicopter)

SOLDIERS CARRY:
- Assault rifles (Carbine, Special Carbine, Combat MG)
- Pistols as backup
- Sticky bombs
- Smoke grenades
- Heavy weapons at 4+ stars (Minigun, RPG, Grenade Launcher)


HOW THE SOLDIERS BEHAVE
================================================================================

- They HATE cops and will attack them on sight
- They are FRIENDLY to you and wont hurt you
- They dont follow you around - they patrol and fight
- They drive towards enemies and engage
- They use cover and fight smart
- They never run away
- Helicopters will chase and attack from the air

When your wanted level is gone:
- Ground vehicles drive away
- Helicopters fly away
- Foot soldiers wander off
- All blips fade out


MAP BLIPS
================================================================================

Green truck icon = Military ground vehicle
Green tank icon = Tank
Green helicopter icon = Helicopter
Green friend icon = Individual soldier
Blue friend icon = Helicopter crew


CONFIGURATION
================================================================================

Open MilitaryProtection.ini with Notepad to change settings.

COMMON THINGS TO CHANGE:

Toggle Key:
   ToggleKey=F10
   Change F10 to any key you want (F1-F12, A-Z, etc)

More Vehicles:
   MaxGroundVehicles=5
   MaxHelicopters=2
   Increase these numbers for more chaos

Faster Spawning:
   GroundSpawnCooldown=6000
   HelicopterSpawnCooldown=15000
   Lower these numbers (in milliseconds) for faster spawns
   6000 = 6 seconds

Stronger Soldiers:
   HealthMultiplier=1.0
   ArmorMultiplier=1.0
   Set to 2.0 for double health/armor

Better Aim:
   BaseAccuracy=70
   Higher number = soldiers hit more shots (max 100)

Earlier Helicopters:
   HelicopterMinWantedLevel=3
   Set to 1 if you want helicopters at 1 star

Earlier Tanks:
   TankMinWantedLevel=4
   Set to 1 if you want tanks at 1 star

Disable Specific Vehicles:
   EnableRhino=true
   Change to false to disable that vehicle


TROUBLESHOOTING
================================================================================

SCRIPT NOT WORKING:
- Make sure Script Hook V is installed
- Make sure Script Hook V .NET is installed
- Make sure both files are in the scripts folder
- Check that your game version matches Script Hook V version

NO SOLDIERS SPAWNING:
- You need a wanted level first
- Wait a few seconds after getting wanted
- Make sure script is enabled (press F10)

RANDOM CIVILIANS INSTEAD OF SOLDIERS:
- This was fixed in the latest version
- Make sure you have the newest script file

GAME CRASHING:
- Update Script Hook V to latest version
- Update Script Hook V .NET to latest version
- Lower MaxGroundVehicles and MaxHelicopters in the INI

LAG/PERFORMANCE ISSUES:
- Lower MaxGroundVehicles to 3
- Lower MaxHelicopters to 1
- Increase GroundSpawnCooldown to 10000
- Increase CleanupDistance to 150

SOLDIERS NOT ATTACKING:
- They only attack cops and military
- They need to see enemies within 200 meters
- Give it a moment for them to engage


ERROR LOG
================================================================================

If something goes wrong, check this file:
   scripts/MilitaryProtection.log

It will tell you what errors happened.


UNINSTALL
================================================================================

Just delete these files from your scripts folder:
- MilitaryProtection.dll (or .cs)
- MilitaryProtection.ini
- MilitaryProtection.log (if it exists)

The game will be back to normal.


VERSION INFO 1.0 
================================================================================

Works with:
- GTA V (Before Update)




CREDITS: vLaati
================================================================================

Script created for use with:
- Script Hook V by Alexander Blade
- Script Hook V .NET by crosire and contributors


================================================================================
                              ENJOY THE MOD!
================================================================================