If you need to update your SDK, it is important that you follow these steps to ensure the update proceeds properly and you don't have any old/conflicting files.
Migrating from Unity 2017 to Unity 2018
If you are migrating an old project from 2017 to 2018, you MUST follow the instructions given in Migrating from 2017 LTS to 2018 LTS.
Here's how you update your SDK. If you're just uploading avatars, you can use the following process:
- Please ensure you're using the correct Current Unity Version.
- Download the latest version of the SDK. See the Choosing your SDK page to see how to choose the correct SDK for your use.
- Close Unity.
- Find your Project folder with Windows Explorer, and find the Assets folder.
- Delete the VRCSDK folder, as well as the VRCSDK.meta file in the Assets folder.
- If you are using SDK3+Udon, delete the Udon folder, as well as the Udon.meta file.
- Relaunch Unity, and then re-import the freshly-downloaded SDK. Do so by going to Assets, then Import Package, then Custom Package.
- Select the new SDK (you probably saved it in Downloads)
- Wait a moment, and click "Import" in the bottom left. If any files in the list are greyed out/unchecked, and you can't check them, you didn't delete everything you should have! Start over.
- Wait a minute as the SDK finishes importing.
- In each scene, enter Play mode, and then end Play mode. You may receive a message from Unity that it needs to update some parts of the scene. Follow those instructions, and then restart Unity.
- Done! You should be good to go.
If you're reinstalling the SDK in a project that contains a world using complex trigger setups, here's a safer way to update your SDK.
- Close Unity
- Back up project to another folder (do not back up the Library folder, these files are auto-generated by Unity)
- Delete SDK and Plugins folder, as well as the the associated .META files
- Create a new dummy Unity Project
- Install the latest SDK on the dummy project
- Copy the newly added SDK/Plugin and associated .META files from the dummy project into your original project
- Done. Now you can open your upgraded project, and there will be no crash no matter how complex your trigger work!
If you are updating from a previous version of Unity, we have a guide for updating to our latest version we support! Check out the relevant page below:
Updated about 13 hours ago