Three tools, eight steps and one rule whose breach can cost an account. This guide also explains each mod type and what to do when the game no longer starts.
In March 2025, Rockstar split the PC release into two: GTAV Enhanced and GTAV Legacy. This distinction is crucial for modding because most established mods were made for Legacy and either work differently on Enhanced or do not work at all.
If you are modding the story campaign, Legacy remains the safer choice for now. Enhanced has newer graphics, but its mod ecosystem is still catching up.
Modifying the story campaign for yourself is one thing. Starting GTA Online with a modified client is another, and Rockstar issues bans for it. Mods must be disabled or uninstalled before starting Online mode.
Rockstar has long tolerated single-player modifications and acted against anything that affects the shared world. This is not inconsistency; it is the boundary between your game and other people's.
GTA V uses the BattlEye anti-cheat system. It refuses to start the game if it finds modified .rpf archives or a library required by mods in the installation. This is not a mod bug — it is intentional.
In the Legacy edition, BattlEye can be disabled in the launcher settings or with a launch parameter. This applies exclusively to the story campaign.
Never start GTA Online with BattlEye disabled or with mods installed — not even in a private session. This will result in an account ban.
In installation order
An editor for the game's .rpf archives. Vehicles, textures and sounds cannot be replaced without it.
It creates a `mods` folder for changed files instead of overwriting the originals. This is the only sensible way to mod the game — reverting then means deleting a single folder.
openiv.com →The library that allows script mods to run. It was created by Alexander Blade.
Most complex mods will not work without it. It is installed in the game's root directory — where GTA5.exe is located.
dev-c.com →The extension for scripts written in C# and .NET.
Many community mods are written in .NET. They will not start without this extension, even if Script Hook V is installed.
GitHub — releases →Eight steps; do not skip any
Not only the files you intend to change — the whole folder. Returning to a clean installation then takes minutes instead of downloading dozens of gigabytes. This is the one step that cannot be done afterwards.
Enhanced or Legacy? And which update number? Script Hook V is tied to a particular release and will immediately close a different one.
In OpenIV, select Tools → ASI Manager and install OpenIV.ASI. Then select Tools → mods folder. From that point, edit only files in the mods folder and leave the originals untouched.
ScriptHookV.dll and dinput8.dll (the ASI loader) belong beside GTA5.exe, not in the mods folder. Some guides mention dsound.dll — this is the older name for the same loader.
Extract it to the root directory and create a `scripts` folder. The actual script mods with a .dll extension go there.
In the Legacy edition, use either the launcher settings or the -nobattleye parameter. The game will not start with mods otherwise.
Before adding the first mod, check whether the game starts with the tools alone. If it crashes now, you know the problem lies with them rather than the mod.
Start the game after each addition. If you add five mods at once and the game crashes, you have five possible causes to investigate instead of one.
How it works, what it costs and the risk involved
For example: NaturalVision Evolved
Completely changes lighting, weather, colours and reflections. It makes a game from 2013 look like a current title.
For example: Add-on vehicles from GTA5-Mods
Adds cars as new vehicles alongside the originals or replaces existing models.
For example: Menyoo, Simple Trainer
An in-game menu for spawning vehicles, changing the weather, teleporting or enabling invincibility.
For example: LSPDFR
Turns the game into a police patrol simulator, with traffic stops, callouts and radio messages.
For example: Realistic damage, reworked police
Changes vehicle behaviour, police aggression, the economy or the difficulty of gunfights.
For example: Added interiors, new areas
Adds buildings, opens interiors that the game does not normally use or changes parts of the city.
Community archives with ratings and version histories
The largest community mod archive, with ratings, comments and version history.
The first place to look. Each mod shows which edition of the game it is intended for.
Open →The other major archive, with download and version management.
It has fewer GTA V mods than GTA5-Mods, but better version management.
Open →The community for police modifications, chiefly LSPDFR.
Registration is required. It is the largest project of its kind.
Open →Alternative multiplayer with custom servers, now under Rockstar.
The legitimate way to play with modifications and other people — it runs outside official GTA Online, so the two do not mix.
Open →We deliberately do not provide links to tools that modify official GTA Online, and never will. They can cause a permanent account ban and spoil the game for others.
Lighting, textures, weather and depth of field: the most visible change with the lowest risk.
They change only appearance, not game behaviour or data. Safe in single-player.
Added cars, paint schemes and modified character models.
Take care with real brands: models are usually distributed without a licence and may disappear after manufacturer complaints.
New mechanics, missions and NPC behaviour, including well-known police mods.
They require a Script Hook, which must be updated after every game update or the game will crash at launch.
Independent servers with their own rules, operating outside official GTA Online.
The legal way to play modified multiplayer because it does not mix with official servers. A legal game copy is still required.
Tools that alter money, position or statistics in official Online mode.
We advise against these and do not link to them. They lead to a permanent account ban and harm other people's games.
Back up the entire game folder, not only files you change. Returning to a clean installation then takes minutes rather than another download.
Record the game version. Most script mods target a particular version and stop working after an update.
Install mods individually and start the game after each addition. Adding five at once leaves five possible causes when it crashes.
Download only from large community archives with ratings and comments. Video links and URL shorteners are a common route to malware.
Never install anything that asks you to disable antivirus protection or enter your Rockstar Games account details.
Five problems and their usual causes
| Problem | Usual cause | What helps |
|---|---|---|
| The game crashes immediately on start-up | Usually an outdated Script Hook V after a game update. | Temporarily remove ScriptHookV.dll and dinput8.dll from the root directory. If the game then starts, wait for a new version from the author. |
| The game runs, but the mods do nothing | Script Hook V .NET is missing, or the scripts are not in the scripts folder. | Check that the `scripts` folder exists in the root directory and that the .dll files are inside it, not in mods. |
| BattlEye prevents the game from starting | The anti-cheat system has found modified archives or a loader. | Disable BattlEye for Legacy in the launcher or with the -nobattleye parameter. Never enter online mode afterwards. |
| Performance dropped sharply only after installing a mod | A graphics overhaul, or an invalid hook that slows the game without crashing it. | Remove the graphics mod and measure again. If there is no improvement, remove the hook as well. |
| The added car does not appear in the game | The entry in dlclist.xml is missing, or the vehicle is installed outside the mods folder. | Check the path in dlclist.xml. It must exactly match the location where you placed the files. |
After every GTA V update, Script Hook and most script mods stop working. Do not try to bypass this; wait for the authors to release an updated version. Until then, the game runs normally without mods.
Six settings with a clear effect on frame rate and four mistakes we repeatedly encounter.