Cinematic Cruise (Lawful Autopilot + Cinematic Camera)
Version: 1.0.0
Author: (your name here)

SINGLE PLAYER ONLY.
Do NOT use in GTA Online.

------------------------------------------------------------
DESCRIPTION
------------------------------------------------------------
Cinematic Cruise adds an autopilot to your MAP WAYPOINT with a speed limiter,
plus a cinematic camera that can auto-cycle through multiple angles.

Driving is tuned to be calmer / more “lawful-ish” (low aggressiveness, normal-ish
driving style). GTA AI is not perfect, but this aims for cruising instead of chaos.

------------------------------------------------------------
REQUIREMENTS
------------------------------------------------------------
- ScriptHookV (Alexander Blade)
  https://www.dev-c.com/gtav/scripthookv/

- ScriptHookVDotNet (crosire)
  https://github.com/crosire/scripthookvdotnet

------------------------------------------------------------
INSTALLATION
------------------------------------------------------------
1) Install ScriptHookV and ScriptHookVDotNet correctly.
2) Copy:
     CinematicCruiseLawful.dll
   into:
     Grand Theft Auto V\scripts\

Final path should be:
  Grand Theft Auto V\scripts\CinematicCruiseLawful.dll

------------------------------------------------------------
HOW TO USE
------------------------------------------------------------
1) Open the map and set a Waypoint.
2) Get into a vehicle as the DRIVER.
3) Press F10 to enable Cinematic Cruise.

Cruise will stop automatically when you arrive near the waypoint.
Press F10 again any time to disable it.

------------------------------------------------------------
CONTROLS
------------------------------------------------------------
F10        Toggle Cinematic Cruise ON/OFF
F9         Toggle Hands-Free (blocks steering/throttle/brake while active)
Numpad +   Increase cruise speed
Numpad -   Decrease cruise speed
PageUp     Next camera angle
PageDown   Previous camera angle

------------------------------------------------------------
NOTES / LIMITATIONS
------------------------------------------------------------
- “Obey traffic laws” is best-effort. GTA driving AI can still make mistakes.
- This mod enforces a speed cap while active. When you turn it off, it removes
  the cap by setting a very high max speed again.
- If the mod stops working after a GTA update:
  update ScriptHookV and ScriptHookVDotNet first.

------------------------------------------------------------
TROUBLESHOOTING
------------------------------------------------------------
Mod does not load:
- Make sure you have a folder named "scripts" in your GTA V directory.
- Make sure CinematicCruiseLawful.dll is inside GTA V\scripts\
- Make sure ScriptHookV is installed (dinput8.dll in GTA V folder).
- Make sure ScriptHookVDotNet is installed (its files in GTA V folder).

Cruise stops immediately:
- You probably don't have a waypoint set.
- Make sure you are the driver (not a passenger).

------------------------------------------------------------
CREDITS
------------------------------------------------------------
ScriptHookV by Alexander Blade:
https://www.dev-c.com/gtav/scripthookv/

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