Mods belong to story mode only. The moment you load GTA Online, BattlEye anti-cheat scans your files, and anything injected or swapped out of place can flag your account for a ban. There is no trick to hide mods from this, no toggle that lets you keep them loaded and still play online safely. The only real fix is a genuinely clean game folder, not a disguised one.
This guide walks through what to pull out, where to put it, and how to confirm the game is back to stock before you log into Online. None of this is complicated, but skipping a step is exactly how people end up banned over something they thought was too minor to matter.
Why hiding mods does not work
Some players try renaming files or keeping a “safe” subset of mods active, hoping BattlEye will not notice. It checks game files directly, not just known cheat signatures, so a modified dinput8.dll or an altered script file is exactly the kind of thing it is built to catch. It does not matter whether the mod itself does anything that could be called cheating. A texture swap and a money hack both change files BattlEye expects to find untouched, and it does not make a distinction between the two when it flags something. There is no safe middle ground here. Either the folder matches the original install, or it does not.
What to remove from the main game folder
Go to the folder that holds GTA5.exe. This is where Script Hook V and most ASI-loader mods inject themselves. Remove the following if present:
dinput8.dll(the usual ASI loader)ScriptHookV.dll- any
.asifiles sitting loose in this folder - the Script Hook V .NET files, typically a
ScriptHookVDotNet.asiand its related.dllfiles - the
scriptsfolder, which holds loose script mods - the
modsfolder, which is the folder OpenIV creates and uses to redirect modified game assets without touching the originals
If you installed anything through OpenIV using its mod folder feature, removing that mods folder alone undoes most of it, since OpenIV is designed to leave original archives untouched and load replacements from there instead. That is the main reason this method is worth using in the first place: cleanup later becomes a single folder deletion instead of a hunt through individual archive files trying to remember what you changed.
Check for any .ini or config files that came bundled with a mod too. They are not themselves a security risk once their parent .asi is gone, since nothing loads them without the loader present, but leaving a messy folder behind makes it harder to spot something you missed. A quick pass through the folder, sorted by date modified, usually shows everything that was added since the base install.
If you run LSPDFR
LSPDFR runs on its own plugin loader, separate from Script Hook V, so it needs its own cleanup pass:
RAGEPluginHook.exe- the
Pluginsfolder it uses - the
LSPDFRfolder itself
None of this is needed to play GTA Online anyway, since RAGE Plugin Hook is a separate launcher from the main game executable and you would not normally use it to start an Online session. But if it is sitting in your GTA 5 directory, take it out along with everything else. Leaving an unused police mod framework in the folder does nothing for you online and is still one more set of modified files for an anti-cheat scan to trip over.
Move it out, do not delete it
If you plan to go back to modding story mode later, do not trash your mod collection. Create a folder somewhere outside your GTA 5 install, for example on your desktop or a separate drive, and move everything there as one batch: the .asi files, the scripts folder, the mods folder, and your LSPDFR setup if you have it. Keep the folder structure intact so putting it all back later is a matter of moving files back into place, not rebuilding from scratch. Label the folder clearly too, something like “GTA5 mods backup”, so you are not guessing later what belongs where.
Run a file verification afterward
Removing added files only fixes what was injected alongside the originals. If you ever edited an original archive directly instead of going through OpenIV’s mod folder, that file is still changed on disk, and no amount of deleting extra DLLs will fix it. You need your launcher to check and restore it.
- On Steam, right-click GTA 5 in your library, open Properties, go to the Installed Files tab, and run “Verify integrity of game files”.
- On the Epic Games Launcher, open the game’s settings from your library and choose the option to verify.
- On the Rockstar Games Launcher, open the game’s settings page and look for the verify or repair option there.
Let it finish fully before launching. It can take a while depending on how much it needs to redownload, so do not interrupt it partway through just because it looks stuck. This is exactly why editing original files directly is a bad habit even for story mode mods: OpenIV’s mod folder approach keeps your originals untouched, so you never have to rely on a verify pass to undo direct edits. If you always install through the mods folder, cleanup is just deleting a folder and you are done, with nothing left for the launcher to repair.
Legacy and Enhanced are different installs
If you have both the Legacy version and the Enhanced version installed, they live in separate folders with separate executables and separate mod setups. Cleaning one does nothing for the other, since they do not share files or a mods directory. Make sure you are cleaning the folder tied to the version you actually intend to play GTA Online with, and check that version’s folder specifically rather than assuming one cleanup covers both. It is easy to clean out the wrong folder if you have not played one of the two versions in a while and forget which one your shortcut actually launches.
Do not leave “harmless” stuff behind
It is tempting to think a simple graphics tweak, a reshade preset, or a small UI change is not risky enough to bother removing. Treat all of it the same way. The point of this cleanup is an exact match to the original install, not a judgment call about which mod seems safe. Loose .asi files, reshade injectors, and texture folders checked into the mods directory all fall into the same bucket as script mods. None of these are approved for use with GTA Online, regardless of how visual or passive they seem. Pull all of it, verify your files, and only then load into GTA Online.
Questions people ask
Can I keep Script Hook V installed if I just do not run any scripts?
No. Having ScriptHookV.dll and an ASI loader present is enough to change how the game loads, and BattlEye checks for exactly that kind of modification, so the files themselves need to come out, not just the scripts that use them.
Does verifying game files remove mods installed through OpenIV's mods folder?
Not reliably. Verification restores original archive files that were edited directly, but the separate mods folder sits alongside the originals, so you still need to delete or move that folder yourself.
Will a ban happen instantly if I load into GTA Online with mods still in place?
It can happen on the very first scan or after some delay, since BattlEye does not reveal its exact timing, which is exactly why relying on luck instead of a clean folder is not worth it.
Do I need to clean both GTA 5 Legacy and Enhanced if I only play one online?
No, only the specific installation you intend to use for GTA Online needs cleaning, since the two versions have entirely separate folders and files.
Browse all Grand Theft Auto 5 mods on CrashMods