Upgrade Guide

This section describes how to upgrade from older version.

For upgrading to 2022 please check Upgrade to 2022.

Upgrading from realvirtual.io 2022 to realvirtual.io 6

This guide will walk you through the process of upgrading your project from realvirtual.io 2022 to realvirtual.io 6.

Caution

Important: Two-Step Upgrade Process

The upgrade must be done in two separate steps:

1. First: Upgrade your existing project (including the old realvirtual version) to Unity 6 and verify it works correctly
2. Second: Once the project runs successfully in Unity 6, then upgrade the realvirtual framework itself

Do not attempt to upgrade both Unity and realvirtual simultaneously. Each step must be completed and verified before proceeding to the next.

---

Step 1: Prepare Your Unity Environment

1. Ensure Unity 6 is Installed: Use the Unity Package Manager to install the latest Unity 6 version.
2. Select Your Project in Unity Hub: Open Unity Hub, select your existing project, and change the Editor Version to the latest version (6000.X).
3. Confirm Version Change: A warning will appear regarding the version change. Select Change Version to proceed.

---

Step 2: Open and Update Your Project

1. Open the Project: Unity will open your project with Unity 6.

2. Accept Compatibility Warnings:

   • Continue Warning: Accept the next warning by selecting Continue.

   

   • Old API Warning: You may receive a message about scripts using an older API. Confirm this and proceed. These scripts will be updated when you import realvirtual.io 6.

3. Project Appearance: Your project will open in Unity 6 and may initially appear different due to rendering pipeline changes.

---

Step 3: Update Materials to URP

1. Pink Materials Issue: Materials in your scene might appear pink. This happens if your previous project used the Standard Rendering Pipeline.
2. Convert Materials to URP: Go to Tools > realvirtual > RenderPipelines > Switch to Universal Render Pipeline (URP). This action will convert all materials in your project to be compatible with URP.

Caution

Important: Update materials to URP before importing the realvirtual.io 6 package to ensure proper rendering and avoid material conflicts.

---

Step 4: Import realvirtual.io 6 Package

1. Import Custom Package: Go to Assets > Import Custom Package and select the latest realvirtual.io 6 package.
2. Expect Compilation Errors: After import, you will likely see compilation errors in the Unity console. This is normal during the upgrade process.
3. Close Unity: Close the Unity Editor completely.
4. Clean Project Cache:
   • Delete the Library folder in your project directory
   • Delete the Assets/realvirtual folder (the old version)
5. Reopen Project: Open your project again in Unity 6. This will regenerate the Library folder with updated settings.
6. Import Package Again: Import the realvirtual.io 6 package once more via Assets > Import Custom Package.
7. Verify Import: After the second import, compilation errors should be resolved, and the new realvirtual.io 6 framework will be properly integrated.

Note

Why delete Library and realvirtual folders?

• Library folder: Ensures all cached metadata and assembly definitions are regenerated for Unity 6 compatibility
• realvirtual folder: Removes old scripts that remain after the first import, preventing conflicts between old and new framework versions

Don’t worry - all references in your scenes and prefabs will be preserved during this process. Unity automatically maintains these references through GUIDs, even when folders are deleted and reimported.

---

After following these steps, your project should be fully upgraded to realvirtual.io 6 with URP compatibility, restoring the correct material and scene appearance.