Harmony已更新

Harmony已更新

Harmony 2.4.3 运行时补丁库,适用于《骑马与砍杀2:霸主》v1.5.6 beta 和 v1.4.8。大多数代码模组都需要它。BUTR 模块(MIT)的非官方重建版本。

[size=5][b]Harmony 更新 — 适用于 Bannerlord v1.5.6 beta 与 v1.4.8 的 Harmony 2.4.3[/b][/size]
大多数代码模组所依赖的 [b]Harmony[/b] 运行时补丁库,已使用最新的 [b]Harmony 2.4.3[/b](2026 年 10 月)重新构建,并针对 Bannerlord [b]v1.5.6(beta)[/b]编译。

[b]由 BUTR 原作的非官方重构建——全部功劳归他们。[/b]此版本与原版[b]二选一[/b],切勿同时安装:它们共用模块 id [i]Bannerlord.Harmony[/i]。[url=https://www.nexusmods.com/mountandblade2bannerlord/mods/2006]原版 Harmony(BUTR)[/url]

[size=4][b]兼容性[/b][/size]
[list]
[][b]v1.5.6 beta[/b] — 针对其编译并在游戏内测试,单独测试以及配合 ButterLib + UIExtenderEx 测试。[/]
[][b]v1.3.4 – v1.4.8 稳定版[/b] — 支持:本模块调用的每个游戏 API 均已验证存在于这些版本中。[/]
[][b]v1.0.0 – v1.2.12[/b] — 不支持,请使用 [url=https://www.nexusmods.com/mountandblade2bannerlord/mods/2006?tab=files]BUTR 的 Harmony 页面[/url]上的 [i]v1.0.0–v1.2.12[/i] 可选文件。[/]
[][b]War Sails DLC[/b] — 无需处理,它始终在 Harmony 之后加载。[/]
[/list][size=4][b]安装[/b][/size]
[list]
[]使用 Vortex 安装,或将压缩包中的 [b]Modules[/b] 文件夹解压到你的 Bannerlord 游戏文件夹中。[/]
[]将 [b]Harmony 置于加载顺序的最高位[/b]。其他想要“置顶”的模组(ButterLib、UIExtenderEx、MCM、Better Exception Window)应放在其下方。[/]
[]Steam 玩家可以改用 [url=https://steamcommunity.com/sharedfiles/filedetails/?id=3740878109]创意工坊版本[/url]——不要同时安装两者。[/]
[/list][size=4][b]面向玩家[/b][/size]
所有模组共用一个最新的 Harmony([b]2.4.3.0[/b]),最大限度减少冲突。无需任何配置。

[b]启动器警告“ButterLib depends on Bannerlord.Harmony(v2.2.2.0), current version is …”?[/b]
这是预期内的且无害。原版启动器会对任何并非模组所列出确切版本的 Harmony 发出警告——原版 Harmony 也会触发它。点击 [i]Confirm[/i] 即可。BLSE 不会显示它。

[size=4][b]面向模组作者[/b][/size]
[list]
[]调试 UI:[b]CTRL+ALT+H[/b] — 按模块分组查看所有活动补丁。[/]
[]通过 NuGet 引用 [i]Lib.Harmony[/i];不要在你自己的模块中附带 0Harmony.dll。[/]
[]在你的 SubModule.xml 中声明依赖:
[code]<DependedModule Id="Bannerlord.Harmony" />[/code][/
]
[/list][size=4][b]版本命名[/b][/size]
Harmony 版本 + 构建 id — [b]2.4.3.249[/b] = Harmony 2.4.3,构建 249。

[size=4][b]故障排除[/b][/size]
[list]
[]启动时崩溃?确保只安装了[b]一个[/b] Harmony(本版本或原版,Nexus 或创意工坊),并且 [i]…\bin\Win64_Shipping_Client[/i] 中没有残留的 0Harmony.dll / Mono.Cecil.dll / MonoMod*.dll。[/]
[/list][size=4][b]致谢与源码[/b][/size]
[list]
[
][url=https://github.com/pardeike/Harmony]pardeike[/url] — Harmony 的创建者(MIT)。[/]
[
][url=https://github.com/BUTR/Bannerlord.Harmony]BUTR[/url] — 原版 Bannerlord 模块(MIT)。使用 MonoMod 构建。[/]
[
][url=https://github.com/boujuan/Bannerlord.Harmony]本重构建的源码[/url](MIT)。[/*]
[/list]