Troubleshooting Logs

There are two useful logs. One is the MelonLoader output (Latest.log) and the other is the Unity Engine output (player.log). Their locations are:

• Latest.log: ~\TheLongDark\MelonLoader
• Player.log: %USERPROFILE%\AppData\LocalLow\Hinterland\TheLongDark

The Latest.log is the most used for troubleshooting, so look in there first. Remember that errors are not the only thing you need to look for.

Known Log Reasons

This section contains descriptions of what a log line means.

Harmony Errors

HarmonyLib.HarmonyException: Patching exception in method null

This usually means the method you are attempting to patch doesn't exist or is an inline method.

MelonLoader Errors

During invoking native->managed trampoline

This means that an exception occurred but the output of the exception has been hidden. Please use Il2CppInterop.HarmonySupport.dll to show these exceptions.

System.NullReferenceException: Object reference not set to an instance of an object.

This means someone forgot to add a null check somewhere. These can cause severe issues so should be fixed as fast as possible.

Exception in IL2CPP-to-Managed trampoline, not passing it to il2cpp: System.MissingMethodException: Method not found:

This is similar to a Harmony exception, however it is caught earlier than what Harmony would normally catch it. This can have more causes however. This includes things like the parameters of the method not being matched in the patch definition. This can be caused directly by ML, like during 0.6.2, which broke (among other things) out parameters.

Method Void UpdatePainInstance(Int32, ImprovedAfflictions.Component.PainAffliction) on type ImprovedAfflictions.Pain.Component.AfflictionComponent has unsupported parameter ImprovedAfflictions.Component.PainAffliction pi of type ImprovedAfflictions.Component.PainAffliction

This means that the type of the parameter is not registered in the Il2Cpp namespace. This can be fixed by either registering the type or using the [HideFromIl2Cpp] decorator on the given method.

Missing Dependencies

All mods require all of their dependencies. You can not pick and choose. It is an all or nothing type of thing.

- 'BandageOverhaul' is missing the following dependencies:
    - 'UnhollowerBaseLib' v0.4.16.2

Mod Specific Errors

AutoUpdatingPlugin

• There is no associated API entry for

This is not an error. This just means that the mod does not exist in the API.

AmbientLights

• ERROR: Config isn't ready or not present

This just means the mod cant find any config for the given scene. This is not an error that can cause actual issues (like CTD).

ModComponent

• Overwriting data for

This means you have multiple .modcomponent archives from the same mod. You should only have one.

Known Workarounds

None at this time.