The first step in setting up your development environment is to install the Unreal Engine version of your choice.
To access the Oculus-VR fork of Unreal Engine, ensure you have a verified Meta Developer Account. Your Epic Games and GitHub accounts must also be linked. For detailed guidance and hardware requirements, see Prerequisites for installing Unreal Engine.
Set up your Meta Quest development environment by using one of the following methods:
UE 5.0+, built from Meta’s Oculus-VR fork of Epic Games’ UE 5.0+ (Recommended)
UE 5.0+, installed from Epic Games, plus the Meta XR plugin
May be necessary for multi-platform releases, such as simultaneous releases on Meta Quest and non-VR platforms.
Note: All supported Unreal Engine branches can create applications for all Meta Quest headset generations.
UE4 deprecation
UE4 is no longer the recommended version. For legacy UE4 installation instructions and compatibility information, see Legacy UE4.
Changes in Meta’s fork of UE
Since Epic Games’ Unreal Engine provides source code access, and Meta’s Oculus-VR fork provides source code access, it is possible to review every changed line of code in Meta’s fork of UE.
Engine integration of Meta XR features, which removes the requirement to install Unreal Engine’s Meta XR Plugin.
Installing UE 5.0+, Meta’s fork
This installation includes Unreal Engine 5.0+, the Meta XR plugin, and additional features and fixes that make UE work seamlessly with Meta Horizon OS. It’s recommended to use this installation for the latest support with Meta Quest features and improvements.
Note: It is not necessary to install the Meta XR plugin separately when installing Meta’s fork of UE 5.0+.
In the Oculus-VR fork of Unreal Engine on GitHub, open the branch list, and then select the Tags tab.
Note: Remember that to access the Oculus-VR fork of the source code, you need a verified Meta Developer Account, as well as Epic Games and GitHub accounts that are linked. For more information, see Prerequisites for installing Unreal Engine.
From the list, select the UE version you want. The first version number in the tag name (that is 5.4.3) corresponds to Unreal Engine version, and the last version number (that is v69.1) corresponds to Oculus Platform SDK version.
Note: It’s recommended to choose the latest version for the newest features and bug fixes.
Click Code, and then click Download ZIP to download the files.
Note: If you prefer, follow the instructions under “Getting Up and Running” in the README to clone your own private fork and then compile and run the UE editor.
Unzip the folder to the preferred location on your development machine.
Important: To avoid potential errors when building, be aware that exceeding the Windows maximum path length will fail your build. If you’re concerned, don’t map to a network share. This will slow down the build process significantly. Instead, create a junction point for the directory.
Installing UE 5.0+ from Epic Games
Install UE 5.0+ directly from Epic Games using the Epic Games Launcher. You’ll need to install the Meta XR plugin separately. This means you’ll miss additional features and fixes in the fork. For more information, see Installing the Meta XR Plugin.