top of page
HighresScreenshot00042.png

Start Guide

​This is the start guide tutorial in which you can get all the required information for starting with Head Mounted VR plugin.

General Information​

Head Mounted VR (HMVR) is a plugin/framework for Unreal Engine, designed to streamline VR development with pre-built, game-ready features. It is not an asset pack or standalone project but a toolset that integrates seamlessly into your Unreal Engine projects. Inspired by games like Half-Life: Alyx, HMVR offers physically based interactions, VR-specific classes (e.g., VR Player, VR Hands), and blueprint accessibility, making it ideal for developers of all skill levels building VR experiences.

This guide will help you install, enable, and start using HMVR in your project, with a focus on practical steps and essential resources.

guns.gif
Hands.gif
Getting Started

  1. Install the HMVR Plugin

    • Purchase and download HMVR from the FAB or website.

    • Extract the .zip file into your Unreal Engine’s Plugins folder (e.g., UE_5.X/Engine/Plugins/Marketplace/) or your project’s Plugins folder(Project/Plugins).

  2. Create the blank project.

    • WARNING:  THE UNREAL ENGINE VR TEMPLATE MAY OVERRIDE THE INPUT MAPPINGS (IN YOUR PROJECT SETTINGS). TO AVOID THIS ISSUE, IT IS RECOMMENDED TO USE A BLANK TEMPLATE INSTEAD OF THE VR TEMPLATE WHEN STARTING YOUR PROJECT.

  3. Enable the Plugin

    • Open your project in Unreal Engine, go to Edit > Plugins, find “Head Mounted VR,” enable it, and restart the editor.

    • NOTE: ENABLING HMVR SHOULD AUTOMATICALLY ENABLE ADDITIONAL PLUGINS, SUCH AS "OpenXR" AND "OpenXR Hand Tracking". THESE PLUGINS ARE ESSENTIAL FOR VR FUNCTIONALITY AND HAND ANIMATIONS. MAKE SURE PLUGINS ARE TURNED ON.

  4. Configure Your Project

    • Download the required DefaultEngine.ini config file from here.

    • Replace your project’s Config/DefaultEngine.ini with this file and restart Unreal Engine.

    • NOTE: THIS FILE INCLUDES PC VR-READY SETTINGS, ADDITIONAL COLLISION CHANNELS, AND SURFACE TYPES TO ENSURE THE PLUGIN FUNCTIONS CORRECTLY.

    • WARNING: THIS CONFIG FILE IS PC VR ONLY. FOR ANDROID VISIT META QUEST SETUP PAGE.

  5. Access the Demo

    • Demo can be found by turning on "Show Plugin Content" in the UE content browser.

    • Demo content is located at HeadMountedVR/Content/Demo/, open a demo map, and test it in VR Preview mode.

image.png
image.png
bottom of page