Universal Troubleshooting
General help · Scooby Wiki
Universal Troubleshooting
Fixes for the specific errors people hit most often. This list is updated regularly - check back after an update before opening a ticket.
Not injecting
- Make sure you have disabled BattlEye in the Rockstar Launcher. If you launch through Steam or Epic, disable it there too with the launch argument
-nobattleye - Exclude the Scooby application and its folder in Documents from Windows Defender. Third-party antivirus can still cause issues even when fully disabled
- Run Scooby as Administrator
- Delete the Scooby folder in your
C:\drive - Remove OneDrive - it can cause permission issues in the Documents folder
- Verify your system files: open CMD as Administrator and run
sfc /scannow - Make sure your C: drive and Scooby folder have Full Control in their Properties → Security settings
"Failed to inject module. Try disabling your Anti-Virus."
A few different things cause this error. Follow these steps correctly and it should stop appearing:
- Make sure you are using the correct Windows user profile with Administrator privileges, and always run the Scooby loader as Administrator
- Move the Scooby loader to your Desktop, then add both the loader and your C: drive folder to your antivirus exclusions
- If you have OneDrive enabled, fully unlink and uninstall it
You can tell OneDrive is getting in the way if you can't find the Scooby folder in your normal Documents folder, or if the path shown in your antivirus exclusions contains "OneDrive".
Crashing on inject
- Exclude the Scooby application and its folder in Documents from Windows Defender. Third-party antivirus can still cause issues even when fully disabled
- Check the log to see if you are getting Failed to Find Patterns - if so, follow the Failed to Find Patterns guide in our Discord
- Make sure HDR is disabled in Windows Display Settings
- Verify your GTA game files
- Delete the Scooby folder in your
C:\drive - Verify your system files: open CMD as Administrator and run
sfc /scannow
Loader not opening, or "Auth Failed" error
- Use a VPN - https://one.one.one.one/
- Disable or remove any third-party antivirus
"GTA detected a fatal error"
Most of the time this is not caused by Scooby, but by faulty game files or something else on your system. Look up the specific error code shown (for example ERR_GFX_STATE) - it will point you to the actual cause.
Subscribed scripts not showing up
Use a VPN - https://one.one.one.one/
Why am I getting desync-kicked by BattlEye while using Scooby?
The reason for the desync-kick is that you are joining public sessions as a non-host, which causes BattlEye to remove you from the session.
This happens because you are playing GTA Online with BattlEye disabled while other players have it enabled.
To prevent it, start your own sessions as the host. You will then be able to play normally with non-modders who have BattlEye enabled. In the menu, go to:
Session Tab → Session Starter → Invite-Only Session or New Public SessionIf you want other players to join, enable the Advertise Session function in the host toolkit, or simply invite your friends. See How To Host Public Sessions with Scooby for the full walkthrough.
We also have a BattlEye bypass that lets you join anyone, including random public sessions - all the information on that is on the GTA 5 product page.
Getting BattlEye kicked even without Scooby running
You most likely joined a public lobby where you were not the host and got kicked by BattlEye while using Scooby. You will need to wait 12-24 hours for the kick to go away.
Until then, stick to lobbies where you are the host, or where another BattlEye-disabled player is the host.
Scooby folder not in Documents
Check your C:\ drive for it. It falls back there if permissions fail in Documents - usually because of OneDrive.