ModDownloadFix

v1.0.1·Updated 2026-09-11

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

  1. Unzip the archive from playbuff and read the bundled readme / instructions first.
  2. 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.
  3. For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
  4. 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.

Dependencies

Install these first, or the mod will not work:

HoldfastModding-BepInExPack_Holdfast

File & checksum

Filename
ModDownloadFix-1.0.1.zip
File size
9.3 KiB
SHA-256
dba8a3a850bb9a8ecd0e25061066d41fd853699bc4febec3f191bf5a0ec05be8
Stored at
2026-10-10 06:03