NullVR Gem - Lumberyard User Guide

NullVR Gem

Open 3D Engine (O3DE), the successor to Lumberyard, is now available in Developer Preview. Download O3DE or visit the AWS Game Tech blog, O3DE Discord, or O3DE GitHub to learn more. The Lumberyard forums have been deprecated. You may view past forum discussions in the archive.

Use the NullVR gem to run your level through the head-mounted displays (HMD) framework without a connected VR device. This gem is useful for VR graphics debugging.

The NullVR Gem has a lower priority than other VR gems and their devices. That means that if any other VR gem is enabled and its appropriate VR device is connected, then the HMD framework uses that VR gem. The NullVR Gem is enabled only if no other VR gem is enabled or no VR device is connected.

When Lumberyard is using the NullVR Gem, the following appears in the console:

[HMD][Null] - Null Device

Console Variables

The NullVR Gem, when enabled, makes certain console variables available. These console variables take effect only if the NullVR Gem is in use; that is, no other VR gems are enabled or no other VR devices are connected.


The default values in the following list came from Vive at the time of this writing.


Aspect ratio of the null VR implementation.

Default: 0.9


Eye X offset (horizontal distance).

Default: -0.0346999988


The field of view in radians. Can be updated at runtime.

Default: 1.91986


The field of view height in radians. Used on start.

Default: 1.84633982


The field of view width in radians. Used on start.

Default: 1.94590104


Frustum plane horizontal distance.

Default: -0.0701720715


Frustum plane vertical distance.

Default: -0.00206005573


The height of the render texture in pixels. Set once on start.

Default: 1680


The width of the render texture in pixels. Set once on start.

Default: 1512