Frequently Asked Questions

Find answers to frequenly asked questions about VR Builder and how to use it with Unity and the XR interaction toolkit.
Tip: Press CTRL+F to search within this page!
Why are not all interactions possible all the time?

This feature is called 'restrictive environment'. Interactions are only possible in steps where they are required. That means that it's much easier to guide people in VR and prevent unintended interactions. If you want to enable interactions without using the correlating condition in this step, you can do so in the 'unlocked objects' tab of the step inspector.

I get a PlatformNotSupportedException when I try to build and run my project on a Mac. How do I fix this?

By default, VR Builder uses Windows' text-to-speech synthesizer which of course is not available on a Mac. To simply make it work, go to Project Settings > VR Builder > Language and set the text-to-speech provider to DummyTextToSpeechProvider. This means you'll have no voiced instructions and it might not be clear what to do in the demo, but your project will work!

Check out this FAQ to learn how to make TTS work on a Mac.

How do I generate TTS files as a MacOS user?

There are two options for you:

  1. You can synthesize the audio and just play the MP3 files with the play audio behavior. 
  2. Alternatively, you can integrate another TTS engine. This will require some coding on your end. You can also hire us to integrate your preferred synthesizer into VR Builder.
I want a snappable object to only snap when it is close to the snap zone, how do I achieve that?

You can adjust the colliders of the snappable object and the snap zone.

In addition, you can create your own instance of the snap condition and refine when a snap is fulfilled. For instance, you can check the orientation as well.

My object is not moving with the move object / follow path behavior. What's wrong?

There are three possible causes:

  1. The object reference is broken, e.g. because you are referencing a prefab. Completely unpack any prefab.
  2. The target / path is broken. Make sure those are correct as well.
  3. The object you are referencing is a "static" object.
Static objects won't move
Can I use VR Builder without an HMD (VR headset)?

Yes, there are actually 3 ways to do so:

1. You can use the menus' "skip step" functionality to go through the process and trigger each event manually. It will autocomplete the steps, that means, for example, that when skipping a step which has a snap object condition, the object will be moved and snapped to the snap zone.

2. Since we are using Unity XRI, you can use its device simulator. Here's a helpful video and the documentation with button configurations.

3. Some of our users have developed a desktop mode with which they can use the VR Builder application with mouse and keyboard. It's something you can build as well or we can assist you as part of the pro license.

My standalone application is not working, now what?

Check the set-up tutorial to make sure you’ve followed the VR Builder setup instructions correctly. Specifically XR settings such as OpenXR/Oculus  setup.

The “hands” / controllers seem to be stuck in the ground. What’s happening?

First, we would recommend you to check that your controllers work outside of the Unity environment, also check if your headset is tracking correctly as it could be an issue not related to VR Builder or Unity.
If this is correct, please check for the correct controller profile on XRIT/OpenXR.

Why is my snapzone not visible in the built application?

Most probably the model does not allow read/write. To fix this, select the model of the object in your project assets folder and open the Unity Inspector. In the model's properties, you'll find a "Read/Write" checkbox. Set it to true.

When I build my project everything disappears, help me!

This still might be due to setting up the project on a URP template.

Open your Project in Unity, and go to Edit > Render Pipeline > Universal Render Pipeline and select either Upgrade Project Materials to URP Materials or Upgrade Selected Materials to URP Materials.

Then go to Edit >Project Settings > Graphics and  in Scriptable Render Pipeline Settings select Universal Render Pipeline

Everything is pink in Unity, why is this?

You probably set up a Universal Render Pipeline (URP) project. If that's the case, you need to convert the materials as the demo scene is built with the Standard Render Pipeline.  

Open your Project in Unity, and go to Edit > Render Pipeline > Universal Render Pipeline and select either Upgrade Project Materials to URP Materials or Upgrade Selected Materials to URP Materials.

Didn’t find what you were looking for?

Leave us a message on Discord for quick support and to request a product feature or tutorial.

Write us on Discord