The field guide / Universal Modder

Minecraft in GTA 5: the passthrough mod

Last updated:

This guide follows the official example README and minecraft-passthrough.md field note. Both describe single-player Story Mode only. The contributor marks the note working; we have not run the example ourselves.

How the passthrough works

Both games remain real running games. GTA’s camera and ground information go to a Fabric mod, which positions Minecraft’s view and builds invisible ground collision. Minecraft exports color, depth and a separate hand/HUD overlay; a ReShade add-on composites that output against GTA’s depth buffer. A local WebSocket carries camera, ground and gameplay events.

Placed Minecraft blocks become invisible GTA props, while explosions and weapon events are translated into GTA effects. The example also describes elytra flight and a Nether scene. This requires coordinating two renderers and two sets of behavior. Source: example “How it works”.

Reported versions and requirements

The example was built and tested in September 2026 with GTA V Legacy on Steam, build 3889, ScriptHookV 3889.0 and ReShade 6.8.0. It does not support GTA V Enhanced. These identify that example, not all GTA installations.

Its requirements section lists:

  • Windows 10/11 with WSL for the shell and batch workflow.
  • Minecraft Java Edition 26.3, Fabric Loader 0.19.5 or newer, Fabric API 0.161.0+26.3.
  • GTA V Legacy on Steam, in Story Mode.
  • ScriptHookV and its ASI loader, plus ReShade 6.8.0 with add-on support. ScriptHookV must support the installed GTA build.
  • Visual Studio 2022 or newer with x64 C++ desktop tools.
  • JDK 25; the WSL build wrapper expects a Windows JDK.
  • Python 3.12 for host tools. Windows Python uses websockets, with numpy and Pillow additionally needed by the fake host; WSL Python with Pillow and Linux ffmpeg handles video cutting. Windows recording needs ffmpeg with gfxcapture.

See the Windows / WSL guide for the difference between these example tools and the general README prerequisites.

Build and setup reading order

Follow the exact executable steps in the example’s Build, install, run section. The sequence below explains what to review at each stage.

The example builds the Minecraft side, then uses a dedicated launcher profile and game directory rather than the player’s normal worlds. It builds the GTA side with MSVC and describes the files installed into the game folder. Review those changes before applying them. Choose Story Mode manually; never let the agent click the landing page while you are typing elsewhere. Source: example setup and safety.

Known build problem

In issue #88, the blank-command error while running the GTA build script comes from missing Visual Studio C++ x64 tools. The maintainer recommends Visual Studio 2022 or Build Tools with Desktop development with C++, or setting VCVARS to the installed vcvars64.bat. Read troubleshooting for the exact reported error.

Status and limits from the field note

The field note reports working camera/depth compositing and gameplay bridging, but also records open verification questions. It asks readers to check pose-lag settings on a real installation, notes that removal can delete a pre-existing ReShade configuration, and describes cleanup scope that may affect existing world content. Back up configuration and saves, and use isolated test data.

The example reports at most 400 placed-block props and crashes around 1,500 script objects in its setup. Its local link listens on the loopback interface without a token; close Minecraft when finished. Source: example ground and safety sections.

Plan a smaller first slice

Install Universal Modder, adapt the merge-two-games template, and ask for one small camera-aligned object before expanding interactions. Back up saves first and verify in Story Mode. Merge games with AI explains route selection, based on the mashup skill.

Frequently asked questions

Does this example support GTA V Enhanced?

No. The example README specifies GTA V Legacy on Steam and says Enhanced is not supported here.

Can I use this in online play?

No. This guide covers single-player Story Mode only. Online play is out of scope.

Do I need Visual Studio C++ tools?

Yes for this example’s GTA build. Its README specifies x64 C++ desktop tools, and the maintainer’s reply in issue #88 explains the failure when they are missing.