GTA 5 MODS · GUIDE

How to install GTA 5 mods on PC: Legacy or Enhanced

Install GTA 5 mods on PC in Story Mode: find out if your launcher starts Legacy or Enhanced, back up your saves and game files, then add one mod at a time.

Painting of a hand ticking a checklist in a spiral notebook beside a USB flash drive, an external hard drive and a cup of coffee

A first GTA 5 mod on PC goes in cleanly when you play Story Mode and first find out whether your launcher starts GTAV Legacy or GTAV Enhanced. Then install only files that name that edition and your current game build. Back up the game files and your saves first, then add one mod at a time and test after each one.

Legacy and Enhanced are separate PC versions. Rockstar released the free Enhanced upgrade on March 4, 2025, and GTAV Legacy stayed available beside it. Script mods, archive mods and loaders can differ between the two, so the right steps depend on which one you launch.

Modded files stay in Story Mode. Restore a clean, unmodded installation before you ever open GTA Online. PlayStation and Xbox copies are outside this workflow, which is written for Windows PC only.

Key Takeaways

Edition first

Your launcher starts either GTAV Legacy or GTAV Enhanced, and each mod file you install has to name that edition.

Back up before changing anything

Copy your Story Mode saves and the original game files so you can undo a change in minutes.

One mod at a time

Add a single mod, start Story Mode, and confirm it works before adding the next.

Story Mode only

Keep modded files out of GTA Online and restore a clean installation before any Online session.

Check which edition your launcher starts

The first job is to know what you are modding. Open the folder your game installs to and look at the main executable. GTAV Legacy runs from `GTA5.exe`, and GTAV Enhanced runs from `GTA5_Enhanced.exe`. Whatever the launcher opens is the edition that every download has to match.

This matters because the two editions do not share archive and loader assumptions. OpenRPF's author warns that Legacy files can crash Enhanced, and that Enhanced files and loaders have to match the current Enhanced build. A mod that works on one edition can fail on the other without a clear error.

Next, read the mod page for the line that names the edition and the supported build. A build is the game version or patch number a tool or mod supports. If the page names only one edition, treat the other as unsupported until the author says otherwise.

For a first mod, Legacy is the easier starting point when the mod you want explicitly supports it. Its OpenIV workflow is long established. Enhanced works well once the mod author provides an Enhanced build and an install path, but it asks for more version matching.

One more Rockstar detail affects your saves. Story Mode progress can be migrated from Legacy to Enhanced once, and Rockstar's upgrade announcement says progress cannot be copied back to Legacy after migration. Back up before you move anything between editions.

Back up the game and your saves first

A backup turns a bad install into a five-minute fix. Before the first modded file goes in, make two copies of what you can't easily rebuild.

The first is your Story Mode saves, copied somewhere outside the game folder. Do this separately from the game files, since a mod that misbehaves can affect progress as well as the game.

The second is the original game files a mod may touch. OpenIV works around this by having you edit copies of archives inside a separate `mods` folder, so the original archives stay untouched. For script mods, keep a note of exactly which files you add.

Open a plain text file and write down, for each mod, the files it adds, the dependencies it names, the edition and build it supports, and the removal steps from its page. That list is your undo button later.

Before the first mod

  1. Confirm the platform

    Windows PC, with GTA 5 started from the launcher you normally use.

  2. Confirm the edition

    Look for `GTA5.exe` for Legacy or `GTA5_Enhanced.exe` for Enhanced.

  3. Read the mod page

    Note the edition, supported build, dependencies and removal steps.

  4. Back up

    Copy your Story Mode saves and the original files the mod will touch.

  5. Install the loader

    Add only the framework the mod names, such as Script Hook V or an archive loader.

  6. Add one mod

    Follow the author's readme, then start Story Mode and test.

  7. Record the files

    Write down every file added so removal is exact.

Legacy route: Script Hook V for script mods

Many script mods and `.asi` plugins need Script Hook V. Alexander Blade publishes it, and the install steps on the Script Hook V page on dev-c.com are short. Download it from that page, not from a mirror.

Copy `ScriptHookV.dll` into the main GTA V folder, the one that holds `GTA5.exe`. Copy the included `dinput8.dll` ASI Loader into the same folder. If an older `dsound.dll` ASI Loader is already there, remove it. The package also includes `NativeTrainer.asi`, which you copy only if you want the included trainer.

Then start Story Mode and test before adding another plugin. The Script Hook V page lists version v3889.0 / 1158.13 for patches 1.0.3889.0 / 1.0.1158.13, dated July 15, 2026. If your game is on a different patch, check that page for a newer release before you install.

The author also states that Script Hook V does not work in GTA Online and closes GTA V when you enter multiplayer. That is the author's description of the tool, not a Rockstar rule, and it is not a reason to launch Online with modded files in place.

Not every mod needs Script Hook V. Script mods may call for it along with an ASI Loader, while archive mods need an archive workflow. The mod's own page names what it requires, and that list wins over any general advice.

Legacy route: OpenIV for archive mods

Archive mods change files packed inside the game's RPF archives, which is where OpenIV comes in. On the OpenIV site, the author describes ASI Loader as the part that loads `.asi` libraries and OpenIV.ASI as the part that loads modified RPF files through a `mods` folder.

The setup follows OpenIV's own steps. Install OpenIV and select Grand Theft Auto V for Windows, then point it at your Legacy game directory. Open Tools, then ASI Manager, and install both ASI Loader and OpenIV.ASI.

OpenIV creates, or asks to create, a root-level `mods` folder. Turn on the setting that allows edit mode only for archives inside `mods`. That one setting keeps your original archives out of reach.

To change a file, copy the original archive to the matching path inside `mods`, then install the mod there according to the mod author's readme. Keep the same relative path the original used. Start Story Mode and test that single change before you move on.

A graphics mod is a typical example of why the readme matters. One mod author's readme may call for both OpenIV and Script Hook V, and supply its uninstaller as an `.oiv` package or a separate add-on. Follow that author's order, not a general sequence.

Enhanced route: Script Hook V and OpenRPF

Enhanced has its own versions of these tools. Alexander Blade announced Script Hook V support for Enhanced on March 23, 2025. The announcement says Legacy ASI script plugins may work with Enhanced, while some mods need a separate Enhanced update.

For scripts, use the current Script Hook V package and confirm that the script author names Enhanced compatibility. Copy the required files into the Enhanced game folder, the one with `GTA5_Enhanced.exe`, then test in Story Mode.

Archive mods use a different loader. The OpenRPF page on GTA5-Mods.com presents OpenRPF as a creator-made Enhanced alternative to OpenIV.ASI. Its author lists the setup: extract the contents into the folder with `GTA5_Enhanced.exe`, create a `mods` folder, place modified RPF archives inside it, and launch Enhanced Story Mode.

The author's file rule is firm: use only files marked for Enhanced or converted for the Enhanced archive format. The page lists version 0.3, uploaded March 23, 2025 and last updated December 18, 2025, with compatibility for Enhanced versions 1013.17 and later.

That range is the author's statement on that date. Before you install, open the OpenRPF page, read the latest release notes, and compare them with the build number your Enhanced copy is running. OpenRPF is a creator tool, not a Rockstar one, so its compatibility notes are the author's claim.

Legacy and Enhanced side by side

The two routes share a shape and differ in the details, from the executable name to the archive loader.

Legacy and Enhanced for mods

TopicGTAV LegacyGTAV Enhanced
PC release relationshipOriginal PC version, kept after the 2025 upgradeFree PC upgrade released March 4, 2025
Executable`GTA5.exe``GTA5_Enhanced.exe`
Script toolScript Hook VScript Hook V with Enhanced support
Archive workflowOpenIV.ASI and a `mods` folderOpenRPF or another Enhanced-compatible loader and a `mods` folder
File compatibilityLegacy files for Legacy-supported buildsEnhanced files or properly converted archives
Update riskScripts and plugins can break after updatesLoader, archive format and plugins can break after updates
First-mod routeEstablished mod ecosystemMore version-sensitive; follow Enhanced-specific instructions

The edition split comes from Rockstar. The tool details come from the tool authors, so treat them as creator claims that can change when a game update lands.

Install the mod from its author's page

With the loader in place, the mod itself is the last piece. Go to the named author's own page and read the requirements before you click anything. Open the mod page on the site where the author publishes it, and avoid mirrors and shortened links, because a copy you can't trace to the author is a copy you can't trust.

Inspect the archive contents before you copy anything into the game. Scan the download, and walk away from any file that asks for unrelated software or your account credentials. No download is guaranteed safe or malware-free, so the habit of looking is yours to keep.

Then follow the mod's readme exactly. Readmes decide where files go, which dependencies come first, and how to undo the install. If the readme says a mod needs Script Hook V and a particular framework, install only the named dependencies, nothing extra.

Add one mod, start Story Mode, and play for a few minutes. If the game opens and the mod behaves, note it in your list and move to the next one. If something breaks, you know exactly which change did it.

Car, graphics and script mods can live together in one setup, but each one adds its own version requirements. Adding them one at a time is what keeps that manageable. If you want ideas on what to build toward, the GTA 6 look in GTA 5 mods post covers cars, map and outfit examples.

Remove a mod or roll back

Removal is easier when you wrote the file list. For a Legacy archive mod, delete its files from the `mods` folder or restore your backup. For a script, delete the specific `.asi`, `.dll`, configuration file and dependency the mod author names.

Take out OpenIV's ASI components only after you have removed the mods that depend on them. For an Enhanced archive mod, remove its files from the Enhanced `mods` folder and follow the author's cleanup steps. Never swap in Legacy files to repair Enhanced, or the other way around.

Each mod type removes differently, so the author's removal instructions come first and your backup is the safety net. If a mod leaves your game in a state you don't recognize, restore the backup you made before you started and begin again from a clean point.

A clean restore also covers your saves. Copy the Story Mode saves you backed up back into place if a mod altered your progress.

Keep modded files out of GTA Online

Rockstar's support page on single-player mods points players to its Terms of Service, Creator Platform License Agreement and Mod Guidelines. Read the current Mod Guidelines yourself, since the rules are Rockstar's to state and they can change.

In a 2015 newswire post, Rockstar said its focus is protecting GTA Online from modifications that give unfair advantages, disrupt gameplay or grief other players, and that single-player modifications were not the target of that statement. That is a dated statement, and current policy documents take precedence.

The practical rule is simple. Restore a clean, unmodded installation before opening GTA Online, and keep cheats, money exploits, account exploits, anti-cheat bypasses and ban-evasion tools out of your setup entirely. The site's mod rules page sets out the same boundaries, and the Rockstar mod rules explained post goes through them in plain language.

One separate platform comes up often around this topic. FiveM is a Creator Service under Rockstar's Creator Platform License Agreement with its own custom servers, and it is a different thing from the Story Mode setup described here.

After a game update

A title update can break a working setup. Script Hook V and archive loaders may need new versions after Rockstar patches the game, and Rockstar publishes separate update entries for the Enhanced and Legacy PC versions in its title update notes.

After an update, compare the supported build on each tool page with the build you now have. Script Hook V's page lists its supported patches, and OpenRPF's page lists its Enhanced version range. If a tool lags behind, wait for the author's update instead of forcing an older file into a newer game.

If the game won't start after an update, remove the most recent mod first, then the loader, and restore your backup if needed. Starting from the list you kept makes this a short job.

For the Enhanced route, confirm the mod author's own Enhanced support and required build before reinstalling anything. That author-by-author check is the dependable one, since no single list covers how each Legacy mod behaves on Enhanced.

Questions players ask

A few short answers cover the questions that come up around a first install.

Can I use GTA 5 mods in GTA Online?

Keep this setup in Story Mode and restore a clean installation before Online. Rockstar's Mod Guidelines are the rules to follow for anything beyond that.

Does Script Hook V work with Enhanced?

Its author announced Enhanced support on March 23, 2025. Some plugins still need Enhanced-specific updates, so the plugin author's page decides.

Do I need OpenIV for every mod?

No. Script mods may need Script Hook V and an ASI Loader, while archive mods need an archive workflow such as OpenIV on Legacy or OpenRPF on Enhanced.

Can Legacy mods work on Enhanced?

Only when the mod author marks them compatible or the files have been properly converted. Legacy RPF files can crash Enhanced.

Where to go next

Once your first mod runs, the garage and wardrobe pages show the car and outfit looks the community builds toward. If you want to see how a setup is put together, ItsDeepz's creator video How To Install Mods for GTA 5 LEGACY - EASY Guide is one place to watch a Legacy install, uploaded January 6, 2025, so confirm every tool version against the author pages above.

PC players waiting on GTA 6 can follow announcements on the PC countdown page, and you can send your own build to the submit page for review.

Glossary

Tap a term to see what it means.

ASI Loader. A component that loads `.asi` plugins into the game.

Back to the blog