Difference between revisions of "SDK URP Upgrade Guide"
| Line 3: | Line 3: | ||
Unity version 2022.3.11f1 | Unity version 2022.3.11f1 | ||
| − | === * Common Shaders list | + | === * Common Shaders list === |
For backwards compatibility, these will be auto-converted on mod load to URP shaders. This can lead to flawed results, so we recommend that you rebuild your mod using URP shaders. | For backwards compatibility, these will be auto-converted on mod load to URP shaders. This can lead to flawed results, so we recommend that you rebuild your mod using URP shaders. | ||
| Line 24: | Line 24: | ||
* Legacy Shaders/Bumped Specular | * Legacy Shaders/Bumped Specular | ||
| − | === ** Converting materials to URP | + | === ** Converting materials to URP === |
We upgraded our SDK from the "Built-in Pipeline" to the "Universal Render Pipeline" (URP), this means the old materials & shaders will no longer work. | We upgraded our SDK from the "Built-in Pipeline" to the "Universal Render Pipeline" (URP), this means the old materials & shaders will no longer work. | ||
| Line 35: | Line 35: | ||
If you use 3rd party assets you'll need to obtain the URP version from the Unity store and then remap the materials manually. | If you use 3rd party assets you'll need to obtain the URP version from the Unity store and then remap the materials manually. | ||
| − | === *** Reporting script mod issues to AGS | + | === *** Reporting script mod issues to AGS === |
We switched from Unity 2020 to 2022, alongside this upgrade Mono was also update this might have introduced changes that have impacted the way your mod operates. | We switched from Unity 2020 to 2022, alongside this upgrade Mono was also update this might have introduced changes that have impacted the way your mod operates. | ||
If the behaviour of your script mod has changed, isolate the issue in a small minimal example mod and send the source-code to us. We won't be looking into issues without a replication project. | If the behaviour of your script mod has changed, isolate the issue in a small minimal example mod and send the source-code to us. We won't be looking into issues without a replication project. | ||
Revision as of 16:37, 11 November 2023
Upgrade guide for update v2.15.
Unity version 2022.3.11f1
* Common Shaders list
For backwards compatibility, these will be auto-converted on mod load to URP shaders. This can lead to flawed results, so we recommend that you rebuild your mod using URP shaders.
- Holdfast/Standard (Specular setup) - Stencil 15
- Holdfast/Standard - Stencil 15
- Holdfast/Standard (Specular setup) Double Sided - Stencil 15
- Holdfast/Standard Double Sided - Stencil 15
- Holdfast/Cloth-DoubleSided - Stencil 15
- Standard (Specular setup)
- Standard
- Mobile/Bumped Specular
- Mobile/Bumped Diffuse
- UBER - Specular Setup/ Core
- UBER - Metallic Setup/ Core
- UBER - Metallic Setup/2 Sided/ Core
- Cloth-DoubleSided
- Legacy Shaders/Diffuse
- Legacy Shaders/Bumped Diffuse
- Legacy Shaders/Specular
- Legacy Shaders/Bumped Specular
** Converting materials to URP
We upgraded our SDK from the "Built-in Pipeline" to the "Universal Render Pipeline" (URP), this means the old materials & shaders will no longer work.
If your materials no longer render or they are pink, this indicates that they are incompatible with URP.
Use Unity's upgrade tool (Edit>Rendering>Materials>Convert Selected Built-In Materials to URP) to automatically convert "built-in" materials to their URP counterparts, this only works for Unity standard shaders.
If you use the old Holdfast shaders, for example "Holdfast/Standard - Stencil 15", first convert them to "Standard" then use the Unity upgrade tool (Edit>Rendering>Materials>Convert Selected Built-In Materials to URP).
If you use 3rd party assets you'll need to obtain the URP version from the Unity store and then remap the materials manually.
*** Reporting script mod issues to AGS
We switched from Unity 2020 to 2022, alongside this upgrade Mono was also update this might have introduced changes that have impacted the way your mod operates.
If the behaviour of your script mod has changed, isolate the issue in a small minimal example mod and send the source-code to us. We won't be looking into issues without a replication project.