With a new project migrated to 2018 LTS, we need to make some adjustments to accommodate some of 2018 LTS's new features. In this tutorial, we'll walk through these steps in our project, Hover Racer, to demonstrate what you should do in your own projects.
Recommended Unity Versions
2018.4 and Above
Checking Hover Racer After Migration to 2018 LTS
Reconfigure Post Processing
For Cinemachine cameras with the Post Processing layer, the Stop NaN Propagation feature helps fix errors that may appear with some Post Processing effects. In 2018 LTS, this situation is handled differently, so this correction might no longer be needed in some projects -- which happens to be the case in Hover Racer.
To view the main Hover Racer scene, in the Project window folders, navigate to Assets > UnityEDU > Scenes and select the Main_Complete scene.
Double-click the scene, or click Open in the Inspector window.
In the Hierarchy window, select the Main Camera. You might see all black, or some unusual shapes.
In the Inspector, look for the Post Process Layer (Script) section. Uncheck the box labeled Stop NaN Propagation. The scene changes to a rocky landscape (Figure 01).
In your own project, if you use Cinemachine cameras with the Post Processing Layer, and your scene has black regions when you first migrate it, go in and uncheck this box.
Remove Global Post Processing Motion Blur
In the Lightweight Render Pipeline (LWRP), Motion Blur is not supported in Post Processing Profiles. If it is enabled, the scene will be black in Game mode.
To remove Motion Blur in LWRP:
In the Project window, navigate to the Assets > UnityEDU > VFX > Post Processing Profiles folder.
Select Global Reference.
In the Inspector window, uncheck Motion Blur.
Rebuild Shader Graph Shaders
In 2018 LTS, the file structure for Shader Graph Shaders has changed, and any Shaders in use will need to be rebuilt and saved. Until they are rebuilt, objects that use them will be black (Figure 02).
To rebuild Shader Graph Shaders:
In the Project window, navigate to Assets > UnityEDU > Graphs.
For each item in the Graphs folder:
Double-click to open the Shader Graph window.
Click Save Asset.
When saving is finished, close the Shader Graph window.
In your own projects, if you use Shader Graph, perform these steps to save your Shaders in the new format.