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

Version v1.0 has been released! Features include single-player, multiplayer (with 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
    • You can choose installable or portable version
  2. Install game or copy game files - if you've chosen portable version - to the directory of your choice
  3. If you own a full version of the game, place pak0.pk3 file in the baseq3/ subdirectory next to pakQ3VR.pk3:
    • If you don't - no need to worry as Q3VR comes with the demo version of the game out of the box and you can skip this step
  4. Start your VR runtime (e.g. SteamVR)
  5. Run the game (q3vr.exe)
The game will notify you if there is a newer version available!

How to build yourself

Download or clone Q3VR repository from GitHub and build it with CMake: 

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

Currently supported on Windows and Linux.

Controls

Default controls on Valve Index controllers are:

Description

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

You can also bind custom actions to each button. See this section of README.md file for more details.

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.

Support

If you like my work such as this port, consider supporting me on GitHub or Buy Me a Coffe.

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.