Tutorials

Update VR Builder

Updated on

October 12, 2023

Updating your VR Builder projects is not a complicated process, but in case you get stuck, you can always find help in our community.

Summary

To correctly update to VR Builder, you will need to:

Remove old Asset Folders
Import VR Builder
Fix interaction layers and snap zones

Detailed steps and fixes are provided below.

Step 1: Make a backup

You probably hear it all the time, but a reminder never hurts. Before making any potentially breaking changes, back up your project! Or even better, use a source control system like Git.

Step 2: Remove old Asset Folders

Due to the update mechanism of the Unity Asset Store, old files will not be removed when updating an asset. Therefore, it is advised to delete the old files before you update. The folder you want to delete is MindPort\VR Builder\Core. Also, delete any MindPort\VR Builder\Add-ons\ that you want to update.

Step 3: Import VR Builder

Now you can finally import VR Builder. Open the Package Manager and import the latest version of VR Builder.

Note: This update guide was created for updating from v2.0.0 to v3.3.1. Depending on the versions you are upgrading from, the errors might be slightly different or significantly fewer. There is a high chance that restarting Unity, potentially multiple times, will resolve all issues.

After importing the package, you will likely encounter some errors. Just restart Unity.

When restarting, if you are asked to go into Safe Mode, ignore it.

Now, Unity will fetch new dependencies that were added since your last version update.

Unity might get stuck during this process. If “busy for …s” remains for too long, you can restart Unity.

After the restart, Unity will continue to fetch new dependencies.

When XRI is updated you will be notified.

After all dependencies have been fetched, the Project Wizard will show up. Click through it, as you might find new features like localization that you want to activate.

Step 4: Update Add-ons

After importing VR Builder, you should update any VR Builder add-ons in the project as well. This can be done easily by opening the Package Manager and updating the relevant packages.

Note: If you have not already done so, it is advised to delete the old files before you update. The folders are MindPort\VR Builder\Add-ons\[addon name].

Step 5: Delete demo processes

Demo processes might have received some minor updates. To ensure the most recent file is copied to the StreamingAssets folder, navigate to Assets\StreamingAssets\Processes and delete all “Demo” folders. Then to get the new files open demo scenes from the VR Builder menu.

Conclusion

Congratulations! Now your project is updated to the latest VR Builder version.

Feel free to have a look on at the release notes you find them on the Asset Store or on GitHub.
You can see our plans for the future of VR Builder in our roadmap.

If you like what we are doing and enjoy VR Builder, please leave a positive review on the Unity Asset Store. This would help us immensely to further grow our community and ecosystem and maintain the free and open source VR Builder project in the future.