订阅以下载
Yet Another Mod Loader

This is a mod loader for C# mods. It requires additional installation, doesn't do anything on its own. If installed correctly, you'll see 'with YAML' in the version string in the lower left corner of the title screen.


This mod requires additional installation steps!

You need to go to the mod folder, which is located in the steam folder
You can switch to it directrly or from a Cosmoteer folder (right click -> Browse Local Files) by going two folders up, and then into the workshop folder. You can then copy the files manually, or launch an installer script.


Launch installer.bat or copy files ModLoader.dll and winmm.dll into the Cosmoteer Bin folder.


Launch installer.sh (usually you can right click -> Launch as executable), or copy the files Modloader.dll and unmanaged.dll into the Cosmoteer Bin folder, rename the Cosmoteer.dll in the Cosmoteer Bin folder to Cosmoteer_o.dll, and then copy Cosmoteer.dll from mod folder into the Cosmoteer Bin folder.

This installation method also works on windows, and can be used there. The two methods are functionally identical. The downside of the second method is that it replaces the game file, which steam will restore every time the game updates, or the game files are validated. The installation procedure needs to be repeated. The first method uses dll-hijacking, so if you are uncomfortable with that, you can use the second method.


Make sure that all the required mod files are in the Bin folder. Then, look in the log files, located in the user folder
on linux this folder can be found in If the mod has loaded correctly, an additional log file should be created with the name ending with "_modloader".

If the file was not created, that means the mod was not loaded, earlier logs are required. On windows, copy the winmm.dll from the mod folder from subfolder debug. It will create a log file in the Cosmoteer Bin folder. On linux change the launch options of the cosmoteer by setting it to
this will create a file called steam-799600.log in the home folder ~/. Look for the line "unhandled exception" there.

Look at the readme at github[github.com]. Open issue in case of questions.

As a user, you probably don't care. This mod has better logging, so you have better chances to find the problem if the mod doesn't work. If you use linux, you don't have much choice, as EML doesn't support linux.

As a mod developer, you might want this mod instead of EML because it allows for earlier assembly loads. If you want to reference your types in the .rules files, or patch the startup code, EML won't help you with that. With this mod you could even patch the GameApp constructor, as the libs are loaded before the game even starts. This mod doesn't require you to ship runtimeconfig json, which makes things easier. Also, it supports linux, so it's more universal.

• ModLoader.dll is the main file. It looks into the mod folders looking for dlls and loads them into the game context. It also looks for harmony lib, which is a library used by modders to modify the code in runtime. If harmony cannot be found the mods will not be loaded. In the end the library passes the control to Cosmoteer.dll
  
• 0Harmony.dll is the harmony lib. It is required for most of the mods to function. Games with official mod support usually ship it themselves.
  
• Cosmoteer.dll poses as a game's Cosmoteer.dll. Intercepts the game loading and passes control to ModLoader.dll. Manually loads Cosmoteer_o.dll into the game context.
  
• winmm.dll system library used for dll-hijacking. Intercepts the game loading and substitues ModLoader.dll instead of Cosmoteer.dll
  
• unmanaged.dll simple lib that only has one dummy method. Needed for EML compatibility. The same method is implemented in winmm.dll, so on windows it is not needed.

Well, you don't. But you are welcome to compile the libs yourself, if you want.

Code available on github[github.com], under LGPL-2.1 license. Based on Unity doorstop[github.com] and EML mod[github.com].