ModDownloadFix
Fixes the soft crash when the Workshop popup auto-joins a server after downloading or updating a mod.
About this mod Author’s original text
ModDownloadFix
A BepInEx client mod for Holdfast: Nations At War that fixes a soft crash
after downloading or updating a server's Workshop mods.
The bug
When you join a server running a Workshop mod you don't have, or one that needs an update, the game opens a download
popup. If the download finishes while you are still connected, the popup joins the server for you after a short
countdown. The map loads, but the round never finishes setting up and the spawn menu never opens.
The game throws away the server's join details, including the map rotation, before that auto-join uses them. The
scoreboard then looks up the current map in an empty list, and setting up the round stops partway through.
ModDownloadFix keeps those details until the join has used them. It also adds bounds checks to the two map rotation
lookups, so a short list can't stop a round from loading.
Install
Install through r2modman or Mod Manager. It is client side, has no settings,
and nobody else on the server needs it.
To install by hand, install
BepInExPack_Holdfast
first, then put ModDownloadFix.dll from the latest release
in BepInEx\plugins\ModDownloadFix\.
Did it work?
BepInEx\LogOutput.log shows this on launch:
[Info:ModDownloadFix] Ready.
When the download popup joins for you, it also shows:
[Info:ModDownloadFix] Kept the handshake packet for the Workshop auto-join.
[Info:ModDownloadFix] Released the handshake packet after loading.
A normal join adds nothing else. A warning from ModDownloadFix means a bounds check caught something the main fix
didn't, which is worth reporting with BepInEx\LogOutput.log and the game's Player.log attached.
Building
Needs the game, BepInEx in an r2modman profile, and a.NET SDK.
build.ps1 compiles the mod and copies it into the Dev profile. package.ps1 produces a zip in
Package\.
Licence
MIT.
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: