Upgrade Guide

Upgrading to Full Version (Quick Start)

The upgrade process is fully automated across several phases to handle code compilation and package extraction cleanly.

Instructions

  1. Create a Backup: Before upgrading, make a complete backup of your project files (or commit your current state via Git) to prevent any accidental data loss.

  2. Start the Upgrade: Locate the Project Unpacker asset in your project, select it, and click the Update To Full button in the Inspector.

  3. Wait for Domain Reload: Unity will clear the console, import core constants, and force a script compilation. The editor will briefly freeze—do not close Unity during this reload.

  4. Automatic Package Extraction: Once scripts are compiled, the system automatically triggers OnScriptsReloaded on the Main Thread. It will extract core packages, clone prefabs, and adapt your project settings (PhaseImportingPackages).

  5. Completion: When everything stabilizes, a final confirmation message will appear in your console: “The project is upgraded”.

Troubleshooting

If the process is interrupted midway (due to an unexpected crash, closing the editor, etc.), it will not break your project. Simply select the Project Unpacker asset again and re-click Update To Full to restart the automated pipeline from scratch.

HDRP

  1. Download HDRP template project.

  2. Remove URP packages in the Package Manager (if exist).

  3. Unpack HDRP package.

    _images/HDRP_pack.png

  4. Open quality settings from the Unity toolbar:

    Edit/Project settings/Quality

  5. Set the Render pipeline asset from the HDRP sample.

    _images/HDRP_quality.png

  6. Open assigned pipeline asset & disable Motion Vectors option.

    _images/HDRP_asset.png

  7. Set the Light settings for the desired scene (light settings can be taken from the HDRP sample).

    _images/HDRP_light.png

    Example.

  8. Set Environment settings for the desired scene.

    _images/HDRP_env.png

    Example.

Cinemachine v3 Upgrade

  1. Make sure you have downloaded Cinemachine v3 package.

  2. Unpack Main Camera City CM_v3 package.

    _images/cmv3_1.png

  3. Select UIInstaller.

    _images/cmv3_2.png

  4. Drag & drop Camera object into Main Camera Base field in UIInstaller.

    _images/cmv3_3.png

  5. Right click on this field & press Apply to Prefab Hub.

    _images/cmv3_4.png

Cinemachine v2

  1. Unpack Main Camera City CM_v2_legacy package.

    _images/cmv2_1.png

  2. Select UIInstaller.

    _images/cmv3_2.png

  3. Drag & drop Camera object into Main Camera Base field in UIInstaller.

    _images/cmv3_3.png

  4. Right click on this field & press Apply to Prefab Hub.

    _images/cmv3_4.png