SDK URP Upgrade Guide

v2.15

Unity Upgrade

Upgrade your Unity Editor from version 2020.3.34f1 to 2022.3.11f1.

1. Backup your project files!

» Move your "old" SDK folder to another location, then download the new SDK.

» We don't recommend an in-place upgrade.

1. Update the SDK
2. Follow the flow charts below

Changelog

• Upgraded the SDK from "Built-In Render Pipeline" to "Universal Render Pipeline"
• Removed MicroSplat from the SDK, the free version only exists for the "Built-In Pipeline", for URP you need to purchase the asset.
• Removed "Holdfast" shaders, since all their functionality is now natively supported by URP.
• Added support for using assets from the modbundle as grass on terrain (Add script "HoldfastModTerrainGrassData" to your terrain).
• Removed requirement for "greyed out" sprite for uniforms, these are no longer used ingame.
• Added Austria to FactionCountry enum (this time for real).
• Added support for uploading to Beta workshop from the SDK.
• Added support for dedicated servers to download from the Beta workshop. From the command line (takes priority): -betaWorkshop. From the server config: use_beta_workshop [true/false].
• Added interfaces "IHoldfastGame" and "IHoldfastSharedMethods" for calling native game methods.

» Instead of injecting commands into the game console UI element, use "IHoldfastSharedMethods.ExecuteConsoleCommand(...)". This method returns if the console command executed successfully, the output and [optional] parsing exception for error handling.

» This new interface allows us to expose native game methods directly to modders, without having to rely on rc commands.

Uniform & Flag Mods

Mod Maps

Script Mods

Glossary

* Common Shaders list

For backwards compatibility, these are auto-converted on mod load to URP shaders. This doesn't work for every case, so we recommend rebuilding 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 Render Pipeline" (BP) 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

We switched from Unity 2020 to 2022, alongside which, Mono was updated. We also swapped from ".NET Framework" to ".NET Standard 2.1". This might have an impact on how your mod operates.

If the behaviour of your script mod has changed, isolate the issue in a small example mod and send the source-code to us. Note: We won't guarantee a patch and won't be looking into issues without a replication project.