Troubleshooting

Mod Doesn't Load

"Street Riders v2.0.0: Loaded!" not showing?

• Ensure ScriptHookV and ScriptHookVDotNet3 are installed in your GTA V root folder.
• Verify StreetRiders.dll and the complete StreetRiders/ configuration folder are in Grand Theft Auto V/scripts/. The old root-level INI is no longer read.
• 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 config.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 [Behavior] in behavior.ini. The published default is 868413 and includes overtaking.
• Change driving flags cautiously: combinations can alter lane changes and obstacle avoidance.
• 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

This was fixed in v1.2.1: the mod releases the handbrake and rider tracking when the player takes a tracked bike. If it still happens in 2.0.0, collect the ScriptHookVDotNet log and report it.

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.
• BlockNonTempEvents is in [Behavior] in behavior.ini and defaults to false. Setting it to true may suppress ambient reactions; use it only if that tradeoff is acceptable.

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:

• Review RemountForceTimeout in advanced.ini (published default: 10000 ms).
• 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: The published behavior.ini sets BodyguardEnabled = true, while its comment still calls this mode experimental and warns of unintended attacks. Set it to false if you do not want to test it.
• Remount after falling: Riders usually recover and remount, but may get stuck in some edge cases.