This is only required if BepInEx is installed and running.
A BepInEx mod that fixes Quasimorph Steam Workshop mod load issues when BepInEx is installed and that mod has reference dlls in their folder.
Install the mod and the workaround will be executed.
By default, the mod will use the Quasimorph/mods folder if it exists. If not the Steam Workshop directory. If the user has a CustomModsPath set in the config, that will always be used.
The configuration file can be found at BepInEx\config\nbk_redspy.QM-BepInExCompatibility.cfg
The file will be created when the game is run once after the install.
The CustomWorkshopPath below is a hack for Steam installs where the game's libraries are installed in a different directory than the default install.
| Name | Default | Description |
|---|---|---|
| CustomModsPath | "" | If set, will be used as the folder to search for mods |
When BepInEx is installed, a component called Doorstop prevents Steam Workshop mods from loading any dlls that are in the mod's directory. This is because Doorstop excludes searching the mod's folder and instead only searches the game's and BepInEx's directories.
Normally .NET will automatically search for and load any required dlls in the Steam Workshop mod's folder.
This will cause file load exceptions when running the game.
This mod fixes the issue by loading every dll located in a Quasimorph Workshop mod folder.
When .NET tries to load a reference, the mod will use the dll that is already in memory instead of searching for a file to load.
Note that if a dll is loaded more than once, the subsequent loads will use the version in memory instead of loading the file again.
When creating Harmony based mods with BepInEx installed, the mod may work with BepInEx installed, but not without it. Workshop users will not have BepInEx installed.
For Harmony Workshop mods, it is recommended to use Harmony instead of HarmonyX. Harmony's nuget package is Lib.Harmony.
In that case, the 0Harmony.dll will need to be copied to the mod's folder.
If using HarmonyX instead, the following files will need to be copied.
0Harmony.dll
Mono.Cecil.dll
MonoMod.RuntimeDetour.dll
MonoMod.Utils.dll
The reason is BepInEx will load the modding dlls from the BepInEx directories. When BepInEx is not installed or enabled, the mod will not have the required dlls.
Test the mod without BepInEx running. BepInEx can be disabled by renaming the winhttp.dll in the game's directory.
A corner case would be if another Steam Workshop that has the required modding dlls is loaded before the user's mod was loaded.
It would be best to test the mod with no other subscribed mods.
For every mod, add all dlls in the directory to the "Assemblies" entry in the modmanifest.json.
Implement this mod's functionality by using Assembly.LoadFrom on all the dlls in the directory. However, every mod author would have to do this.
Add every Steam Workshop mod's path in the doorstop_config.ini search path.
dll_search_path_override =
Example:
dll_search_path_override = <Steam Dir>>\steamapps\workshop\content\2059170\3282459391;<Steam Dir>>\steamapps\workshop\content\2059170\1234567890
If you enjoy my mods and want to buy me a coffee, check out my Ko-Fi page. Thanks!
Improved speed of loading. From about 8 seconds to 2.5 seconds. Avoids loading dupes since the Assembly Load takes the longest amount of time.
- Support for non Steam versions.
- If no custom folder is defined, searches for the game's
modsfolder and then for the Steam Workshop folder.
Changed Custom path to indicate the root of a mods folder instead of expecting it to be a Steam Workshop layout.
Supports multiple Steam libraries using Steam's libraryfolders.vdf file.