Develop

Mixed Reality Utility Kit Getting Started

Updated: Apr 13, 2026

This guide walks you through installing Mixed Reality Utility Kit (MRUK), loading the sample project, and adding the MRUK plugin to your own Unreal project.

Installation

Download and install Unreal Engine 5.x⁠

Download and install Meta XR Plugin

Loading the sample project

Get the sample from https://github.com/oculus-samples/Unreal-MRUtilityKitSample/⁠.

Open MRUtilityKitSample.uproject by double-clicking it. If prompted, select the Unreal Engine version you want to use.

Alternatively, on Windows, right-click the file in File Explorer and select Generate Visual Studio project files. This option requires Unreal Engine to be installed with file associations configured, and Visual Studio with the C++ workload.

On macOS, right-click the .uproject file and select Services > Generate Xcode Project.

If you generated project files, open MRUtilityKitSample.sln with Visual Studio or Rider and run it. Otherwise, the project opens directly in Unreal Editor.

Adding the MR Utility Kit Plugin to your own project

Create a new project or load your existing project.

In Unreal Editor select Edit > Project Settings > (in Plugins section) > Meta XR.

In the General section, go to the XR API list, and then select Epic Native OpenXR (Recommended). The legacy option, Meta XR with OVRPlugin, is also available but is no longer recommended.

In the Mobile section, select Passthrough Enabled, Scene Support, and Anchor Support.

Meta XR plugin project settings showing XR API, Passthrough, Scene, and Anchor Support options

Follow the typical steps for adding a Passthrough Layer to an Unreal project.

v66 and earlier only: In Unreal Editor select Edit > Plugins from the menu and search for MR Utility Kit. If the plugin was installed successfully, you should see it in the list. Enable the checkbox to activate it. If you don’t see it in the list, check that the plugin is present in the Engine\Plugins\Marketplace folder and restart the editor.