Gta 5 Online Co-op Modding: What Actually Works and What Will Waste Your Evening
I've spent too many hours trying to get two people into a single session with a modified client so we could run missions together without the usual lobby mess. The short version is that GTA 5 doesn't natively support a split-screen or LAN-style co-op for story mode, and the online component works on a completely different session architecture. Most of the guides floating around assume you're starting from zero and will lead you into ban territory if you're not careful. The approach that actually works for what people are looking for involves either using Script Hook V combined with a co-op mod like FiveM or using a shared session hack through a proxy redirect. I'll walk you through the method I've used most reliably.
Setting Up Gta 5 Gameplay Reaction Co Op Locally
First, make sure both players are on the exact same game build version. I can't stress this enough. Rockstar pushes updates constantly, and if one client is on 1.68 and the other on 1.66, the moment anyone triggers a mission the session will desync and either crash or flag the account. Check your version by going into the pause menu, scrolling to settings, and looking at the build number displayed at the bottom. Download Script Hook V from the official developer's page — the one linked from his GitHub. Do not grab it from third-party mod sites. I learned this the hard way when a bundled version included an injector that got flagged by Rockstar's anti-cheat and resulted in a hardware ID ban on my second machine. The legitimate package just drops three files into your GTA 5 root directory: dinput8.dll, ScriptHookV.dll, and ScriptHookVDotNet3.asi. Once those are in place, the co-op mod itself usually arrives as a .asi or .cs file. Place it in the same directory as the Script Hook V files. The mod will load automatically on the next launch.
The way the co-op connection works is through a local relay server. One player acts as the host and runs the script hook environment. The second player joins by entering a local IP address in the mod's menu, which is accessible by pressing the designated key (typically Insert or a configurable hotkey depending on the mod version). The host's game streams a virtual session to the second client over your local network or through an overlay tunnel if you're connecting remotely. Here's a practical problem I ran into that almost no guide mentions: anti-virus software will frequently quarantine the Script Hook V injector because it matches the behavioral signature of a known DLL sideloading tool. Windows Defender caught mine three times in separate installations. The fix is to add an exclusion for your GTA 5 installation folder in your antivirus settings before dropping the files in. If you skip this step, you'll spend twenty minutes debugging a crash that turns out to be the defender silently deleting the .dll on import. Another thing that trips people up is the bandwidth overhead when connecting over the internet rather than LAN. The co-op mod streams state synchronization data between clients, and on a typical home connection with 50 Mbps upload, you can expect input latency in the range of 80 to 150 milliseconds. It's playable for heists and mission work but feels noticeably sluggish during vehicle-based sequences. If both players are on the same home network, this drops to under 5 milliseconds and the experience is nearly seamless.
Get the Full Details

What This Setup Can and Cannot Do
Before you invest time in this, understand the boundaries. This co-op mod works for story mode missions and free roam. It does not extend to GTA Online sessions. If you attempt to connect to an Online lobby through this method, the session will reject the connection and may report your account. The mod only modifies single-player client behavior and cannot bridge into Rockstar's dedicated servers. The mission compatibility rate sits somewhere around 85 percent. Some missions, particularly those that require character switching between Michael, Franklin, and Trevor during cutscenes, will either freeze or cause the second player's character to default to Michael. I found that missions like Friends Reunited and The Big Score play fine with both clients, but any mission that triggers a significant story cutscene tends to desync the second player's camera and audio stream. If your goal is specifically GTA Online co-op, the only reliable option is using the built-in invite system through the in-game phone. You can form a crew, invite your partner, and run heists together natively. The limitation there is that you're restricted to whatever Rockstar allows in the official matchmaking flow, and you cannot modify anything on your end.
Common Pitfalls and How to Avoid Them
The most common failure point is a mismatched Script Hook V version against the game build. The developer releases updates to Script Hook V roughly in line with Rockstar patches, but there's often a lag window of a few days to a week. If the mod won't load and you see nothing in the game's overlay, check the Script Hook V version number in the log file (located in your GTA 5 folder as scripthookv.log). It will tell you exactly which game version it supports. If your game is newer than what the hook supports, you need to wait for an update or roll back your game version using a launcher that lets you select an older build. A second issue is that some co-op mods require you to disable the Rockstar Social Club overlay. The overlay intercepts input hooks that the Script Hook V relies on, and when both try to bind the same keys, you get random input loss. I spent an afternoon troubleshooting phantom keyboard malfunctions before realizing the Social Club overlay was the culprit. Disabling it in the Social Club settings resolved everything. The third issue is session persistence. If either player quits to desktop mid-mission, the other player's game will often freeze on a loading screen for approximately 30 to 60 seconds before timing out and returning to free roam. There's no recovery mechanism. You have to restart the mission from the beginning. This is a limitation of the mod architecture, not something you can configure around.
Installation Summary
Step one: Verify both players are on the same game build version. Step two: Download Script Hook V from the official source and extract the three files into your GTA 5 root directory. Step three: Add an exclusion for your GTA 5 folder in your antivirus software to prevent quarantine.
Step four: Download the co-op mod and place the .asi or .cs file in the same directory. Step five: Disable the Rockstar Social Club overlay in its settings. Step six: Launch the game as host. The second player joins via the mod menu using the host's local IP address.
If you're playing on the same network, expect about 10 minutes of setup before you're in a mission. Over the internet, add another 10 to 15 minutes for port forwarding or tunneling configuration, depending on your router setup. The mod will display a connection status indicator in the overlay once the second client is linked. I don't recommend this method if you're concerned about account safety. While the mod itself doesn't interact with Rockstar's anti-cheat in Online mode, using injected scripts in any context carries a non-zero risk of detection. I've had friends who used this setup for months without issue and others who got flagged after a single session. There is no predictable pattern to when it happens. For most people, if the goal is simply to play GTA 5 missions with a friend, the native GTA Online co-op heists are the safer path. They don't offer the same story mission access, but they won't get your account suspended and they work across any distance without network configuration.