Quake 3 VR

A PCVR port of Quake 3 Arena (q3vr) by RippeR37 — based on ioquake3 and Quake3Quest with VR-specific improvements, QoL and multiplayer support.

Download View on GitHub Discord

Status

Beta — features include single-player, multiplayer (crossplay), 6DoF support, haptics, weapon wheel and many comfort options.

See below for information how to play, controls and troubleshooting.

Quake 3 VR thumbnail 1
Quake 3 VR thumbnail 2
Quake 3 VR thumbnail 3

About the project

Quake 3 VR (q3vr) is a PCVR port of Quake 3 Arena. It is based on the community-maintained ioquake3 engine and the Quest port (Quake3Quest). The port includes bugfixes, VR-specific improvements and a number of quality-of-life features.

  • Full single-player campaign and multiplayer support (crossplay with PC & Quest).
  • 6DoF movement, weapon selection wheel, haptics, virtual screen and comfort options (vignette, height adjust).
  • Supports playing on many community servers and simpler mods.

For full setup instructions, controls and troubleshooting follow the repository on GitHub.

How to play

  1. Download the latest release from the GitHub Releases page.
  2. Download required PAK files and place them in the baseq3/ subdirectory next to pakQ3VR.pk3:
  3. Start your VR runtime (e.g. SteamVR) and run q3vr.exe.

How to build yourself

The project uses CMake. On Windows (MSVC) you can build with:

> cmake -S . -B build
> cmake --build build --config Release

Currently Windows is the only officially supported platform.

Controls

Default controls on Valve Index controllers are:

Description

Some of these can be affected by changes made in the in-game Setup menus.

Troubleshooting

Common issues and quick fixes:

  • Verify that you have latest version of Q3VR.
  • Ensure that SteamVR (or your VR runtime) is running when the game starts.
  • Ensure that all required PAK files are present in baseq3/ subdirectory.
  • Remove local user configs from C:\Users\$user\AppData\Local\Quake3\.
  • Update all related drivers (e.g. GPUs).
  • Check reported issues for known problems.
  • Reach out to others:

If the problem persists, gather logs and follow the reporting steps on the right.

Reporting issues & Feedback

Feedback and bug reports are necessary for the project to improve.
  1. Search existing GitHub issues to avoid duplicates.
  2. If none exist, open a new issue and provide as much details as you can.
  3. For general feedback or ideas, use Discussions or open an issue tagged as enhancement.

If possible, please attach logs, screenshots and/or recordings to your issues to make it easier to verify and fix found problems.

Disclaimer

Q3VR is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Bethesda or ID Software, or any of its subsidiaries or its affiliates.
Q3VR is an unofficial port of the idTech3 engine, which was originally written by ID Software.

Quake 3, Quake 3 Arena, id, id Software, id Tech and related logos are registered trademarks or trademarks of id Software LLC in the U.S. and/or other countries. All Rights Reserved.