Upgrading Projects to 2022

This page explains how to upgrade your VRChat project from version 2019.4.31f1 to Unity 2022.3.6f1. Unity 2022 is required to use the latest version of the VRChat SDK. You can check out the benefits to upgrading here.

If you're using the Creator Companion, upgrading your project is easy! But first, make sure you create backups of your projects.

Backing up your Unity project

If you're using the VRChat Creator Companion, it will automatically suggest copying your project before migrating it.

1. Click the three dot menu next to the Manage Project button, then choose the "Create Backup" option.
   • Otherwise, duplicate the whole project folder and give it a new name.
   • Export your entire project as a Unity Package. This takes a long time and may cause errors.

Creating a backup.

Don't skip this step!

Upgrades can fail. If you keep your original project files safe, you can restore them, try again, and find out what went wrong.

Without a backup, you don't get a second try. If you make a mistake or the upgrade fails, fixing it may be difficult or even impossible.

2. Open your project in Unity 2019 to see if there are any errors or warnings in Unity's console or the VRChat SDK Build panel.
   • If you don't fix issues in your Unity 2019 project, they may cause issues in Unity 2022.
   • Some warnings can be safely ignored. But try to understand why they are happening.

Now you're ready to upgrade!

Using the Creator Companion

There are two ways you can upgrade your project from the VCC: Directly from your Projects page or from each Manage Project page. Make sure the project you are trying to upgrade is closed before proceeding.

1. Go to Settings, then click Updates to see if your Creator Compaion needs to be updated. Without updating, prompts to upgrade to Unity 2022 will not show.

Check VCC updates.

2. On the Projects page, you'll see a new Unity column with a version switcher for each of your projects. Click this, then click Migrate to Unity 2022.

Click correct project.

Otherwise, click Manage Project on any project and you'll see an Upgrade to 2022 banner.

Upgrade via Manage Project.

Using the Unity website

Unity Hub is a separate application that allows you to seamlessly install and work with multiple Unity versions at one time. You can also use it to install Unity 2022 if you do not wish to use the Creator Companion.

1. Install the Unity Hub.
   • You can follow Unity's official installation guide.
   • You'll need to create a Unity account after installing Unity Hub.
2. Visit Unity's download archive.
3. Click Unity 2202.x.
4. Scroll down until you see Unity 2022.3.6.
   • Do not choose the first Unity version in the list!

Select the right version to install in the Unity Archive.

• Click the blue Unity Hub button.

Accept the browser prompt to open Unity Hub.

5. Click Open Unity Hub in your web browser.

Enable Android Build support if you'd like to be able to develop content for Android devices.

6. Enable Android Build Support in the Unity installation screen.
   • You can skip this if you're not planning on uploading content to Android or Quest yet.
   • You can complete this step later by choosing Add modules in the Unity Hub.
7. Click Continue to install Unity 2022.3.6.

Managing Unity versions

It's easy to check what versions of Unity are available on your PC for use with the Creator Companion. You can also change what version of Unity is used to open all new projects.

1. In the CC, go to Settings.
2. Under Unity Editors, use the dropdown menu to change the default Unity editor. This will not apply retroactively to any projects already created.
3. If you have not already installed Unity 2022.3.6, follow the instructions above.
4. If you don't see a version of Unity here that you've installed, try using the refresh button or finding the path directly using the file button.

Packages

If you are trying to add packages to your 2022 project, please keep in mind:

• Every Curated Package has a version which works in 2022.
• Other packages may work, but some may need a new version from the package author.

Troubleshooting

• Test your world before uploading it. Check Unity's console for errors, and test your world in VRChat to see if it work.
  • After successfully uploading a world with Unity 2022, you won't be able to upload that same world with Unity 2019.
• Make sure to activate your Unity Personal license before using VRChat's SDK. Unity is free for personal use.
• To learn more about the Unity Hub, visit Unity's documentation.
• If you're experiencing issues related to the SDK itself, please read our SDK Troubleshooting page.