There have been fundamental changes to the Gaia tools and the structure of the Gaia objects in a scene which require a few manual steps to migrate an existing 2.1.5 scene to Gaia 2.2.0.


Migrating the scene


To migrate a 2.1.5 scene to the newer version, please follow the following steps:

1. Open the scene in question. After the installation of the newer Gaia version you might notice inconsistencies like the lighting or water not being correct, or error messages in the console. Delete the "Gaia Global" Object from your scene.


2. Open the Gaia Manager, and select the Standard > Runtime tab. Review the options for runtime setup, and click create runtime. This will re-create the entire lighting and water setup for your scene with the new Gaia settings and features.


This will complete the migration process, and you should be able to continue to work with your scene in the new Gaia version.


Dealing with higher light intensity


Please Note: Gaia 2.2.0 uses a different lighting and post processing setup that relies on a higher directional light intensity which is then toned down in post processing. If you are not using Post Processing in the built-in pipeline, your scenes will appear overly bright:


If you do not want to use post processing, you can reduce the directional light intensity on the directional light in the scene to around 1.5:



When using the Procedural Sky System, you can likewise tune down the sun intensity curve to adjust the intensity over the time of day. The easiest way is to select all points of the curve with the mouse (click and drag for a selection box), then you can move all points downwards at once without destroying the curve shape:




Spawning the new Biome settings on an existing terrain


Gaia 2.2.0 comes with update Biome settings that you can apply on an existing terrain. To make sure your terrain is not using a mixture of both old and new terrain prototypes, it is recommended to remove all old prototypes from the terrain first, then spawn them in again from the new Biome. To do so, you can follow the following steps:

1. Open the resource helper tool from the Gaia Manager Advanced tab


2. Select the "Remove Resources" operation, check "Delete from all Terrains" (unless you only want to do one specific terrain only) and click the "Start Removal" button:


This will remove all resources from your terrain, game objects will still stay since those are not terrain resources but individual scene objects that you can delete directly from the scene hierarchy. You can decide to leave those as they are or to delete them as well.


3. From the Gaia Manager "Standard > Tools" tab, pick a biome and add it to the scene with the "Create Tools" button:


4. Select the newly created biome in the scene, review the spawners in the list (e.g. if you decided not to delete Game Objects before, you might uncheck the spawners for them here) and click "Spawn Biome". This will populate your terrain with the new biome settings.



Bringing back the old biome settings


If you miss / need the old biome settings back that were available in Gaia 2.1.5, you can install them from this legacy package.