Setting up your first project
Updated: Dec 16, 2024
Set up your project using Unreal Engine to take the first step toward developing a Meta Horizon OS app.
To do this, you must have already set up your development environment, including installing Unreal Engine and the Meta XR plugin. This section assumes that you are using Unreal Engine 5.4.4 and that your dev environment has been set up from the Oculus-VR fork of the Unreal source documents and includes the Meta XR plugin, along with any additional Meta fixes and functionality available in this UE version. If you are using another version of UE, the process should be relatively similar to the one shown here. For more information, see
Setting up your dev environment.
The following steps are needed for setting up your project:
Additionally, if you need to adjust multiple settings in the Meta XR plugin, the following is available:
You can have multiple versions of Unreal Engine on your computer at the same time. Select the version to work with on your new project in the Epic Games Launcher when you create your project.
Note: Epic Games is constantly iterating Unreal Engine. As a result, the newest version changes frequently, but regardless of the version, your process should look similar to the steps in this section. These examples use UE 5.4.4.
To create your first project in Unreal 5.4, do the following:
- Open the Epic Games Launcher and then open the Library tab.
Under Engine Versions, find the entry for Unreal 5.4.4 and click Launch.
In the Unreal Project Browser, select Games and then Virtual Reality.
A description of the generic Virtual Reality template is shown on the right. Clear the Starter Content option.
More information on what is included in this template can be seen in the template window.
At the bottom of the screen, set the Project Location and Project Name.
- Click Create to create the new project from the VR template.
Note: There are a variety of other templates for new projects, as well as other default options, but these are discussed elsewhere.
With your project created, you need to configure it. How you configure your project depends on your organization and your project’s needs. Some of the configuration options (such as Description) are largely informational and may only affect your project’s metadata. However, other options include packaging, encryption, and so on. We highly recommend you at least review all options when configuring your project.
To configure a project in Unreal Engine, do the following:
- Load your project in Unreal Engine.
In the Unreal Editor, go to Editor and select Project Settings.
Under Project in the left nav, go through the list of configuration and information options for your project, filling out the appropriate information for each one as required by your organization and your project’s needs.
Note: There are multiple sections covering the various options.
- Restart the Unreal Editor if prompted.