Maintenance script at 02:32, 9 February 2026

2026-02-09T02:32:32Z

New page

<div class="hf-relpage">
{{Release_page_header|title=SDK Upgrade Guide}}
<div class="hf-relpage-body">
{{Release_TOC|content=
<div class="hf-toc-category">On this page</div>
<div>[[#v231|v2.31]]</div>
<div>[[#v227|v2.27]]</div>
<div>[[#v219|v2.19]]</div>
<div>[[#v215|v2.15]]</div>
<div>[[#glossary|Glossary]]</div>
}}
<div class="hf-relpage-content">

{{Release_section
|id=v231
|title=v2.31
|content=
'''Unity Upgrade'''

Upgrade your Unity Editor from version 2022.3.53f1 to 2022.3.62f1 (Latest and last LTS version of Unity 2022).
}}

{{Release_section
|id=v227
|title=v2.27
|content=
'''Unity Upgrade'''

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

'''Changelog'''
* Updated "Uniform System Window":
** [NaW factions only] Added "Allow Backpacks" checkbox. Tooltip: Allow players to equip base game backpacks (purchased using shillings) on this uniform.
* Updated "SteamWorkshop Upload Window":
** Added "Austrian" to the faction dropdown.
}}

{{Release_section
|id=v219
|title=v2.19
|content=
'''Changelog'''
* Fixed officer lines drawing over modded uniforms.
* Fixed models using URP-shaders (modded uniforms, custom props) not throwing shadows.
* Fixed missing shadows in SDK and artifacts on game assets trees.
* Fixed game assets browser filter logic being inverted.
* Added "Deprecated" filter (default: off) to game assets browser.
* Added Empire props to game assets.
* Updated some miscellaneous props in the game assets.
* Updated "Uniform System Window":
** Added generic first person model support (See new settings: "Default First Person Model", "Default First Person Cuff Color", "Default First Person Sleeve Color").
** Removed "PersonalFaction" enum, the UI that required this has been removed.
** Renamed "Uniform Data" to "Uniform Random Variants"
** Removed "Uniform Sprite" from "Uniform Random Variants", they weren't being used.
** Renamed "Class Sprite" to "Uniform Sprite".
** Renamed "Class Greyed Out Sprite" to "Head Sprite".
** "Voice Language" is now disabled if "Faction" is not a Frontlines faction.
** "Head Sprite" is now disabled if "Use Global Head System" is enabled.
** "Special Carryable Object" is now disabled if "Player Class" is incompatible.
** Clarified tooltips to match the new in-game UI.
* Updated "Flag System Window":
** Added warning to enable "Read/Write" and disable "Mesh Compression" on the flag model's import settings.

'''Uniform Mods'''

It's no longer necessary to create a first person model per modded uniform. You can now pick from 5 generic first person models (3 Nations At War & 2 Frontlines) and a variety of colour variants. This is an ''optional'' change — if your modded uniform includes a custom first-person model, that model will be used instead.

The new first person models allow us to dedicate more texture space and mesh detail to the pieces of the character that the first person camera actually sees. In addition, it uses less memory as we can now recycle the same model for all the uniforms. We '''recommend''' that modded uniforms make use of the new system.
}}

{{Release_section
|id=v215
|title=v2.15
|content=
'''Unity Upgrade'''

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

# '''Backup your project files!''' '''Move your "old" SDK folder to another location!''' '''We don't recommend an in-place upgrade.'''
# Update the SDK
# Move your mods back to the new SDK
# Follow the flow charts below

'''Changelog'''
* Upgraded the SDK from "Built-In Render Pipeline" to "Universal Render Pipeline"
* Removed MicroSplat from the SDK (free version only exists for Built-In Pipeline; for URP you need to purchase the asset)
* Removed "Holdfast" shaders — 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 (no longer used in-game)
* Added Austria to FactionCountry enum
* Added support for uploading to Beta workshop from the SDK
* Added support for dedicated servers to download from the Beta workshop (Command line: <code>-betaWorkshop</code>; Server config: <code>use_beta_workshop [true/false]</code>)
* Added interfaces "IHoldfastGame" and "IHoldfastSharedMethods" for calling native game methods:
** Instead of injecting commands into the game console UI element, use <code>IHoldfastSharedMethods.ExecuteConsoleCommand(...)</code>. This method returns whether the console command executed successfully, the output, and an 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'''

[[File:UpgradeUniformsAndFlags.png|frameless|600x600px]]

'''Mod Maps'''

[[File:UpgradeMaps.png|frameless|600x600px]]

'''Script Mods'''

[[File:WorkflowScriptMods.png|frameless|600x600px]]
}}

{{Release_section
|id=glossary
|title=Glossary
|content=
'''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), which means old materials and shaders will no longer work. If your materials no longer render or they are pink, this indicates 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 (e.g. "Holdfast/Standard - Stencil 15"), first convert them to "Standard" then use the Unity upgrade tool.

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 impact 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 look into issues without a replication project.
}}

</div>
</div>
</div>

SDK upgrade guide - Revision history

Maintenance script at 02:32, 9 February 2026