Hello World
Updated: Mar 26, 2025
This page guides you through creating a simple Virtual Reality (VR) project in Unity, with instructions on the following:
- Setting up a Unity project for an app that can run on a Meta Quest headset
- Adding basic user input from a Meta Quest controller and hands
- Streaming an app to a headset
To follow this tutorial, you need the following prerequisites:
- Supported Meta Quest headset
- USB-C cable
- Development machine running Windows 10+ (64-bit) or macOS Sierra 10.10+ (x86)
- Unity ID
- Unity Editor 2022.3.15f1 or higher (Unity 6+ is recommended) with the following modules installed:
- Android Build Support
- OpenJDK
- Android SDK & NDK Tools
- Link (Windows only)
Create a new 3D Unity project:
- Open Unity Hub.
On the Projects tab, select New Project.
- Select the Unity version you want to use to create the project.
- Choose the Universal 3D template, a blank Unity project template built on the Universal Render Pipeline.
- Enter your project name, a save location, and a Unity organization (you can use the default organization that Unity creates for you).
- If applicable, select Connect to Unity Cloud and Use Unity Version Control.
Select Create Project.
While Unity is opening, you can add Meta XR SDKs to your Unity assets:
- Go to the Unity Asset Store, and sign in using your Unity credentials.
- Navigate to the Meta XR Core SDK page.
Select Add to My Assets to add the package to your Unity account’s assets.
- Navigate to the Meta XR Interaction SDK page.
Select Add to My Assets to add the package to your Unity account’s assets.
With your new project open in the Unity Editor, you can now configure the project for Meta XR development:
Navigate to File > Build Profiles.
- On the left of the Build Profiles window, under Platforms, select Android.
On the right of the Build Profiles window, select Switch Platform.
Install the Unity OpenXR Plugin Navigate to Edit > Project Settings to open the Project Settings window.
- Select XR Plug-in Management on the left of the Project Settings window.
If XR Plugin Management is not installed, select Install XR Plugin Management.
In the Android settings tab, select OpenXR.
Navigate to Window > Package Manager.
On the left side of the Package Manager window, select My Assets.
Meta XR Core SDK and Meta XR Interaction SDK should be in the list of your assets.
When Unity prompts you to enable the Meta XR feature set, select Enable.
When Unity prompts you to restart the Unity Editor, select Restart Editor.
The Unity Editor will restart and reopen the Package Manager window.
When Unity prompts you about the Interaction SDK OpenXR Hand Skeleton Upgrade, select Use OpenXR Hand.
From the top of the Unity Editor, expand the Meta XR Tools drop-down list, and then select Project Setup Tool.
In the
Project Setup Tool window, quickly configure your project for Android by selecting
Fix All to fix
Outstanding Issues and
Apply All to apply all recommend configurations.
You Unity project is now configured for Meta XR development.
Delete the Main Camera that comes preloaded into your project’s SampleScene.
From the top of the Unity Editor, expand the Meta XR Tools drop-down list, and then select Building Blocks.
In the Building Blocks window, find the Camera Rig Building Block, and then select the icon on the bottom right of the block to add it to your project.
Your project should now have the Meta XR camera rig Building Block in its Hierarchy.
To add a grabbable 3D cube to your scene, use a Grab Interaction
Building Block:
In the Building Blocks window, find the Grab Interaction Building Block, and select the icon on the bottom right of the block to add it to your project.
Note: When you add a Building Block to a scene in Unity, the Building Blocks tool adds all dependencies for that Block’s feature to the scene.
Select the [BuildingBlock] Cube in the Hierarchy.
In the Inspector, under Transform, change the Position to [0, 1, 0.25] to bring the Cube into view.
Test your project with Link
Link is a development tool that enables you to stream applications from your development machine directly to your headset, eliminating the need to build a project for your target device and deploy the app to your headset on each test run.
Note: Link makes your device behave like a PC VR headset until you turn the tool off. To speed up testing build time, we recommend using Link during XR application development, even if you only intend to release your app as a standalone headset app.
Note: Link is currently only supported on Windows. If you are developing on macOS, or developing without access to a headset, use
Meta XR Simulator.
To set up Link on your development machine:
- Download Link and install the app on your machine.
- Put on your headset.
- Open the Quick Settings window by selecting the clock on the left side of the menu bar.
- Open Settings, select System > Quest Link, and toggle Quest Link on.
Select Launch Quest Link to start Link on your development machine and on your headset.
- In your Unity project, press Play(â–º) to run the app on your headset.
After you have installed Link on your machine and enabled Link on your headset, you are ready to stream the app to your headset.
Press the Play button at the top of the Unity Editor.
Use your hand to grab the cube in VR.
Use your controller to grab the cube in VR.
To learn more about getting started with Meta XR development in Unity, see the following resources:
