Troubleshooting

Mod Doesn't Load

"Street Riders v1.2.1: Loaded!" not showing?

• Ensure ScriptHookV and ScriptHookVDotNet3 are installed in your GTA V root folder.
• Verify StreetRiders.dll and StreetRiders.ini are in Grand Theft Auto V/scripts/.
• Check you have the correct version of ScriptHookVDotNet (v3, not v2).
• Look for error logs in ScriptHookVDotNet.log in the GTA V root folder.

"Constructor threw an exception" / SHVDN V2 conflict

If the mod crashes on startup or fails to load alongside older SHVDN V2 mods, install SHVDN Enhanced instead of the standard version:

Script Hook V .NET Enhanced

SHVDN Enhanced is a drop-in replacement that resolves constructor exception crashes caused by V2/V3 coexistence issues.

---

No Groups Spawning

• Check zones: The group's Zones might not match your current location. The group might use zone codes your area doesn't match. Set Zones to empty to test spawning everywhere.
• Check active hours: A group with ActiveHourStart = 18 and ActiveHourEnd = 4 only spawns between 6 PM and 4 AM in-game time. Open your phone in-game to check the time.
• Enable debug mode (Debug = true in the INI) and press Insert to see the debug overlay with spawn attempt logs.
• Verify Enabled: Both the mod ([General] Enabled = true) and the group (Enabled = true) must be enabled.
• Check Chance: Low values reduce spawn probability. Try higher values for testing.
• Increase MaxActiveGroups: Default is 1. If another group is already active, new ones won't spawn.

Wheelies Not Happening

• Check DoWheelie: Must be true for the group.
• Check WheelieExcludedModels: The bike model might be in the exclusion list.
• Check MinSpeed: Rider must be moving faster than MinSpeed (default 12 m/s).
• Check WheelieActiveDistance: Wheelies only trigger when player is within this range (default 200 m).
• Performance: If the game is lagging, the physics system may struggle: lower WheelieActiveDistance.

Riders Crash Into Cars

• Adjust DrivingFlags in [DefaultWheelie]. The default value (802877) enables safe evasive behaviour:
  • StopForVehicles
  • SwerveAroundAllVehicles
  • SteerAroundStationaryVehicles, Peds, and Objects
  • AdjustCruiseSpeedBasedOnRoadSpeed
  • UseShortCutLinks
  • ChangeLanesAroundObstructions
• For more aggressive driving (go off-road, wrong way to overtake): DrivingFlags = 803644
• See the driving flags reference.

Follow Mode Issues

Symptom	Fix
Follow triggers too easily	Increase DynamicTriggerMs and DynamicMinSpeed
Riders lose you too fast	Increase LoseRadius (try 300)
Follow never triggers	Check CanFollowPlayer = true on the group and Enabled = true in [FollowPlayer]
Wrong vehicle type	Change PlayerVehicleType to Any

Bike Doesn't Move After Taking It

If you take a bike from a rider who was spawned by the mod, the bike might be stuck. This was a bug fixed in v1.2.1: the mod now releases handbrake and ownership when the player takes a tracked bike. Update to the latest version.

Riders Enter Combat and Stop Riding

If riders are armed (Weapons setting), they may enter combat with other NPCs and abandon their riding behaviour.

• Remove Weapons from the group config.
• Ensure BlockNonTempEvents = true in [DefaultWheelie].

Performance Issues

• Lower WheelieActiveDistance; riders beyond this range don't run wheelie physics.
• Reduce MaxActiveGroups to limit simultaneous groups.
• Increase SpawnIntervalMs to reduce spawn frequency.
• Set ShowBlips = false and ShowOverhead = false to reduce HUD updates.
• Lower NaturalRiderScanRadius if ApplyToNaturalRiders is enabled.

Remount Problems

Riders usually recover and remount after falling, but edge cases exist:

• Increase RemountForceTimeout (default 20000 ms) to force-warp the rider onto the bike.
• If the rider is too far from their bike, increase RemountMaxDistance.
• If remount attempts fire too fast, increase RemountTaskCooldown.

---

Debug Mode

Enable the debug overlay to see real-time rider state:

1. Set Debug = true in [General].
2. Press Insert to toggle the overlay.
3. The overlay shows: current phase, pitch angle, speed, and force applied for each rider.

Enable ShowOverhead = true to see rider info floating above their heads. Enable ShowBlips = true to see them on the minimap.

---

Hotkey Reference

Key	Action	Requires
F10	Reload configuration	:
Insert	Toggle debug overlay	Debug = true
NumPad1	Force-spawn a group	[TestMode] Enabled = true
NumPad0	Delete all riders	[TestMode] Enabled = true
F7	Toggle follow player	:

---

Known Issues

• Weapons & combat: Equipping riders with weapons is optional and may cause unexpected behaviour. Armed riders can enter combat with other NPCs, interrupting their riding. This feature is actively being improved.
• Bodyguard mode: A bodyguard system exists in the INI (BodyguardEnabled) but is under development. Do not enable it: riders may attack each other or the player.
• Remount after falling: Riders usually recover and remount, but may get stuck in some edge cases.