Repository navigation
Releases
Q2RTX VR 0.8.4
Q2RTX VR is a free, open-source VR modification for Quake II RTX, distributed under GNU GPL version 2. It brings the single-player campaign to virtual reality through OpenXR, with tracked aiming, motion controllers, room-scale movement and crouching, teleportation, comfort settings and in-headset menus.
Quad Views was a central goal of this path-traced VR adaptation. On compatible hardware and runtimes, it combines detailed focus views with lower-resolution peripheral views; eye tracking lets the detailed regions follow your gaze. Standard stereo and fixed-foveation rendering are also supported.
How it was made: Togorian designed, directed and playtested Q2RTX VR, coming to it with very limited prior game-programming experience (a few hobbyist Quake II tweaks in 2000). OpenAI Codex wrote most of the code under his direction, and Anthropic's Claude independently audited the code and documentation before release. See provenance for details.
Requirements
- Windows x64, a Vulkan ray-tracing-capable graphics card and a compatible OpenXR headset/runtime.
- Quake II RTX with the original full Quake II game data installed. The free three-level Quake II RTX demo alone is not supported by this release. Game data is not included.
- The original installation's
baseq2folder must containpak0.pak,pak1.pak,pak2.pak,q2rtx_media.pkzandblue_noise.pkz. - Ordinary write access to the VR folder for settings, saves and diagnostics. Select your headset's OpenXR runtime before launching.
Path tracing in VR is demanding. Tested on an NVIDIA GeForce RTX 4080. Adjust application render scale and runtime quality to suit your hardware; application render-scale changes require restarting the game. Quad Views and eye tracking require compatible hardware and runtime support.
Tested headsets and runtimes
| Headset | OpenXR route |
|---|---|
| Pimax Dream Air | Pimax OpenXR, using Pimax EVO on the PC |
| Sony PS VR2 | SteamVR, with the PlayStation VR2 PC app |
| Meta Quest 3 | Virtual Desktop and Virtual Desktop Streamer, using VDXR |
These routes do not imply support for every headset feature. Quest 3 controller input through Meta Horizon Link is not supported; use Virtual Desktop with VDXR for controller play.
Download, verify and install
-
Download
Q2RTX-VR-v0.8.4.zipandQ2RTX-VR-v0.8.4.zip.sha256from Assets below. The corresponding-source archive is for building the software, not launching it. -
In PowerShell, from the download folder, run:
Get-FileHash -Algorithm SHA256 -LiteralPath '.\Q2RTX-VR-v0.8.4.zip'
The result must match the supplied
.sha256file and this value; letter case does not matter:58b71b6f9bfcc4f443396ae3e40d4f8973a215bcc68bb4e46ad51db86c8193c2 -
Close the game. Extract the archive into your Quake II RTX installation so that
Q2RTX VRsits alongside the originalbaseq2folder. Avoid a second nestedQ2RTX VRfolder. -
Keep the complete supplied folder and launch
Q2RTX VR.exeinside it. One launcher serves all supported headset routes. The original flat-game files remain separate; VR settings and saves live underQ2RTX VR/home.
For updates, back up your existing VR folder and follow installation and save guidance. Do not replace only the executable or overwrite personal settings and saves indiscriminately.
Defaults use controllers, right-handed, with Togorian's preferred bindings, smooth turning at 360 degrees/second and a teleport-only vignette. Home recentres the view; End switches between controllers and keyboard/mouse. Both actions can be rebound in Options → Action Key Bindings. See the controller guide.
Known issues and limitations
- If a weapon stops firing, move clear, release the trigger and press it again. The chaingun, hyperblaster or railgun can take up to about 2 seconds to be ready afterwards while the normal wind-down runs.
- Controller input and tracked weapon display can be unreliable at low frame rates under heavy load. Lowering render quality can help. An obstructed weapon may also disappear until you move clear, including near the dead Makron.
- Loading a level can temporarily pause headset updates. Focus loss and headset removal can require deliberate resume. A lost or ended VR session can require restarting and loading a save; unsaved progress may be lost.
- Teleporting with jump held can omit the teleport sound and particles.
- The desktop mirror is windowed. Some graphics and appearance settings are fixed during VR. Multiplayer, external networking, downloads, and demo playback and recording are disabled.
- Keep backups of important saves. Recovery after a power cut or system crash cannot be guaranteed.
See troubleshooting and known limitations for more detail.
VR comfort and safety: Clear your play space, follow your headset manufacturer's safety guidance, take regular breaks and stop if you feel unwell or uncomfortable.
Source and licence
The combined engine is distributed under GNU GPL version 2. Source is available in this repository and the attached corresponding-source-v0.8.4.zip, which includes build instructions and relinking materials. Third-party components retain their stated terms; game data is not included or relicensed. See the included LICENSE.txt and third-party notices.
If you'd like to support development: https://ko-fi.com/togorian
Q2RTX VR is an unofficial, fan-made modification by Togorian. It is not affiliated with, sponsored by or endorsed by NVIDIA, id Software, Bethesda Softworks or ZeniMax, or by any headset or runtime provider. All third-party names and trademarks remain the property of their respective owners. Quake is a trademark of its owner. You need your own copy of Quake II RTX and the full Quake II game data to play.