Police Bodyguard Mod v1.1

Description
Police Bodyguard Mod is a GTA V PC single-player ScriptHookVDotNet v3 mod that lets you spawn NPC bodyguard squads. Bodyguards follow the player, protect the player, use ground vehicles, and fight confirmed hostile NPCs.

The mod includes an in-game bodyguard menu that can be opened with F6. The menu UI is made for this mod and is drawn by the mod itself.

This build is compatible with GTA V 1.0.3788.0 and ScriptHookVDotNet v3.7.0-nightly.153.

v1.1 Notes
- Squad vehicles are recreated automatically when destroyed.
- When squad vehicles are repositioned to catch up, squad members are placed back inside their vehicle.
- Enemy law-enforcement NPCs hit by bodyguard fire are delayed briefly before going down.
- Weapon changes are handled only in Squad Members settings.

Controls
- F5: Spawn bodyguard
- F6: Open bodyguard menu
- F7: Switch Defense / Combat mode
- Num 8 / Num 2: Move menu selection
- Num 5: Select menu item
- Num 4 / Num 0 / Escape: Back or close menu

Menu Features
- Spawn bodyguard
- Delete bodyguard
- Change bodyguard appearance
- Police appearance
- Merryweather appearance
- Adjust bodyguard strength level
- Police and Merryweather ground vehicle settings
- Squad member count settings
- Shared or custom squad weapon settings

Bugs and Features
Features:
- Personal bodyguard spawn
- Up to four bodyguard squads
- Bodyguard follow behavior on foot and in ground vehicles
- Automatic replacement for destroyed squad vehicles
- Vehicle catch-up repositioning with automatic squad reseating
- Combat support against hostile NPCs
- Delayed down behavior for hostile law-enforcement targets hit by bodyguards
- Police and Merryweather appearance options
- Strength level selection
- F6 settings menu
- F7 Defense / Combat mode switching
- Single-player only

Known bugs / notes:
- Bodyguard behavior may vary during some story missions because mission NPCs use special AI.
- ScriptHookVDotNet version mismatches can prevent the mod from loading.
- If F5 or F6 does nothing, check ScriptHookVDotNet.log in your GTA V folder.

Requirements
- GTA V for PC
- ScriptHookV
- ScriptHookVDotNet v3.7.0-nightly.153

Do not downgrade to ScriptHookVDotNet v3.6.0 for current GTA V builds. The official v3.6.0 release page warns to use nightly.89 or later for GTA V 1.0.3258.0 or later.

Installation Overview
1. Install ScriptHookV.
2. Install ScriptHookVDotNet v3.7.0-nightly.153.
3. Open your main GTA V folder.
4. Create a folder named scripts if it does not already exist.
5. Copy Gta5PoliceBodyguard.dll and PoliceBodyguard.ini into the scripts folder.

Install path example:
Grand Theft Auto V\scripts\Gta5PoliceBodyguard.dll
Grand Theft Auto V\scripts\PoliceBodyguard.ini

Important
This mod is for GTA V single-player only.
Do not use this mod in GTA Online.
Using mods in GTA Online may result in a ban.

Credits and Reuse Permission
Created as a GTA V single-player ScriptHookVDotNet v3 bodyguard mod.

The in-game menu UI text and behavior were created for this mod.
No Menyoo UI code, Native Trainer UI code, or other mod menu code is included.

You may reuse or modify this mod's original text description and menu text for this mod page, mirrors, translations, or documentation, as long as the mod name and original credit are kept.

Do not reupload this mod as your own work without permission.
