DukeVR - Duke 3D for VR HMDs / Oculus Rift

Updated Apr 17 2016, v2.13 - Oculus SDK 1.3 (DK2 and CV1 support)
Based on the EDuke32 port of Duke Nukem 3D

By Malcolm Smith

Known Issues / Limitations:

• Rift Headphones: If you want to use them, you must set them as the default audio output device in Windows before launching the game. DukeVR currently doesn't use the "VR Audio Output" setting in Oculus Home.
• Joystick vibration doesn't work if you're using the "Use Oculus controller support" option.
• Independent aim / looking directions are not supported. You'll shoot exactly where your crosshair points, and that's tied to the direction you're looking in.
• You cannot look completely up or down (your free look will stop after +/- 65 degrees from level). This is an engine limitation.
• The crosshair / HUD depth adjusting logic isn't perfect. The crosshair can still look doubled sometimes if you're very close to walls, if you're looking at a sprite / model instead of a wall, or if you're looking into a mirror and focusing on something in the projection.
  NOTE: If you have a DK2, and encounter crosshair doubling after moving around (with positional tracking) a lot: Try the "Recenter Oculus Position / Orientation" command ('G' or click the right XBox360 stick), it usually fixes it.
• DirectInput joysticks: Occasionally the analog axes think they're being activated when they're not. Use XInput mode for gamepads / joysticks, if your device supports it. (And make sure "XInput" is checked at the startup screen.)
• Positional tracking is implemented 'noclip-style', meaning you can lean into walls / solid surfaces - I wouldn't recommend doing so though.

A mid to high range PC is recommended.

Input Devices:

• A keyboard and mouse is the most common way to play. However, gamepads/ joysticks are also supported by EDuke32. The joystick config has been optimized for the XBox 360 / XBox One controller, so that should work out of the box. For more info, see the Readme.
• If you're using an XInput controller that Oculus Home doesn't know about, you should still be able to use it with DukeVR. In that case, at the startup screen, choose "Controller 1" / "Controller 2" / etc that you want to use, verify you chose the right one by pressing buttons and ensuring that they show up in the "Press buttons / axes to test controller" area of the startup screen.
  However, if you're using the XBox 360 controller / XBox One controller, you should just be able to use the "Use Oculus controller support" option.

High Resolution texture & 3D Model support

• DukeVR supports the HRP for EDuke32, which supports high resolution textures (and skyboxes), and 3D models instead of 2D sprites for the player / enemies / other objects. If you have a powerful PC, you can try out the High Resolution Pack. If you want to play with a more retro feel, you can still disable the 3D models if you wish, in the in-game Video Options.
• Note: As of v2.0, the HRP's high resolution skyboxes are bundled by default with Duke VR, which look correct when you move your head up and down. Be sure to keep the HRP_skyboxes option for "Custom Game Content" selected when starting EDuke32.

Registered / Full Versions of Duke 3D

• Either the shareware or registered / full version of Duke 3D is supported. If you don't have a registered copy of Duke 3D, the shareware version is included.
• If you have a registered version, copy DUKE3D.GRP (~43MB) into the DukeVR directory before playing.
• Where to buy the full version of Duke 3D: Megaton Edition on Steam, Good Old Games, etc.
  Unfortunately it doesn't look like Duke 3D is for sale online right now (as a digital download), so the only legal option to get the registered version is probably checking eBay / other used game sites for the CD version.

Expansion Packs

• Expansion packs such as Duke It Out in D.C. should work fine.
• There are instructions for using Duke It Out in D.C. (Megaton / Steam version) in the Readme. For other addons, follow the official addon installation guide for EDuke32.
• There are addons to the High Resolution Pack (HRP) which provide high res textures and models for the expansion packs too. For info on how to use these, follow the Official Addon Installation Guide, and look for the "addon HRP SVN" instructions.

• DukeVR_v2_13.zip includes the game (modified EDuke32), the shareware game data (1st episode out of 4), and a full Readme document.
  Please see readme.txt for an Oculus quick-start guide.

• Go to the Duke HRP download page. Download the "Duke3D HRP v5.4 FULL SFX (986 MB)" package. The DukeVR readme has a Quick Setup section for using the HRP.

Source code:

• DukeVR_v2_13-src.zip includes the source code of DukeVR (base EDuke32, and the DukeVR + Oculus specific modifications.)

If you get an error about MSVCR110.DLL being missing, you probably need to install the Visual C++ 2012 redistributable (32 bit version).

• http://www.microsoft.com/en-us/download/details.aspx?id=30679 - click Download, and choose vcredist_x86.exe.

Screenshots

(From Duke VR v2.0, DK2) E3L2

(DK1, v1.0) Main Menu


(DK1, v1.0) E1L1 #1


(DK1, v1.0) E1L1 #2


(DK1, v1.0) E1L1 #3 (with optional High Resolution texture Pack)


(DK1, v1.0) E1L1 #4 (with optional High Resolution texture Pack)


(DK2, v2.06) E1L2 #1

---

• Malcolm Smith - DukeVR modifications (SBS 3D, external 3DOF Data support, SBS Warp support, Oculus integration, etc.)
• EDuke32 - TerminX, Pierre-Loup "Plagman" Griffais, Philipp "Helixhorned" Kutin
• Jonathon "JonoF" Fowler (work on one of the first Duke windows ports)
• Ken Silverman (Build Engine, initial OpenGL renderer for Duke Windows port)
• SBS Warp Shader adapted from the one in OpenHMD
  (Note: Only used in non-Oculus VR mode now)
• Oculus VR, for the Rift dev kit and their SDK.

License

DukeVR main component:

• The Build engine is licensed under Ken Silverman's Build License which can be found in BUILDLIC.TXT of DukeVR.zip.
• The EDuke32 port is licensed under the GNU Public license (GPL) which can be found in GNU.TXT of DukeVR.zip.
  The DukeVR modifications (SBS 3D, external 3DOF Data support, SBS Warp support, etc.) are also under the GNU Public License (GPL).