调和器补丁扫描器 (Harmony Patch Scanner)

2.0.0 支援游戏本体 1.4.X 版本
前置需求 - 四前置：https://bbs.mountblade.com.cn/download_45.html

═════════════════════════════════════════════════════════
　　　　　　　　　　　　　　　● 作者讯息
══════════════════════════════════ ▼

模组作者：TadasTheLithuanian
模组原址：https://www.nexusmods.com/mountandblade2bannerlord/mods/9179
更多我的汉化作品：https://next.nexusmods.com/profile/Cartoonist57/mods

───── ▼ 支持汉化作者 笔者57（Cartoonist57）

汉化作者的Patreon（支持说明）：https://www.patreon.com/posts/bi ... m_content=join_link

大家好，我是汉化作者 笔者57（Cartoonist57）！
长期以来，我专注于《骑马与砍杀2》的模组翻译与内容整理。除了发布翻译之外，我会为每一款模组撰写完整介绍文章，说明其特色、定位与适用环境，为了让这些工作能稳定持续，我决定开设赞助页面，作为支持创作的方式！
如果我的翻译与整理工作帮助到你，欢迎在能力范围内支持我的工作！请我喝杯香浓的咖啡！
（目前我无法使用爱发电，只能先用海外赞助平台，造成不便请见谅！）

═════════════════════════════════════════════════════════
　　　　　　　　　　　　　　　● 译者的话
══════════════════════════════════ ▼

　　这款模组暂不支持本地化翻译，这主要是提供模组开发者或想研究模组相容性的玩家使用。

═════════════════════════════════════════════════════════
　　　　　　　　　　　　　　　● 模组介绍
══════════════════════════════════ ▼

　　《调和器补丁扫描器 Harmony Patch Scanner》── 找出每一个 Harmony 补丁，告诉你哪些模组动到了同一个方法、执行顺序如何、谁干扰了谁。专为模组作者打造。

　　这是一款便利工具：它会检视每个已载入的模组、找出所有 Harmony 补丁，并用白话告诉你 —— 哪些模组动到同样的游戏方法、它们的补丁实际的执行顺序为何，以及谁干扰了谁。目的是让你在不必亲手读 IL 的情况下，替你的模组清单或自己的模组除错。

　　★ 可随时加入或移除，不会将任何资料写入存档；本身不会对任何游戏程式码打补丁

───── ▼ 适合哪些人
　　◆ 想知道自己的补丁与什么东西冲突、为什么冲突的模组作者
　　◆ 载入顺序很庞大、正在找出是哪个模组搞坏东西的玩家
　　◆ 任何好奇「游戏呼叫某个方法时，Harmony 到底做了什么」的人

───── ▼ 功能特色
　　◆ 列出每个模组的每个 Harmony 补丁：Prefix、Postfix、Transpiler、Finalizer，以及 Harmony 2.4 新增的 Infix
　　◆ 显示每个方法上补丁的确切执行顺序，资料直接取自 Harmony 本身（优先度、索引、HarmonyBefore／HarmonyAfter）
　　◆ 说明每个补丁能做什么：跳过原方法、改变结果、改变参数、吞掉例外
　　◆ 读取每个回传 bool 的 Prefix，并标示为恒为 true、恒为 false 或执行时才决定
　　◆ 显示当某个 Prefix 回传 false 时，哪些 Prefix 与 Transpiler 会被压制
　　◆ 当数个模组改动同一个结果或参数时，指出「最后写入者」
　　◆ 检查 HarmonyBefore／HarmonyAfter 的提示，并说明 Harmony 是否真的会采用
　　◆ 选用的「深度 Transpiler 分析」：显示每个 Transpiler 实际改动了什么，并抓出什么都没改或会抛出例外的 Transpiler
　　◆ 模组扫描器：从下拉选单选一个模组，就能得到它的一切资讯，包括它自己补丁中的问题
　　◆ 每个问题都有严重程度（HIGH／MEDIUM／LOW）与一句话说明，最严重的排在最前面
　　◆ 每份报告最后都附有简短的名词解释，所以你不需要懂 Harmony 的内部运作也能读懂

───── ▼ 使用方式
　　◆ 照常载入模组
　　◆ 打开 MCM → Harmony Patch Scanner，点击三个按钮之一：
　　　　‧ Scan Now —— 扫描每个模组的每个补丁，依模组分组
　　　　‧ Find Conflicts —— 只列出被不止一个模组补丁的方法，附上执行顺序与说明。建议从这里开始
　　　　‧ Scan Module —— 扫描你在下拉选单中选定的那一个模组的一切。要检查自己的模组时用这个
　　◆ 报告会以 .txt 档存放在 Mount & Blade II Bannerlord\Modules\HarmonyPatchScanner\logs：
　　　　‧ AllHarmonyPatches.txt
　　　　‧ DuplicateHarmonyPatches.txt
　　　　‧ ModuleScan_<模组名称>.txt
　　◆ 扫描的时机很重要。有些模组只会在战役开始或战斗开始时才加入补丁。
　　◆ 请分别在主选单、已载入的战役中，以及战斗中各扫描一次 —— 各自会存进不同资料夹（logs\mainmenu、logs\campaign、logs\mission），让你保留并比较三份结果

───── ▼ 设定（MCM）
　　◆ Exclude Common Lifecycle Methods —— 隐藏 OnSubModuleLoad、OnGameStart 与类似挂钩上的补丁。预设启用
　　◆ Exclude Community Libraries —— 隐藏 Harmony、ButterLib、UIExtenderEx、MCM 与 BEW 的补丁，除非它们与你的模组共用同一个方法。预设启用
　　◆ Analyze Prefix Return Values —— 读取 Prefix 程式码，判断回传值是 true／false／有条件。唯读，预设启用
　　◆ Deep Transpiler Analysis —— 逐步重新套用 Transpiler，看它们改了什么。预设停用，因为这会再次执行模组的 Transpiler 程式码

───── ▼ 可以期待什么
　　◆ 一份看得懂的文字档，而不是一墙的类别名称：先是摘要，接着每个方法一个区块，列出补丁的顺序与发现的问题
　　◆ 诚实的答案。如果某件事无法从程式码得知（例如某个补丁是否真的写入了 ref 参数），报告会写「可能改变」，而不是「改变」
　　◆ 一个方法被两个模组补丁，并不自动等于冲突。LOW 表示它们可以并存；HIGH 表示肯定有东西被跳过、覆写或坏掉

───── ▼ 不要期待什么
　　◆ 它不会修复任何东西，也不会更动你的载入顺序。它只告诉你该往哪里看，以及该对模组作者说什么
　　◆ 它看不到模组在你扫描之后才套用的补丁。若某个模组似乎缺席，请从战役或战斗中再扫描一次
　　◆ 它看不到反向补丁（reverse patch）、纯反射的手法，或非 Harmony 的修改
　　◆ 它无法证明两个模组可以一起运作，只能证明它们的补丁在共用的方法上有没有互相干扰

═════════════════════════════════════════════════════════
　　　　　　　　　　　　　　　● 相容性
══════════════════════════════════ ▼

───── ▼ 需求与载入顺序
　　◆ Harmony 2.4.2 或更新版本：Harmony
　　◆ Mod Configuration Menu (MCM) v5

───── ▼ 相容性说明
　　◆ 可随时加入或移除，不会将任何资料写入存档
　　◆ 本身不会对任何游戏程式码打补丁

═════════════════════════════════════════════════════════
　　　　　　　　　　　　　　　● 模组更新记录
══════════════════════════════════ ▼

───── ▼ 2.0.0
【重要】
• 需要 Bannerlord.Harmony 2.4.2 或更新版本
【新增】
• 报告现在会显示 Harmony 执行每个补丁的确切顺序，资料直接取自 Harmony 本身
• 每个 bool prefix 都会标示为「恒为 true」、「恒为 false」或「执行期才决定」
• 可以看到当某个 prefix 回传 false 时，哪些 prefix 与 transpiler 会被跳过
• 会列出可能改变结果的补丁，并指出最终写入结果的是哪一个
• 会依执行顺序列出可能改变参数的补丁
• 会标示可能吞掉或取代例外的 Finalizer
• 前后顺序提示（before／after）现在会显示 Harmony 是否真的采用
• 新增可选的深度 transpiler 分析，显示每个 transpiler 实际改动了什么
• 没有改动任何东西或会掷出例外的 transpiler 会被回报为高风险
• 现在包含 Harmony 2.4 新增的内层 prefix 与内层 postfix 补丁
• 模组报告会用白话说明在你自己的补丁中找到的问题
• 模组报告也会列出你自己的方法被其他模组打补丁的情况
• 每份报告都会注明是在主选单、战役或任务中撷取的
• 每份报告结尾附有简短的名词解释，说明 Harmony 如何排序与跳过补丁
• 新增两个选项：prefix 回传值分析与深度 transpiler 分析
• 报告现在分别存放在主选单、战役、任务的独立资料夹
• 三种扫描结果可以同时保留并互相比较
【优化】
• 从战役或任务中进行扫描，可以看到模组稍后才套用的补丁
• 同名的多载方法不再被合并成同一个条目
• 生命周期筛选现在只会隐藏真正的 SubModule 挂钩
【修复】
• 修正 postfix 与 finalizer 显示的执行顺序有误
• 修正关于缺少前后（before／after）目标的误报警告

───── ▼ 1.2.1
【优化】
• 更新以支援游戏版本 1.4.5

───── ▼ 1.2.0
【新增】
• 新增 MCM 选项，可扫描单一模组

───── ▼ 1.1.0
【新增】
• 每个补丁现在会显示它在 Bannerlord 启动器中的确切位置
• 冲突报告现在会显示两个补丁冲突时哪个模组先执行
• 新增「Exclude Community Libraries」筛选（Harmony、ButterLib、UIExtenderEx、MCM）
• 当某个 prefix 可能悄悄跳过其他模组的补丁时会发出警告
• 日志档现在以完整的模组载入顺序清单开头
【优化】
• 无法确定的补丁顺序现在会明确标示，不再被悄悄忽略
【修复】
• 修正扫描器程式码中的数个当机与建置错误

───── ▼ 1.0.2
【其他】
• 更新以支援游戏版本 1.3.15。这不是必要的更新

───── ▼ 1.0.0
【其他】
• 首次发布

═════════════════════════════════════════════════════════
　　　　　　　　　　　　　　　● 文章更新纪录
══════════════════════════════════ ▼

- [2026/10/25] 发布

═════════════════════════════════════════════════════════
　　　　　　　　　　　　　　　● 安装说明
══════════════════════════════════ ▼

模组安装方式：
- 下载模组，解压缩并将模组放入游戏主目录的 Modules 资料夹内。
- 具体路径为：「...\Mount & Blade II Bannerlord\Modules」。
- 启动游戏启动器（建议用 Novus），勾选模组。启动游戏！

*总体评价	给总体评价评分
*点评	Smilies 登录