Upgrade Guide

v1.4.x to v1.5.x

  1. Make backup before importing the package.

  2. Import the package.

  3. After that, migration will started. This process can take up to 10 minutes.

  4. Fix any code error if it occurs.

  5. After the project has finished importing, if any asset or prefab references are lost, close Unity and clean up the Library folder. [optional]

v1.1.x & 1.2.x to v1.4.x

  1. Make backup before importing the package.

  2. Import following file:

    _images/upgrade_v1.4.0.png

v1.0.x to v1.1.0

  1. Make backup before importing the package.

  2. Delete the following folders:

    • DotsCity/Scripts/

    • Plugins/Spirit604/

  3. Import the package.

  4. Open Package initialization window.

    _images/Layers_v_1_1_0_1.png

  5. Select Layer settings tab.

  6. Untick Import all project layers option.

  7. Press Import Collision Matrix & Apply buttons.

    _images/Layers_v_1_1_0_2.png

  8. Remove old Naughty attributes package (if installed).

  9. Restart the Unity.

  10. If the scene has lost the references, close the Unity & delete this file:

    • [ProjectFolder]/Library/ArtifactDB

  11. The new project is ready.

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