Upgrading to 1.0 - SkaterXLModding/skater-xl-mapping-wiki GitHub Wiki
Table of Contents
Welcome
This guide covers the basic steps required to upgrade a SkaterXL map from V3 to be functioning in the release 1.0 build. This guide does not cover any in depth steps that are different in the new version of unity we are now using, please refer to the other wiki pages or external sources that cover these topics. Check the related pages at the end for more info.
Getting Started
Our first step in taking an existing project over to 1.0 is going to be upgrading to the correct version of Unity. SkaterXL currently uses Unity 2019.3.15f1
Go to the Unity Download Archive and download 2019.3.15f1.
If you are not already using Unity Hub, now is a good time to start, as it makes upgrading projects far simpler. You can get that here.
Once you have installed the new version of Unity, open your Unity Hub. Select your projects Unity version
In the dropdown menu, select Unity 2019.3.15f1
Click the project now to open it as your normally would, this will lead to a prompt asking if you are sure you want to upgrade the project. Click Confirm
After a bit you will receive another prompt, select Yes
This will take some time, let unity run through its process. After a little while you'll be greeted by the new Unity 2019 HDRP Wizard. If you accidentally close this wizard it can be reopened through Window > Render Pipeline > HD Render Pipeline Wizard (at the bottom of the window drop down).
Fixing Project
At this point the map is still a ways out from being fully fixed in game, we need to make some more adjustments to fix the lighting in game. You may notice on loading in to Unity 2019.3.15f1 that your map is invisible. We can use the HDRP Wizard to quickly fix a lot of the HDRP assets in our project for the new version.
Firstly, Populate/Reset the default resources folder
We can also run through and fix some other things quickly with the wizard. Click the Fix buttons until it's all green checkmarks.
| Before | After |
|---|---|
 |
 |
Our map should no longer be invisible in the editor.
Fixing Lighting
The final and most important step we'll be covering is going to be fixing the lighting in our project. If you were to compile and load your map now, you'd have a grey stone looking map. This is due to the realtime GI we used in 2018 no longer being supported in 2019. A quick before continuing:
If you have not set up any lighting for your map at this point, you should. I cannot comment on the success of this process if you have zero lighting properly set up on your map. Please refer to the wiki guide on [lighting] if you are new to this topic.
One thing that needs an initial manual fix is the Scene Settings Volume. Some of the features we used in 2018 are no longer supported, some stuff has been moved, etc.
Select your game object you are using for Scene Settings
Remove the missing script references and the static light baking script
Next we need to add an Exposure override to our volume
This step will hopefully not be fully necessary for long, Kiwi is currently working on a fix for the map importer, but as of 7/21/20 this step is 100% required
This is a good time to read the editor log and fix any other errors that the Scene Settings object is causing. For instance, Procedural Sky is no longer fully supported, and it is recommended you replace it with a new component override. You can read up on more information on Volumes in 2019 here.
Now locate your Scene Settings Profile asset by clicking it in the inspector, which will highlight it in your project window.
Open your lighting tab and drag your Scene Settings Profile to the Profile slot at the top
If you do not have a lighting tab you can open it by navigating to
Window > Rendering > Lighting Settings
After adding the profile you will be able to set the Static Lighting Sky to the type of sky you would like to use for static light baking on your project.
Now at the bottom of your lighting settings window you can click Generate Lighting. If your lighting is properly set up from your Unity 2018 project, then your map should be fully ready to be played in Skater XL 1.0
FAQ
All my meshes are invisible in the editor?
Check the first step in Fixing Project
Why is my map all grey?
Try turning up the intensity of your lights
My map loads to 100% and then hangs on black screen
Add the Exposure component to your Scene Settings Volume
None of my decals are working
Fix currently unknown
Related Wiki Pages
[Fixing Decals in 1.0]
External Information Sources
Learning the Unity High Definition RP