
Grand Theft Auto V
Los Santos in a headset, from the driver's seat or on foot, with the whole story playable sitting down with a gamepad.
Needs a gamepad. No motion-controller gameplay: you hold a controller (or use keyboard and mouse) and look around with your head.
The catch: Head-aimed only and abandoned: no motion controllers, and each game patch can break it.
Will it run on your rig?
Check my rig
Set your rig to check fit.
Launch Kit
Get Grand Theft Auto V running
Steps are general until you ; then the runtime step matches your headset.
-
Set your VR runtime
This mod runs through SteamVR. Start your headset's PC link first (Quest Link, Air Link or Virtual Desktop), then start SteamVR.
General step from us -
Install Grand Theft Auto V (Steam)
Install it and launch it once in flat mode to finish first-time setup, then quit. The creator says it needs 1.0.2245.0 (older builds down to 1.0.1180.2 reportedly work with little support).
General step from us -
Have these ready
Game updated to 1.0.2245.0 with no other mods, per the README · Script Hook V DLL refreshed to match the current game build · Steam: untick 'Use Desktop Game Theatre while SteamVR is active' · SteamVR or Oculus runtime
From the creator's guide -
Creator step 1
Set Free Aim, head bobbing off, first-person cover on and hood off in the flat game settings
From the creator's guide -
Creator step 2
Extract the r7 archive into the folder containing GTA5.exe
From the creator's guide -
Creator step 3
Update ScriptHookV.dll from the Script Hook V site
From the creator's guide -
Creator step 4
Run RealConfig.bat and pick a High, Medium or Low preset
From the creator's guide -
Creator step 5
Launch the game with a gamepad and shake your head to recenter
From the creator's guide -
First launch in VR
Put the headset on, then start Grand Theft Auto V the way the creator's guide says. Calibrate your height in the first area.
General step from us
Stuck?
Author stopped support and updates on 2022-07-08 after Take-Two hostility, per the README
Reported on the creator's page or the linked sources. Known issue
Rockstar updates break script mods, so a manual Script Hook V update is needed
Reported on the creator's page or the linked sources. Known issue
Head-aim only; the author declines motion controller and snap turn support
Reported on the creator's page or the linked sources. Known issue
A couple of brief scenes disable headlook
Reported on the creator's page or the linked sources. Known issue
Black screen in the headset
This mod runs through SteamVR. Start your link (Quest Link, Air Link or Virtual Desktop) first, then SteamVR, and only then the game. If SteamVR shows the headset but the game is flat, close the game and launch it again the way the creator's steps say. General tip from us
Controllers don't show up
Start Link, Virtual Desktop or SteamVR before the game, and make sure the controllers are awake before launch. General tip from us
Stutter or low frame rate
Lower the in-game resolution or render scale first, then shadows and volumetrics. Close overlays you don't need. General tip from us
The mod didn't load at all
Recheck the game version against the creator's page; a game update is the most common cause. Then reinstall the mod files. General tip from us
Prefer a guide that talks back?
Copy a prompt for Claude Code on your PC. It asks before every download or change, and only uses the official page.