Antivirus fixes, troubleshooting, Linux & Mac, free keys and HWID resets
The most common questions people ask before they even get the loader running. Read these first if Windows is blocking or removing your download.
It is most commonly known as a false positive, which means your PC may automatically flag the mod menu as malware because it doesn't recognise the file or its intentions.
This happens due to the way mod menus are developed, not necessarily because they are malicious.
Simply disable Real-time Protection in Windows Security.
You may also need to temporarily disable your browser's Safe Browsing or Safe Search feature if it prevents the download.
Recommended browsers are Chrome and Firefox.
This usually happens because the loader hasn't been added as an exclusion in Windows Defender. When Real-time Protection is re-enabled, Windows Defender may automatically remove the loader.
To prevent this, open Windows Security and go to:
Virus & threat protection → Manage settings → Add or remove exclusions → Add an exclusionSelect the Scooby loader. Once it has been added as an exclusion, Windows Defender should no longer remove it automatically.
Follow these steps to get your Scooby free key:
The free version is limited to invite only sessions or sessions with other modders in GTA Online. Joining a public lobby on the free version will crash.
If you have used Scooby before, delete the C:\scooby folder - the folder, not the loader. If you don't, it will probably crash due to old settings.
Work through these in order - they resolve the overwhelming majority of crashes:
C:\scooby. Do this after every Scooby update to avoid conflicts with your old settings
Make sure you are following the injection instructions properly. Almost every issue comes from skipping steps. The guides exist for a reason - if you want to play without the restrictions, the Premium Plus version gives you access to everything. Otherwise, use the limited free version as documented.
Fixes for the specific errors people hit most often. This list is updated regularly - check back after an update before opening a ticket.
-nobattleyeC:\ drivesfc /scannowA few different things cause this error. Follow these steps correctly and it should stop appearing:
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".
C:\ drivesfc /scannowMost 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.
Use a VPN - https://one.one.one.one/
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.
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.
Check your C:\ drive for it. It falls back there if permissions fail in Documents - usually because of OneDrive.
If you get connection errors trying to load the website or the loader, it is because your ISP is blocking the connection to the servers.
Cloudflare is usually good for most users, or you can use Proton.
If you are still getting errors while connected to a VPN, it probably means you need to use a better VPN.
If you have changed hardware or are getting an HWID mismatch, reset it from the portal:
If you are on cooldown then you need to wait - the reset cannot be forced through early.
Scooby is a Windows application, but it runs on Linux and Mac through a Windows compatibility layer. The trick is making sure the loader and the game live in the same prefix - otherwise the loader cannot see the game to inject into.
ScoobyLoader.exe to Lutris as a pre-installed game, and set its WINE prefix to the same prefix the Rockstar Games Launcher usessegoeui.ttf into that prefix's Windows\Fonts folderScoobyLoader.exe through Lutris and play as normalSegoe UI is a Windows font that WINE does not ship. Without it the menu can render with missing or broken text, so copy segoeui.ttf into the prefix before you launch.
Scooby itself does not really affect performance. If the game runs badly, that is the compatibility layer rather than the menu.
Try different WINE or Proton versions - performance varies a lot between builds, and switching runner version is usually the single biggest win.
The same approach works on Mac through CrossOver, and other tools for running Windows apps on Mac will work the same way. Set it up exactly as above: game and loader in the same bottle/prefix, with the Segoe UI font added.
GTA 5 itself runs poorly on Mac in our testing, including on M4 Pro and M4 Pro Max. It does run - it is just not a great experience. That is the game under translation, not a Scooby issue, and there is nothing on our side that changes it.