Updated on
December 12, 2022
In this VR Builder tutorial, you will learn how to set up VR Builder. After following this tutorial, you will have your Unity project ready to run in VR as well as the foundation to explore more VR Builders capabilities in Unity.
If you are familiar with Unity already, you likely want to skip some of the first chapters.
In the next chapters, we will cover:
For this VR Builder tutorial we assume you have already installed Unity and created a new, empty project using a 3D template.
If you haven't installed Unity yet, you can find excellent documentation on how to do this right from Unity themselves:
If you are completely new to Unity, you might also want to check some basic concepts. The documentation on how to use the Unity Editor (docs.unity3d.com/Manual/UsingTheEditor) and Unity Learn (learn.unity.com) are both valuable resources to do so.
If you are not sure which Unity version to use, we'd recommend using one of the newest LTS (long term support) versions.
In case of doubt, please also check the compatibility section of the VR Builder description on assetstore.unity.com/packages/tools/visual-scripting/vr-builder-201913.
Please have Unity running and a new, empty project open before continuing. This ensures that VR Builder will be added to the right project.
The easiest way to get VR Builder from the Unity Asset Store is to visit VR Builder's product page: assetstore.unity.com/packages/tools/visual-scripting/vr-builder-201913
The next 3 steps are:
In your web browser, on the right side of the Asset Store product page, you can find the button Add to My Assets. Select this button.
After that, the same button will change to Open in Unity. Press select this button again to get back to your Unity project..
This opens the Package Manager. Select VR Builder from your assets. Then press download and after the download is completed import.
A pop up will appear showing you all the files to be added to the Unity project. Just confirm the selection by pressing "Import".
Unity will compile some files, then the following dialog will appear. VR Builder requires the new input system package, so click Yes to enable it and restart the editor.
Shortly after, a second dialog will appear. This time it’s the XR Interaction Toolkit which offers to automatically update the interaction layers.
Click I Made a Backup, Go Ahead! And wait again until the import is finished. The Unity editor will restart and the Project Setup Wizard will appear.
The Setup Wizard helps to get new or existing Unity scenes set up and ready to be used with VR Builder. In the following we will guide you through the different tabs of the VR Builder Setup Wizard.
Welcome to the VR Builder Setup Wizard.Press “Next” on the bottom right.
In the next step, you can choose some global settings. For now, only one option is available: you can check the checkbox to ensure all automatically created grabbable objects ignore physics. This can be handy if you don’t want objects to fall on the ground and need picking up by the user.
Make your choice and proceed.
Select the device you want to support and press Next. If your hardware is not listed, please reach out to us in the VR Builder Community, where you will receive direct help from us. Note that automatic setup will configure your headset to work in desktop mode. To configure your project for a standalone headset, you can follow the tutorials for the Oculus Quest or the Pico Neo 3.
The packages for the selected hardware will be imported after closing the wizard.
This page lists some useful resources to get you started with VR Builder. There is also a checkbox which lets you choose if the demo scene should be loaded after closing the wizard.
After clicking Finish, VR Builder is set up! You will need to wait a few seconds for packages to import if you selected a headset from the hardware list. Then, feel free to try out the demo scene or create your own scene by selecting Tools > VR Builder > Scene Setup Wizard….
In this VR Builder tutorial you learned how to set up VR Builder for a Unity project. Now that your Unity Project is up and running for VR, we recommend checking out the tutorial on VR Builder's Process Editor.