Getting Started

This tutorial covers how to set up a VR/XR project using Unity 6+.

The first thing you need to do is set up a Unity project, over the last few years Unity and Meta have releases many updates, each release making it easier to do so.

This tutorial will go over setting up a new Project using Unity 6.2 in late 2025.

Requirements

• Unity Hub installed from Unity Downloads.

• Unity Account created at Unity Website.

Installing the Project

• Open Unity Hub and sign in.

• Install Unity version 6.2 or later.

  • In the 'Unity Installs' section, select a Dev Tool (such as 'Microsoft Visual Studio Community 2022') and 'Android Build Support' with both 'OpenJDK' and 'Android SDK & NDK Tools' installed under 'Platforms.

• Start a new '3D' project using the 'Universal Rendering Pipeline (URP)'.

  • Set you Unity Organization, or set one up on id.unity.com on your Unity account.

  • Give your project a name, this will be the folder name in the Project Location.

  • Assign the Project Location.

  • Toggle Use Unity Version control as desired.

  • Select '+ Create project'

Setting up the Project

• Once your project has loaded, add the Meta Quest Build Profile.

  • Go to 'File / Build Profiles'.

  • Add 'Meta Quest' on the left of the Build Profiles Window.

    • If there is no Meta Quest profile, select the 'Add Build Profile' button at the bottom of the platform options and add it from there.

  • Once added, make sure to select 'Switch Platform' at the bottom of the 'Build Profiles' window.

    • A popup may appear asking to install missing packages, select 'Install'.

• Adding the Meta XR packages.

  • Depending on your approach to packages, you could either import the packages you need one by one in order to keep your project as small as possible, or use the 'Meta XR All-in-one SDK' to install all of the packages at once for a larger filesize.

  • The minimum requirements would be :

    • Meta XR MR Utility Kit

    • Meta XR Core SDK

  • Add the packages to your account from the Unity Asset Store.

  • Install the packages using the Package Manager in Unity.

    • A Popup may appear asking to adjust some setting, make sure to select 'Yes'.

    • A Welcome to Meta XR SDK popup may appear offering resources. Feel free to go through those or close the window.

• Refine the Project settings.

  • Select 'Meta / Tools / Project Setup Tools'.

  • The 'Project Settings' window should appear with a bunch or warnings.

  • Go to 'XR Plugin Management' in the left panel.

  • Make sure that 'OpenXR / Meta XR Feature Group' is enabled in both 'Desktop' and 'Meta' tabs.

  • Select 'Meta XR' in the left panel.

  • Select 'Fix All' to the right of the window for the Project settings to be fixed.

  • Select 'Apply All' to the right of the window for the Project settings to be improved.

  • Do this under all the tabs in the Project Settings / Meta XR panel.

• Solve any remaining issues or warnings.

  • If you have any issues with warnings or errors still visible, you may need to do your own research to solve them as it depends on the issue.

  • Every release tends to come with at least one or two issues, so depends on whcih version of Unity you are using, and which approach to VR/XR you are using such as updates that have been released after this tutorial was made.

Getting Started on the Scene

• Clean up the Unity scene.

  • Remove the 'Main Camera' from the Hierarchy.

  • Remove the 'Global Volume' from the Hierarchy.

• Add Meta 'Building Blocks' to get started.

  • Select 'Meta / Tools / Building Blocks' to display a list of assets you can add to your scene to get started quickly with your Meta Quest such as Camera rig, passthrough, and interactive elements.

  • Select the image to see details for each Asset, or the Icon at the bottom right to install the asset into your project.

  • Make sure you have the 'Camera Rig' asset installed before moving onto the next tutorial.