Installation

Requirements

• Grand Theft Auto V (latest version)
• ScriptHookV by Alexander Blade
• ScriptHookVDotNet v3

Steps

1. Install ScriptHookV and ScriptHookVDotNet3 in your GTA V root folder.

2. Copy StreetRiders.dll into Grand Theft Auto V/scripts/.

3. Copy the entire StreetRiders/ folder into Grand Theft Auto V/scripts/.

4. Launch the game. You should see a confirmation message:

   Street Riders v2.0.0: Loaded!

Folder Layout

Grand Theft Auto V/
├── ScriptHookV.dll
├── ScriptHookVDotNet3.dll
└── scripts/
    ├── StreetRiders.dll
    └── StreetRiders/
        ├── config.ini
        ├── groups.ini
        ├── vehicles.ini
        ├── behavior.ini
        └── advanced.ini

First Run

On first launch the mod loads automatically. Riders begin spawning based on the default configuration. Edit the relevant file in scripts/StreetRiders/ to adjust groups, zones, wheelie physics, and more, then press F10 in-game to hot-reload. The old root-level StreetRiders.ini and StreetRiders_Advanced.ini are no longer read.

Hotkeys

Key	Action
F10	Reload the configuration files
Insert	Toggle debug overlay (if Debug enabled)
NumPad1	Force-spawn a group (Test Mode)
NumPad0	Delete all riders (Test Mode)
F7	Toggle follow player system

Build from Source (Developers)

1. Open the solution file in Visual Studio 2022+.
2. Restore NuGet packages (ScriptHookVDotNet3 reference).
3. Build the project; the output goes to the configured path.
4. Copy the built StreetRiders.dll and the provided StreetRiders/ folder to your scripts/ folder.

The project targets .NET Framework 4.8.