Skip to content

nephatrine/nephq2

Repository files navigation

###NephQ2

This is my fork of Quake II VR, a VR-enabled Quake II engine based on the KMQuake II engine.

####Features

  • Gamepad Support
  • Oculus Rift Support (0.4.4-beta)
  • OpenAL HRTF Support
  • SteamVR Support

####Issues

  • Linux binaries build, but segfault on initialization. Could be because I'm testing on a Linux VM without any HMD attached or maybe I just screwed up somewhere. GDB hangs the entire VM so I can't debug.
  • Linker errors trying to build with MinGW on Windows. I probably need to build all the deps with MinGW instead of linking the MSVC ones, but that's too much work. Use VS Express Edition if you're on Windows.

####Play Requirements

Getting Quake II

Retail Game Q2 Demo Q2 Patch

I suggest purchasing the retail version of Quake II from Steam to support id Software and get the full game assets. If you cannot, you can get a limited version that does not include the majority of the single-player campaign for free. Do this by installing the free demo and then installing the official 3.20 patch on top of it. The stock 3.20 binaries no longer run on most modern systems so if you intend to play the vanilla game, the unofficial Quake II 3.24 patch will allow you to do so on Windows.

There are also "starter packs" that will handle installing the demo, patch, and working binaries for you automatically available for Windows (32-Bit) (installs Q2Pro engine), Mac OSX, and Linux (64-Bit).

Installing NephQ2

Data Files Binaries

Place the NephQ2 data files into your Quake II baseq2 directory. You'll have to either build the binaries yourself or use the compiled 32-bit Windows binaries from AppVeyor. These have not been tested in most cases and do not support SteamVR. Place the binaries into your Quake II directory.

####Build Requirements

Build Status

You'll need to download the Oculus Rift SDK and extract it into the external/OculusSDK directory inside your working directory. If you are on Linux, you will need to build the library with the Makefile included.

If you want SteamVR HMD support, you'll need to download the Steamworks SDK and extract it into the external/Steamworks directory inside your working directory.

On Linux, you'll need to ensure the following packages are also installed:

  • libglew-dev
  • libminizip-dev
  • libsdl2-dev

On Windows, precompiled binaries for these libraries built with MSVC 2013 (VS12) will be included.

If you are on a different platform, you may need to download and build these libraries yourself:

####Acknowledgements

  • id Software for creating the original Quake II and releasing the source to the community.
  • Oculus VR for creating the Oculus Rift and reviving interest in virtual reality.
  • Knightmare for his work on the KMQuake II engine.
  • Luke Groeninger for his work on Quake II VR.