Troubleshooting

First, open fh2-mods\platform.log, or press ~ in the game for the console. Almost every problem is explained there.

The title screen says .NET is missing

Hosted mods and scripts need the .NET 10 runtime (x64). Install it and restart the game. NativeAOT mods and C++ mods keep working without it.

Platform.NET looks for the runtime in this order:

1. fh2-mods\dotnet\runtime\ (a private copy)
2. DOTNET_ROOT
3. the registry
4. C:\Program Files\dotnet

A mod is listed but does nothing, and the log says the game's code is different

The FH2 classes check the game's code before they touch it. On any build other than the 24 November 2015 one, they switch themselves off and platform.log names the feature. The rest of the mod, and the platform, keep working.

Another mod hooking the same function is fine: the check allows for that.

A script doesn't start

Compile errors go to platform.log and the console, with the file, line and column:

RepairButton.vb(12,9): error BC30451: 'Playr' is not declared.

Fix it and restart the game, or save it again with auto-reload on. The other mods carry on either way.

A mod loads twice

The same mod is installed both hosted (fh2-mods-dotnet\<Name>\) and NativeAOT (fh2-mods\<Name>.dll). Remove one of them.

A script and a folder mod with the same name don't load twice: the folder wins.

The game crashed

The platform writes a crash dump and names the DLL the crash came from. A crash inside a hosted mod's own code shows no mod name, because that code isn't in a DLL. To find the cause:

1. Note what you were doing.
2. Turn hosted mods off one at a time (rename the folder to <Name>.disabled) until it stops.
3. Open an issue with platform.log, the mods you had installed and what you were doing.

A mod's settings aren't on the MODS tab

The MODS tab lists one entry per DLL, so every hosted mod sits under Platform.NET. A hosted mod's settings are on Pause > Settings > Mods, or on a tile of their own if the mod has one.

Also see Known issues.