As you might be aware, Lib.Harmony does not support netstandard2.0, the target framework that can be used to build mods that support both Steam/GOG/Epic versions of the game(net472) and Xbox (netcoreapp3.1). We created Bannerlord.Lib.Harmony, a NuGet package that adds the ability to use netstandard2.0.
We suggest modders to switch to out package for modding, as we might divert a bit from the original Harmony mod for better backward compatibility and overall healthier library. If you're long in the Bannerlord modding community, you know our reputation with library maintenance, so we hope that you will support us in this decision! We will return to the original Lib.Harmony after the official v2.3.0 release, since we managed to merge all our changes from Bannerlord.Lib.Harmony to Lib.Harmony!
v2.3.0 Beta Update!
We released Harmony v2.3.0 beta. It's based on the rewrite of the MonoMod backend that Harmony uses. Mods that use Harmony v2.2.2 will work as expected. The new version is fully backwards compatible. The reason we release ahead of the Official Harmony library is the better .NET Core compatibility. We can disable some JIT Optimization removals that we added for Xbox to make Harmony 2.2.2 with the old MonoMod backend work. Steam/GOG/Epic users should also expect the new version to handle way better method inlining, thus fixing some cases where patches were not able to patch methods that were inlined!
We changed the archive format from .zip to .7z, now when extracting you won't have the .dll unlock problem! To extract the archive, download 7-zip. DO NOT USE ANYTHING FROM THE WINDOWS APP STORE.
You are probably having issues with the wrong 0Harmony.dll version being loaded in the game. I've dealt with lots of user reports lately and in most cases people solved their problems by doing the following:
First, make sure NOT to use Vortex launcher or Fixed Launcher. Vortex is fine for mods installing, but often has problems when used as a game launcher, so it's better use other tools for mod ordering and launching the game. As for the Fixed Launcher, it still has problems with Harmony because it adds an older version of 0Harmony.dll to the core game files (see below).
Second, if the problem persists, you should check for the 0Harmony.dll file in the ..\Mount & Blade II Bannerlord\bin\Win64_Shipping_Client\ folder. This folder is for the core game files, it should not contain 0Harmony.dll. If you have one there, delete it.
Note that you should NOT ever delete 0Harmony.dll files from mod folders, especially from the Harmony mod folder!..\Mount & Blade II Bannerlord\Modules\Bannerlord.Harmony\bin\Win64_Shipping_Client This is Harmony mod folder and it must have the latest version of the 0Harmony.dll file, provided with the mod.
If you have deleted 0Harmony.dll file from the core game files folder..\Mount & Blade II Bannerlord\bin\Win64_Shipping_Client\ and after that your game crashes on start even without any mods, you should reinstall the game. Such a situation clearly indicates that you have some excess or modified files in the game folder. Probably some launcher or mod you have used or using now was installed in the game folder, not in Modules folder. Generally speaking, no mod should ever do that. It may work by itself that way, but will cause incompatibilities and unexpected behaviours for everything else.
If you'll go for the clean game re-install, don't forget to check game folder after uninstalling the game. There could be leftover files and folders there, usually exactly the problematic type you'd like to get rid of. So if after uninstalling you still see game folder..\Mount & Blade II Bannerlord\you should first delete it and then proceed with the reinstall.
The CAUTION screen that you get when you launch the game with mods should be ignored! It gives misleading info!
The game developers assume that we target specific dependency versions in our mods (like, we require Harmony 2.0.2 SPECIFICALLY), but in reality, the standard practice is to declare the minimum supported dependency version for a mod (like, we require Harmony 2.0.2 or NEWER). Because the game developers do not follow this practice, you get this CAUTION screen that gives you misleading information. Do not follow it's recommendation and do not downgrade dependency versions!
We released BLSE - which is a tool for Bannerlord mods that expands modding capabilities and adds additional functionality to the game. It will automatically sort correctly mods that support our DependedModuleMetadatas xml tag that UIExtenderEx, ButterLib and MCM uses!
can someone explain , what is this thing? , (i am not a moder, or smth im just surfing for modes and instaling the ones i need, so my question what is this and , how can it benefit me?)
A lot of mods use a tool named "Harmony" to change something in the game code. This tool is an open-sourced library that is regularly updated, so there may be a lot of versions of the tool in your mod list, some of which would be up to date and some not. Thing is, Bannerlord forces every mod to use only one version of each tool - the one that was loaded first. So if at the top your mod list would be a mod that uses outdated version of Harmony, every other mod would be forced to use this outdated version which is obviously very bad and may lead to unexpected errors that would depend exclusively on player's mod order.
To address said issue, this mod was created. It automatically updates with every Harmony release and should be above any other mod that is using Harmony - thus it would be guaranteed that every mod in your assembly do use latest version of Harmony.
Hello, I am probably just to dumb for getting thins mod to work. I am trying to install Realm of Thrones and followed the instructions. But I always get an error from Harmony. Can you guys help me find my mistake?
The Error Message is as follows: Cannot load: ...Modules\Bannerlord.Harmony\bin\Win64_Shipping_Client\0Harmony.dll
The game version is 1.2.6.30619 Harmony Version: v2.3.3.204 ROT version: 1.2.9.2
If I disable all mods the core game works just fine.
When I try to use the mod, the game crashes. It should be noted that I only activated the Harmony mod and disabled the other mods. Currently, I can only use garrison improved mod
Hakan Demir, soruyu yanlış sormuşsun gibi geldi ama ben olması gereken cevabı vereyim, modun son versiyonu (2.3.3.204) oyunun son versiyonu ile (v1.2.9) uyumludur.
Cevap verdiğin için teşekkür ederim kardeşim.Ben harmonyi indirdim ve tabiki diğer 3 modu da (Butterlib,UIExtenderEx ve Mod Configuration Menu) Oyuna girerken oyundan attı beni bende harmony ve diğer modların uyumsuzluğundan dolayı olduğunu düşündüm.Sen son sürümde bu 3 modu kurup ardından diğer modları çalıştırabildin mi ?
Bannerlord.BLSE.Launcher freezes on loading screen. Horserider animation stopped after a few seconds. Doesn't even crash after minutes. Loads vanilla normally but can no longer run Harmony on 1.2.9. Help?
this is odd!! after butterlib and harmony updated, I just cannt play my last savegame anymore. It keeps saying the issue was caused by the sandbox module.
Give Feedback
2316 comments
Bannerlord.Lib.Harmony Announcement for Modders!
As you might be aware, Lib.Harmony does not support netstandard2.0, the target framework that can be used to build mods that support both Steam/GOG/Epic versions of the game(net472) and Xbox (netcoreapp3.1).
We will return to the original Lib.Harmony after the official v2.3.0 release, since we managed to merge all our changes from Bannerlord.Lib.Harmony to Lib.Harmony!We created Bannerlord.Lib.Harmony, a NuGet package that adds the ability to use netstandard2.0.
We suggest modders to switch to out package for modding, as we might divert a bit from the original Harmony mod for better backward compatibility and overall healthier library.
If you're long in the Bannerlord modding community, you know our reputation with library maintenance, so we hope that you will support us in this decision!
The reason we release ahead of the Official Harmony library is the better .NET Core compatibility. We can disable some JIT Optimization removals that we added for Xbox to make Harmony 2.2.2 with the old MonoMod backend work.
Steam/GOG/Epic users should also expect the new version to handle way better method inlining, thus fixing some cases where patches were not able to patch methods that were inlined!
To extract the archive, download 7-zip. DO NOT USE ANYTHING FROM THE WINDOWS APP STORE.
We also added an article on how to install and use 7-zip!
First, make sure NOT to use Vortex launcher or Fixed Launcher. Vortex is fine for mods installing, but often has problems when used as a game launcher, so it's better use other tools for mod ordering and launching the game. As for the Fixed Launcher, it still has problems with Harmony because it adds an older version of 0Harmony.dll to the core game files (see below).
Second, if the problem persists, you should check for the 0Harmony.dll file in the
..\Mount & Blade II Bannerlord\bin\Win64_Shipping_Client\
folder. This folder is for the core game files, it should not contain 0Harmony.dll. If you have one there, delete it.Note that you should NOT ever delete 0Harmony.dll files from mod folders, especially from the Harmony mod folder!
..\Mount & Blade II Bannerlord\Modules\Bannerlord.Harmony\bin\Win64_Shipping_Client
This is Harmony mod folder and it must have the latest version of the 0Harmony.dll file, provided with the mod.If you have deleted 0Harmony.dll file from the core game files folder
..\Mount & Blade II Bannerlord\bin\Win64_Shipping_Client\
and after that your game crashes on start even without any mods, you should reinstall the game. Such a situation clearly indicates that you have some excess or modified files in the game folder. Probably some launcher or mod you have used or using now was installed in the game folder, not in Modules folder. Generally speaking, no mod should ever do that. It may work by itself that way, but will cause incompatibilities and unexpected behaviours for everything else.If you'll go for the clean game re-install, don't forget to check game folder after uninstalling the game. There could be leftover files and folders there, usually exactly the problematic type you'd like to get rid of. So if after uninstalling you still see game folder
..\Mount & Blade II Bannerlord\you should first delete it and then proceed with the reinstall.The game developers assume that we target specific dependency versions in our mods (like, we require Harmony 2.0.2 SPECIFICALLY), but in reality, the standard practice is to declare the minimum supported dependency version for a mod (like, we require Harmony 2.0.2 or NEWER).
Because the game developers do not follow this practice, you get this CAUTION screen that gives you misleading information.
Do not follow it's recommendation and do not downgrade dependency versions!
It will automatically sort correctly mods that support our DependedModuleMetadatas xml tag that UIExtenderEx, ButterLib and MCM uses!
To address said issue, this mod was created. It automatically updates with every Harmony release and should be above any other mod that is using Harmony - thus it would be guaranteed that every mod in your assembly do use latest version of Harmony.
https://www.nexusmods.com/mountandblade2bannerlord/mods/1?tab=description
Go here and place the installed files in your main game/launcher exe folder. use the BLSE launcher instead of default exe.
I am probably just to dumb for getting thins mod to work.
I am trying to install Realm of Thrones and followed the instructions. But I always get an error from Harmony. Can you guys help me find my mistake?
The Error Message is as follows: Cannot load: ...Modules\Bannerlord.Harmony\bin\Win64_Shipping_Client\0Harmony.dll
The game version is 1.2.6.30619
Harmony Version: v2.3.3.204
ROT version: 1.2.9.2
If I disable all mods the core game works just fine.
I would appreciate any advice.
Game version: 1.2.9.36960
Mod version: 2.3.3.204
When I try to use the mod, the game crashes. It should be noted that I only activated the Harmony mod and disabled the other mods.
Currently, I can only use garrison improved mod