
==================================================
PoliceRide — README
==================================================

Author(s):
Hanks905
DonDonny

--------------------------------------------------
--------------UPDATE 2.0.0------------------------
--------------------------------------------------
Implemented a surrender system hold ctrl or dpad left for 2 seconds to surrender and get transported to nearest police station

Did a complete rework of the cruiser spawning and arriving system, so no more waiting forever for the cruiser to show up.

A officer will now pull you out of a vehicle 

Added Support officers who will engage hostiles in the area while the arrest is happening (no more npcs from other scripts mag dumping you the whole time) 

Added a siren toggle in the ini to disable the cruisers sirens and lights during transport to station, this should help the cruiser getting stuck in traffic 

added the ability to skip at anytime so can get teleported straight to police station if wanted or something hitches up. 

added some failsafes if the driver gets stuck along the way, but can still get caught up in some alley ways, this is where you just need to skip for now 

 
numerous bug fixes, the overall experience should be more consistent and smoother

still some minor issues with police glitching/stuttering should be fixed in a later update 

------NOTE-------
-MAKE SURE TO DOWNLOAD THE UPDATED VERSION OF SHVDNE IF YOUVE UPDATED YOUR GAME --- NEW UPDATE BROKE THE SCRIPT WITH OLD SHVDNE --- FIND LINK BELOW---



--------------------------------------------------
Description
--------------------------------------------------

PoliceRide replaces GTA V’s simplified arrest system with a fully played-out,
cinematic law-enforcement interaction.

Arrests are no longer instant fades or teleports. Officers physically subdue,
restrain, escort, and transport the player while maintaining consistent and
stable gameplay flow — even during chaotic situations or escape attempts.

--------------------------------------------------
Installation
--------------------------------------------------

1. Locate your GTA V ROOT DIRECTORY.
   (This is the folder containing GTA5_Enhanced.exe)
   (usually @ C:\Program Files (x86)\Steam\steamapps\common\Grand Theft Auto V Enhanced)

2. Copy the PoliceRide DLL into scripts folder:

   Grand Theft Auto V Enhanced\scripts

3. Ensure the following are installed:
   - ScriptHookV 
   https://www.dev-c.com/gtav/scripthookv/

   - ScriptHookVDotNetEnhanced  (any shvdn v3 should work)
   https://github.com/Chiheb-Bacha/ScriptHookVDotNetEnhanced (this is the one i use)

4. Launch GTA V in Story Mode.

--------------------------------------------------
INI Configuration
--------------------------------------------------

On first launch, PoliceRide will automatically generate:

PoliceRide.ini

This file is created in:
GTA V\scripts\

All settings are OPTIONAL and safe to modify.

If the mod behaves unexpectedly after editing the INI:
DELETE PoliceRide.ini and restart the game.
A clean default configuration will be recreated automatically.

--------------------------------------------------
INI Options (Summary)
--------------------------------------------------

The INI file allows limited customization of PoliceRide behavior.

Options may include:

- Feature Toggles
  Enable or disable specific arrest or transport systems.

- Arrest & Escort Behavior
  Controls how officers restrain, escort, and load the player.

- Escape Response
  Adjusts how the mod reacts if the player attempts to flee custody.

- Spotlight / Searchlight Options
  Modifies police vehicle or helicopter spotlight behavior.

- Performance Settings
  Reduces update frequency or disables optional logic for stability.

Each option is commented inside the INI file.

--------------------------------------------------
Usage & Permissions
--------------------------------------------------

This mod is released for PERSONAL USE ONLY.

You are NOT permitted to:

- Reupload this mod or any portion of it
- Redistribute modified or unmodified versions
- Include this mod in mod packs or collections
- Reverse engineer, decompile, or bypass protection
- Claim authorship or partial authorship

WITHOUT PRIOR WRITTEN PERMISSION FROM:
Hanks905 AND DonDonny

This applies to all platforms including GTA5-Mods, Nexus,
Discord servers, and third-party websites.

--------------------------------------------------
Disclaimer
--------------------------------------------------

This mod is provided "AS IS".
The authors are not responsible for game instability, save corruption,
or conflicts with other mods.
==================================================
