Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »


For those developers using the OSVR open source platform then CRYENGINE can be setup so that the OSVR SDK is used and an HMD connects to CRYENGINE.



OSVR requires an OSVR Server to be running in order for CRYENGINE to connect to the HMD. The easiest way to acquire the server and to test it is to download and install the OSVR Render Manager from here.

After installation, the Render Manager creates a series of shortcuts to the start menu. Click the OSVR Server shortcut to start the server.

Pay attention to what the server prints. It should report that it has found your HMD device. If not, check that you have plugged in the HMD correctly.

Next, verify that directmode works; use the D3D Example that comes with the Render Manager. If the example fails to start and closes without showing anything on the screen, then this means that directmode didn’t work correctly. Refer to the readme.txt provided with the Render Manager to check what driver version etc. is required.

Once the Server is running and you have verified that directmode works you are all set to use the OSVR with CRYENGINE.

NOTE: The OSVR server can also be run without directmode. Just select the non-directmode config and start the server. This will create a separate window to show the HMD output, but you can still use the HMD to change head orientation etc.

Starting the Engine with the Headset Enabled (Game Mode)

To enable VR in CRYENGINE then follow the steps below:

  1. Connect the device to your computer
  2. Make sure the vendor runtime/application recognizes your headset as ready for use
  3. Install the OpenVR plugin by adding the following line to the plugin section of your .cryproject file

    { "type": "EPluginType::Native", "path": "CryOpenVR" }

  4. Add 'sys_vr_support=1' to your system.cfg or user.cfg file
  5. Launch the Engine

Once launched, the Engine should be rendering to your head-mounted device.

Making Changes to a Level (Edit Mode)

If you want to make changes to a level i.e. edit your game then you will need to disable VR.

  1. Remove all VR plugins from your .cryproject for e.g. { "type": "EPluginType::Native", "path": "CryOpenVR" }. NOTE: This includes VR plugins related to all HMD's and from all manufacturers 
  2. Remove sys_vr_support from your system.cfg or .cryproject
  3. Ensure that any other VR specific features are disabled

Reverting back to Game Mode

When reverting back to game mode then all of the above steps/any changes made must be reverted

308 admin error

Launch the Engine as admin if you encounter error 308

  • No labels