How to Install GTA 5 Mods on PC – From Download to Use
Most GTA 5 mod install guides fail for one reason. They mix Grand Theft Auto V Legacy steps with Grand Theft Auto V Enhanced steps, then they act like every ZIP goes into the same folder.
This hits PC players on Rockstar Games Launcher, Steam, and Epic Games Launcher who want Story Mode mods to load cleanly without trashing a working install.
This guide covers the install route from download to first use. It covers Script Hook V, OpenIV, OpenRPF, Script Hook V .NET, Script Hook V .NET Enhanced, OIV packages, archive mods, and add-on cars. It does not cover GTA Online cheating, money hacks, or unsupported online bypasses.
GTA 5 Mod Assumptions
Platform
PC
Game Branch
GTA V Legacy or GTA V Enhanced
Mode
Story Mode Modding
Online
Official GTA Online Stays Clean
Input
Keyboard Or Controller. Install Steps Stay The Same
Launchers
Rockstar Games Launcher, Steam, Or Epic Games Launcher
GTA 5 Mod Routes
Most failed installs come from choosing the wrong route before you even extract the archive.
- If you are on Legacy: start with GTA 5 Legacy Install.
- If you are on Enhanced: start with GTA 5 Enhanced Install.
- If the ZIP contains .asi: go to the script route.
- If the ZIP contains .dll, .cs, or .vb: go to the .NET route.
- If the ZIP contains .oiv: go to the OIV route.
- If the ZIP contains a folder with dlc.rpf: go to the add-on car route.
Legacy Script Route
Use this when the download contains a simple .asi plugin or trainer and the mod page targets GTA V Legacy.
GTA 5 Mod Checks
GTA 5 Game Branch
Rockstar now treats Grand Theft Auto V Legacy and Grand Theft Auto V Enhanced as separate PC branches. A mod that targets one branch can fail on the other even when the file names look similar.
Official Source: Rockstar system requirements and Rockstar save migration guide.
- Open your launcher library and confirm whether the installed game is Grand Theft Auto V Legacy or Grand Theft Auto V Enhanced.
- Open the mod page and read the title, version notes, or installation notes.
- Match the mod page branch to your installed branch before you extract anything.
- If the mod page only says Legacy, do not install it on Enhanced.
- If the mod page only says Enhanced, do not install it on Legacy.
GTA 5 Install Folder
You cannot install mods correctly until you open the real GTA V install folder. That root folder is where simple script tools, many trainers, and some loader files are placed.
Official Source: Rockstar support steps for Rockstar Games Launcher, Steam, and Epic local files.
- Rockstar Games Launcher: open Settings, select Grand Theft Auto V under My installed games, then click Open under View installation folder.
- Steam: open Library, right-click Grand Theft Auto V, hover over Manage, then click Browse local files.
- Epic Games Launcher: open Library, click the three dots under the Grand Theft Auto V tile, click Manage, then click the folder icon.
- Keep that File Explorer window open. Treat it as your main install folder for the rest of this guide.
.ASI Route
This usually starts in the root folder. It needs Script Hook V, and it needs one working ASI loader path.
Destination
Root Folder
Simple .asi mods, ScriptHookV.dll, loader files, and many trainers start here.
Destination
scripts Folder
.NET mods usually live here after Script Hook V .NET or Script Hook V .NET Enhanced is installed.
Destination
mods Folder
OpenIV and OpenRPF keep archive edits out of the base game by loading from this folder.
Destination
dlclist.xml
Add-on cars often need a dlcpacks entry in dlclist.xml before they can load in Story Mode.
GTA 5 Clean Copy
This is the lowest-risk step in the whole guide. It turns a bad install into a quick reset instead of a full reinstall.
- Close GTA V and your launcher.
- Copy the entire GTA V install folder to a second location that has enough free space.
- Rename one folder Clean and the other folder Modded.
- Install every mod into the Modded copy only.
- Keep the original downloads and readme files in a separate folder so you can retrace what changed.
GTA 5 BattlEye
Rockstar says BattlEye only needs to be active during online play sessions. Rockstar also added a way to disable it for Story Mode play, plus the -nobattleye launch argument for third-party launchers.
Official Source: Rockstar Title Update 1.69 notes and Rockstar BattlEye FAQ.
- Rockstar Games Launcher: open Settings and uncheck Enable BattlEye before a Story Mode modding session.
- Steam: right-click Grand Theft Auto V, click Properties, go to the General tab, and place
-nobattleyein Launch Options when you want a Story Mode modding session. - Epic Games Launcher: open Library, click the three dots, click Manage, enable Launch Options, and add
-nobattleyefor Story Mode modding. - Before you return to official GTA Online, remove the launch argument and re-enable BattlEye.
GTA 5 Legacy Install
Legacy still has the most mature mod ecosystem on PC. The common split is simple. Script mods use the root folder. Package mods and archive edits use OpenIV and the mods folder.
GTA 5 Legacy Script Mods
Use this route when the download contains a trainer or another simple .asi plugin. Script Hook V is the common foundation, and its package includes the runtime plus an ASI loader option.
Project Source: Script Hook V and current Menyoo 2.0 install notes.
- Download the current Script Hook V release that matches your game patch.
- Copy ScriptHookV.dll into your GTA V root folder.
- If you do not already have another working ASI loader, copy dinput8.dll from the Script Hook V archive into the same folder.
- Copy the mod’s
.asifile into the root folder. - If you want a simple test, copy NativeTrainer.asi too.
- Launch Story Mode and use the mod’s actual hotkey. For Menyoo 2.0, that key is F8.
GTA 5 Legacy .NET Mods
Use this route when the mod ships as .dll, .cs, or .vb. Current Legacy-targeted .NET scripts still commonly use Community Script Hook V .NET.
Project Source: Community Script Hook V .NET.
- Install the Microsoft .NET Framework 4.8 or later and the Microsoft Visual C++ Redistributable Package for Visual Studio 2019 (x64) if they are not already present.
- Install Script Hook V first.
- Copy ScriptHookVDotNet.asi, ScriptHookVDotNet2.dll, and ScriptHookVDotNet3.dll into the GTA V root folder.
- Create a folder named scripts if it does not already exist.
- Copy the mod’s
.dll,.cs, or.vbfiles into scripts. - Copy any INI or config files that ship with the mod into the exact path named by the author.
- Launch Story Mode.
GTA 5 Legacy OIV Mods
If the archive contains an .oiv file, do not drag that into the root folder. On Legacy, the normal route is OpenIV plus the mods folder. Current VisualV instructions still use that path.
Project Source: OpenIV mods folder guide, OpenIV Package Installer, and current VisualV Legacy install notes.
- Download and install OpenIV, then point it at your GTA V Legacy folder.
- In OpenIV, click Tools then ASI Manager, and install ASI Loader and OpenIV.asi.
- Open the mod’s
.oivfile through OpenIV, or click Tools then Package Installer. - Select the
.oivpackage and choose Install to mods folder. - Let the install complete, then close OpenIV.
- Launch Story Mode and test the changed feature or asset.
GTA 5 Legacy Add-On Cars
Most manual add-on cars use a simple pattern. The folder that contains dlc.rpf goes into mods\update\x64\dlcpacks, then you add a matching entry to dlclist.xml.
Project Source: Current add-on examples on Toyota Probox Stock [Add-On] and Lonehaven Vehicle & Ped Pack, plus current Add-On Vehicle Spawner usage notes.
- Extract the vehicle archive and locate the folder that contains dlc.rpf.
- Open OpenIV and copy that folder into mods\update\x64\dlcpacks.
- Open mods\update\update.rpf\common\data\dlclist.xml.
- Add a new line using the author’s exact folder name in this format:
dlcpacks:/foldername/. - Save dlclist.xml.
- Launch Story Mode and spawn the vehicle with the author’s stated spawn name in your trainer or vehicle spawner.
dlcpacks:/foldername/ line from dlclist.xml.GTA 5 Enhanced Install
Enhanced is different. Current archive loading centers on OpenRPF, not OpenIV.asi, and you need to match Enhanced-only files to the Enhanced branch.
GTA 5 Enhanced Script Mods
Current Enhanced script mods need two things. They need the current Script Hook V runtime, and they need an Enhanced-friendly ASI loader. OpenRPF currently provides that loader for Enhanced through dsound.dll.
Project Source: OpenRPF, Script Hook V, and current Menyoo 2.0 requirements.
- Install OpenRPF into your GTA V Enhanced folder.
- Create a folder named mods in that same Enhanced folder if it does not already exist.
- Download the current Script Hook V release and copy ScriptHookV.dll into the Enhanced root folder.
- Copy the mod’s
.asifile into the same root folder. - Use one ASI loader path. If OpenRPF is already providing ASI loading on Enhanced, do not stack another loader unless the mod author explicitly tells you to.
- Launch Story Mode.
- If the mod is Menyoo 2.0, use F8 to open the menu.
GTA 5 Enhanced .NET Mods
Enhanced-capable .NET scripts need the current Script Hook V .NET Enhanced stack. That project extends SHVDN so the same runtime can support Legacy and Enhanced.
Project Source: Script Hook V .NET Enhanced and its default INI.
- Install the Microsoft .NET Framework 4.8 or later and the Microsoft Visual C++ Redistributable Package for Visual Studio 2019 (x64) if needed.
- Install OpenRPF and the current Script Hook V first.
- Copy ScriptHookVDotNet.asi, ScriptHookVDotNet2.dll, ScriptHookVDotNet3.dll, ScriptHookVDotNet.ini, and MinHook.x64.dll into the Enhanced game directory.
- Create a folder named scripts if it does not already exist. The default INI expects that location.
- Copy the mod’s
.dll,.cs, or.vbfiles into scripts. - If the mod page calls for it, install DirectStorageFix too.
- Launch Story Mode.
GTA 5 Enhanced OIV Mods
Enhanced .oiv installs are now a real route, but only when the mod actually ships as an .oiv package and matches the correct game branch. Current OIV Package Installer handles Legacy and Enhanced packages and validates the game version when the package declares it.
Project Source: OIV Package Installer.
- Install OpenRPF first so your Enhanced mods folder works.
- Download the current OIV Package Installer.
- Launch CodeWalker.OIVInstaller.exe.
- Select the mod’s
.oivfile. - Select your GTA V Enhanced game folder.
- Click Install and wait for the process to finish.
- If you later need to remove the package, use Manage Mods inside the installer.
GTA 5 Enhanced Archive Mods
Not every Enhanced mod ships as an .oiv. Some current mods still require a manual archive route with OpenRPF and the exact install instructions on the mod page. VisualV is a current example.
Project Source: VisualV Enhanced install notes.
- Confirm the mod page explicitly says it supports Enhanced.
- Install OpenRPF.
- Create a mods folder, then create mods\update.
- Copy update.rpf from the game’s update folder into mods\update.
- Open the archive tool named by the mod author and place the files from the mod’s manual-install folder into the matching paths inside mods\update\update.rpf.
- Launch Story Mode and test the exact asset, weather, map area, or visual change the author describes.
GTA 5 Mod Launch
GTA 5 First Launch
Do not install five mods and hope for the best. The clean way to validate a mod stack is one change at a time.
- Launch Story Mode, not GTA Online.
- Test one newly installed mod before you add the next one.
- If the mod uses a menu or hotkey, trigger that exact hotkey.
- If the mod changes files rather than menus, go to the exact location, weather, or asset the author tells you to check.
- If the game crashes, remove the last mod before touching anything else.
GTA 5 Online Reset
When you want official GTA Online again, treat that as a clean boot. Rockstar is explicit that official servers need BattlEye, blank launch option fields, and a normal platform launch.
Official Source: Rockstar BattlEye troubleshooting.
- Close GTA V.
- Switch back to your Clean copy, or remove the mod files and loaders you added.
- Rockstar Games Launcher: open Settings and check Enable BattlEye again.
- Steam: clear the Launch Options box. Epic: disable Launch Options or clear the text box.
- Launch the game from Rockstar Games Launcher, Steam, or Epic Games Launcher directly.
- Do not use a desktop shortcut,
.batfile, or Command Prompt launch for the official online session.
GTA 5 Mod Errors
If the game closes before Story Mode, start with GTA 5 Startup Crash. If the game loads but the mod never shows up, start with GTA 5 Missing Mod. If everything broke right after a title update, start with GTA 5 Update Break.
GTA 5 Startup Crash
A startup crash usually means one of four things. The mod targeted the wrong branch, the loader stack is duplicated, Script Hook V is outdated after a patch, or a base file was changed outside the mod workflow.
Project Source: Script Hook V. Official Source: Rockstar Verify Integrity path in Rockstar Games Launcher and Rockstar Steam and Epic verify steps.
- Remove the last mod you installed.
- Confirm the mod matches Legacy or Enhanced correctly.
- Update Script Hook V to the current runtime that matches your game patch.
- Use one ASI loader path, not two.
- Verify the game files from your launcher.
- Retest Story Mode before reinstalling any other mod.
GTA 5 Missing Mod
If the game opens but nothing changes, the install path is usually wrong. This is a placement problem more often than a performance problem.
- Open the download again and identify the real file type.
- If the file is
.asi, reinstall it to the root folder. - If the files are
.dll,.cs, or.vb, reinstall them to scripts after you install the correct .NET runtime. - If the file is
.oiv, reinstall it through the correct package installer instead of drag and drop. - If the mod ships as a DLC pack with dlc.rpf, check both mods\update\x64\dlcpacks and dlclist.xml.
- Retest with only that one mod installed.
GTA 5 Update Break
Rockstar updates can break script runtimes before they break the mod itself. Script Hook V’s own concept section makes the main rule clear. When the game updates, the first thing most users need to update is the runtime.
Project Source: Script Hook V, Script Hook V .NET Enhanced, and OpenRPF.
- Check whether the break started right after a GTA V update.
- Update Script Hook V first.
- If you use .NET mods, update Community Script Hook V .NET on Legacy or Script Hook V .NET Enhanced on Enhanced.
- If you use Enhanced archive mods, update OpenRPF and any OIV tool you rely on.
- Retest the game with only the current runtimes and one known-good mod.
- If one specific mod still fails, remove that mod and wait for its author to update it.
GTA 5 Mod FAQs
Yes, but not in the same live session. Keep a clean install for official GTA Online, keep BattlEye enabled for that session, and keep your Story Mode mods in a separate modded copy.
.asi mods usually go in the root folder. .dll, .cs, and .vb mods usually go in the scripts folder after the correct .NET runtime is installed.
No. Simple .asi mods can load with Script Hook V alone. OpenIV matters most for Legacy archive edits, OIV packages, and mods-folder work.
Use OpenRPF for current Enhanced mods-folder loading and ASI loading. It is the current Enhanced replacement route for OpenIV.asi.
Check the mod page title, version notes, install notes, and changelog. If the page only names one branch, treat that as exclusive unless the author says otherwise.
The most common cause is an outdated runtime. Update Script Hook V first, then update your .NET runtime or Enhanced loader if your stack uses them.
Yes, when the mod actually ships as an .oiv package and targets Enhanced. The current OIV Package Installer is the clean route for that case.
A folder that contains dlc.rpf is the usual sign. That route typically needs mods\update\x64\dlcpacks plus a matching entry in dlclist.xml.
Rockstar lists ReShade and Special_K as known BattlEye issues. They can be disabled during gameplay or interfere with launch when BattlEye is active.
Use the mod’s uninstall path if it exists. If not, restore the affected files from your clean backup or verify the game files from your launcher.



