Skip to content

Quake VR mod supporting room-scale movement, hand interactions, and melee attacks.

License

Notifications You must be signed in to change notification settings

vittorioromeo/quakevr

Repository files navigation

The timeless classic from 1996, reimagined for virtual reality.

(Visit the official landing page for videos and more information.)

Main Features

  • Smooth locomotion
  • Teleportation
  • Fully room-scale (including jumping)
  • Hand tracking (including full finger tracking)
  • Weapon models with hands and ironsights
  • VR interactions (melee, headbutts, pick up items, press buttons)
  • Rebalanced for VR (hitboxes, difficulty, projectile speed)
  • Steam VR Input API support (can rebind inputs in Steam VR settings)
  • Many customization options (e.g. melee damage/range, hand/body item pickup, and more)
  • Brand new particle system (smoke, blood, lightning effects, and more)
  • Haptic feedback (weapons, melee, damage, interactions with items)
  • Full Scourge of Armagon support (weapons, enemies, maps)
  • Full Dissolution of Eternity support (weapons, enemies, maps)
  • Two-handed weapon aiming (with virtual stock support)
  • Weapon weight simulation
  • Grappling hook (from Dissolution of Eternity)
  • Positional damage (headshots, leg shots)
  • Dual-wielding
  • Weapon holster system (hip and shoulders, fully customizable)
  • Weapon throwing & force grabbing
  • Multiplayer support (also with bots)
  • Weapon reload system
  • Sandbox map

Disclaimer

  • This is a free open-source project done for fun and to contribute to the VR community. Donations are appreciated, but making money is not a goal for Quake VR.
  • The project is still in an early stage. Expect bugs and lack of polish. It was fully tested only with a Valve Index headset and controllers.
  • Tweaking the settings in-game is highly recommended before playing. The default settings might not be ideal for your hardware and body proportions.
  • The game heavily relies on modified QuakeC files. Therefore, mods or expansion packs are not compatible out of the box, but should be easy to port.
  • Feel free to open issues or contact me at [email protected] for any issue, feature request, or question about the code.
  • Join us on the official Discord for discussion, feedback, and beta testing. (Direct invite link.)

Installation

  1. Install "Visual C++ x64 Redistributable" package.

  2. Install 7zip

  3. Install "Quake". The Steam version works well.

  4. Grab the latest binary from the releases page.

  5. Extract the Quake VR archive into a new, empty folder (e.g. C:/Games/id/Quake/quakevr).

  6. Navigate to the id1 folder in your installation of Quake (e.g. C:/Program Files/Steam/steamapps/common/Quake/id1) and copy both PAK0.PAK and PAK1.PAK to Quake VR's id1 folder (e.g. C:/Games/id/Quake/quakevr/id1).

  7. Run the quakevr.exe executable in the root folder to launch the game!

  8. (optional) To enable music, copy the music folder from the 'remaster' (e.g. C:/Program Files/Steam/steamapps/common/Quake/rerelease/id1/music) to Quake VR's id1 folder as well.

Mission Packs

Quake VR supports both of the official mission packs. They can be installed alongside the regular Quake files, enabling you to switch between them without having to restart Quake VR.

NOTE: With the release of the Quake 'remaster', both mission packs are included with the base game and no longer need to be purchased seperately.

Mission Pack 1: Scourge of Armagon

  1. Navigate to the hipnotic folder in your installation of Quake (e.g. C:/Program Files/Steam/steamapps/common/Quake/hipnotic)

  2. Make a copy of PAK0.PAK, and rename it to PAK2.PAK.

  3. Copy the newly created PAK2.PAK into your Quake VR's id1 folder (e.g. C:/Games/id/Quake/quakevr/id1).

Mission Pack 2: Dissolution of Eternity

  1. Navigate to the rogue folder in your installation of Quake (e.g. C:/Program Files/Steam/steamapps/common/Quake/rogue)

  2. Make a copy of PAK0.PAK, and rename it to PAK3.PAK.

  3. Copy the newly created PAK3.PAK into your Quake VR's id1 folder (e.g. C:/Games/id/Quake/quakevr/id1).

The contents of your id1 folder should now contain:

  • Official Quake files: PAK0.PAK and PAK1.PAK;
  • Scourge of Armagon mission pack files: PAK2.PAK;
  • Dissolution of Eternity mission pack files: PAK3.PAK;
  • Quake VR files: PAK10.PAK, PAK11.PAK, PAK12.PAK.

(The load order of .PAK files is based on their naming. You can rename the mission pack files to anything else, as long as it is before the Quake VR specific .PAK files. This allows you to also add extra .PAK files, such as high-resolution models or other compatible additions.)

When a mission pack is installed, it overwrites Quake 1's start.bsp with its own starting map. In order to play Quake 1 maps, use the "Change Map" functionality under "Quake VR Settings".

Highly Recommended Addons

HD Textures and Soundtrack

The HD Textures and Soundtrack (alternative link) addon is highly recommended to improve immersion.

Extra Multiplayer Maps with Bot Support

Quake VR comes with Frikbot X++, which adds AI opponents for deathmatch. As the vanilla multiplayer map pool is quite limited, the following map pack and Frikbot waypoint collection are strongly advised if you are interested in playing against bots:

Custom Maps

For supported custom maps, please see CUSTOM_MAPS.md.

Vispatching/Colored Lighting

The Quake VR engine supports transparent water and colored lighting, however original Quake maps need to be patched in order for it to work properly. It is therefore highly recommended that you patch your Quake maps.

You can find the patch files here. Merely copy all the .vis and .lit files from the maps directory of the downloaded archive into your maps directory in your Quake VR installation's id1 folder (e.g. C:/Games/id/Quake/quakevr/id1/maps) (this might break lighting on the level select maps start.bsp but shouldn't interfere with the actual levels. If you want, you can delete start.lit and start.vis from the maps folder to prevent this).

Once your maps are patched, go through the options in the "Transparency Options" menu under "Quake VR Settings" to enable/tweak transparency levels.

First Steps

SteamVR Bindings

The first thing you should do after starting Quake VR is opening the "Controller Bindings" interface on SteamVR and ensure that in-game actions are mapped to the motion controllers. There are two action sets to bind: one for in-game actions, and one for menu control. See an example video here.

In-Game Configuration

After setting up your bindings, please go through all the options in "Quake VR Settings", and tweak the game to your liking. Do not forget to:

  • Calibrate your height;
  • Tweak the position of the "VR torso" and of the holsters ("hotspots");
  • Go through the "Immersion Settings".

There is no "best" way of playing Quake VR. Simply use the settings that you enjoy the most!

Multiplayer

Versus Bots

To play against bots, select "Multiplayer & Bots" from the main menu, then "New Game" and follow the on-screen instructions. When in-game, spawn new bots from the "Bot Control" menu under "Multiplayer & Bots".

On the Internet

Coordinate with other players on the official Quake VR Discord. The host of the game will start a server by going to "Multiplayer & Bots" from the main menu, then "New Game". The host will then share their public IPV4 address with other players, which will connect from the "Join a Game" menu. The virtual keyboard can be used to insert the IP address.

Note that the host needs to properly forward their ports and ensure that their public IP is accessible from the Internet.

At the moment there is no server browser and no dedicated server support. Also, only Windows servers are supported. Dedicated Linux servers and an easier way to play together will be the next goals for Quake VR.

Troubleshooting

  • The game seems to work fine, but there is no audio!

    • Ensure that the correct audio output device is set (HMD) and that the volume is turned up.

    • Open the Desktop view from your Steam VR dashboard, and make sure that the Quake VR window is in focus. You can bring it in focus by clicking on it.

    • Check that the in-game audio settings are correct.

  • How do I obtain the grappling hook?

    • The grappling hook is available in the sandbox map, accessible through the "single player" menu.

    • The grappling hook is also available through cheats: it is a very fun toy but it would completely break the progression of most levels. To obtain it, go to the "Debug Utilities" sub-menu under the "Quake VR Dev Tools" menu - there will be an option to enable it there. You can then spawn it by using the "Impulse 14 (Spawn All)" command, or cycle to it if you have weapon cycling enabled.

  • My issue is not listed here!

Credits

(Please forgive me if I am forgetting someone. I will update this list as needed.)

Support The Project

Fan Coverage

(Thanks everyone for playing Quake VR! If you have created content related to the mod, please let me know and I'll add it to this list.)