重制版模组兼容性医生

重制版模组兼容性医生

在启动前,指出你已安装的模组中哪些是为旧版游戏构建的,以及在 Remastered 中会出什么问题。根据模组文件内部的格式版本,为每个模组给出“构建适用版本”判定,显示带文件名和行号的脚本编译错误、过时版本与更新版本之间的冲突、静默的 XML 错误,以及对下载内容的检查。只读。

[size=5][b]重制版模组兼容性诊断工具[/b][/size]
[b]在启动游戏之前,查明你的哪些模组是为旧版游戏构建的、在重制版中会出什么问题,以及原因。[/b]

重制版更新(5.0)更改了脚本编译器、字符串表格式和若干文件格式。许多为次世代版(4.x)或经典版(1.3x)制作的模组现在会让游戏以“脚本编译失败”停止运行、显示乱码文本,或悄悄撤销更新的一部分内容。其他工具只告诉你哪些模组[i]重叠[/i]。这个工具则告诉你哪些模组[i]已过时[/i],以及这会对你的游戏造成什么影响。

它会扫描你安装的所有模组(mods 和 dlc 文件夹、mod.io、Mod Organizer 2),[b]不做任何更改[/b],并在你的浏览器中打开一份报告。

[size=4][b]它会告诉你什么[/b][/size]
[list]
[][b]构建版本:重制版、旧版本或部分更新[/b],针对每一个模组。它读取模组所携带的每个文件中写入的格式版本(bundle 及其中的每个资源、纹理缓存、字符串表、语音、声音和碰撞缓存、metadata.store、REDkit 5 脚本 blob),并与你游戏自身的文件进行比较。[/]
[][b]脚本能编译吗?[/b] 它预测游戏的“脚本编译失败”错误,并指出模组、文件和行号:重制版已不再拥有的函数和类、模组定义的而重制版现在自己也定义的内容、将 [i]set[/i] 用作名称(现在是关键字)、@wrapMethod / @replaceMethod / @addMethod / @addField 的错误用法,以及会悄悄移除重制版代码的旧版游戏脚本副本。[/]
[][b]冲突,并将构建版本纳入考量:[/b]每个共享文件由哪个模组胜出,以及当[b]过时的副本压过为重制版重新构建的模组[/b]时给出警告。[/]
[][b]不显示错误的 XML 问题:[/b]模组携带的游戏 XML 文件副本缺少重制版新增的条目,以及游戏会忽略的来自 DLC 模组的重制版风格覆盖(用 onConflict 而不是 on_conflict、标记放在某个 section 上、条目缺少标记)。[/]
[][b]同一模组安装了两次[/b],例如旧构建与其重制版更新以另一个文件夹名并存。[/]
[][b]存档:[/b]你最新的重制版存档使用过、但现已消失的模组(游戏会无警告地丢弃它们的存档数据)。[/]
[][b]原生插件[/b](游戏 exe 旁的 .asi / .dll)在重制版之前构建的。[/]
[][b]安装错误:[/b]文件夹多套了一层、名称中没有“mod”、模组的 bin 文件夹留在了模组内、mods.settings 中的残留项。[/]
[][b]安装前检查下载内容:[/b]把 .zip、.7z 或 .rar 拖到 exe 上,报告就会针对你的游戏和已有模组回答“我应该安装这个吗?”。[/]
[][b]用于求助帖的文本:[/b]一个按钮即可复制报告的简短版本(不含你的 Windows 用户名),用于 Nexus、Reddit 或 Discord。[/]
[/list][size=4][b]已在游戏中验证[/b][/size]
脚本检查已与游戏自带的编译器进行对比(重制版 5.0.0.1090142,Steam)。在安装了一个旧版(2023 年)的对话模组构建和另一个模组的重制版构建的情况下,该工具准确预测了一个错误:random_dialog_picker.ws 第 409 行,“AreaTypeToName”未找到。游戏恰好以该错误停止,没有其他错误(见图片)。
它没有对游戏自带的 1,524 个脚本文件中的任何一个报告错误。它还在 11 个真实的模组(从 2016 年到 2026 年)上进行了测试,包括单独安装和全部一起安装。

[size=4][b]如何使用[/b][/size]
[list]
[]将 zip 解压到任意位置(桌面、游戏文件夹……)。请[b]手动[/b]下载:这是一个你要运行的工具,而不是游戏模组。[/]
[][b]检查你的模组:[/b]双击 [b]W3CompatDoctor.exe[/b]。报告会在你的浏览器中打开,并保存在 exe 旁边(Compatibility-Report.html,以及一个简短的 .txt)。[/]
[][b]安装前检查模组:[/b]将其压缩包或文件夹拖到 W3CompatDoctor.exe 上。[/]
[]它会自行找到 Steam、GOG 和 Epic 的安装;否则它会询问一次游戏文件夹。[/]
[/list]系统要求:Windows 10 或 11,64 位。无需安装任何东西。.7z 和 .rar 使用 Windows 自带的 tar.exe 解包。
解压后 exe 不见了?你的杀毒软件可能删除了它:在 Windows 安全中心 > 病毒和威胁防护 > 保护历史记录中恢复它。

[size=4][b]解读判定结果[/b][/size]
[list]
[][b]重制版:[/b]每个带版本号的文件都使用你游戏的格式(或该模组携带了 REDkit 5 脚本 blob)。[/]
[][b]部分更新:[/b]部分文件是当前的,部分来自重制版之前。[/]
[][b]旧版本:[/b]每个带版本号的文件都来自重制版之前,或其脚本是旧版游戏代码的副本。[/]
[][b]无法判断:[/b]只有松散脚本、XML 或 CSV,它们不带版本号。脚本检查仍会对它们运行。[/]
[/list]较旧的格式并不总是意味着模组已损坏:为 4.x 制作的纹理和网格替换模组仍可能正常工作。在后果已知的地方,报告会说明;在未知的地方,它只说明该文件来自较旧版本。

[size=4][b]对比(核查于 2026 年 11 月 19 日)[/b][/size]
[list]
[][url=https://www.nexusmods.com/witcher3/mods/13076]Script Merger - Remastered[/url] 合并冲突的脚本和 XML。用它来修复本报告发现的脚本冲突。[/]
[][url=https://www.nexusmods.com/witcher3/mods/14413]Witcher 3 REMASTERED Mod Conflict Scanner[/url] 详细列出重叠内容,并为特定模组构建补丁。[/]
[][url=https://www.nexusmods.com/witcher3/mods/12851]Witcher Conflict Resolver[/url] 分享针对脚本冲突的可复用解决方案。[/]
[][url=https://www.nexusmods.com/witcher3/mods/12836]Mod Doctor[/url] 修复菜单文件列表和缺失的字符串表,读取崩溃转储,并将模组匹配到 Nexus 页面。[/]
[/list]据它们的页面所述,它们中没有一个会读取模组文件的格式版本以判断其为哪个游戏版本构建、针对重制版的类解析脚本调用、按哪一方已过时来给冲突排序、检查重制版的 on_conflict 覆盖、比较存档模组列表或标注原生插件的日期。请将它们配合使用。

[size=4][b]未测试[/b][/size]
[list]
[]通过 mod.io(游戏的“模组”菜单)和 Mod Organizer 2 安装的模组:可检测,但未用真实安装进行测试。[/]
[]在真实重制版存档上的存档检查(仅用符合文档布局的示例文件测试)。[/]
[]注释中的旧式短状态名(@wrapMethod(HorseRiding))是否仍能编译:仅作为警告报告。[/]
[]重制版之前的 bundle 和纹理缓存在游戏中的作用:报告只说明它们来自较旧版本。[/]
[]GOG、Epic、Linux / Steam Deck。[/]
[/list]脚本检查不检查参数数量和类型、字段访问或枚举值:那里的错误可能会被遗漏,但不会被误报。编译后的脚本 blob 无法读取,因此携带此类文件的模组会对其松散脚本使用的名称给出警告而非错误。

[size=4][b]安全与隐私[/b][/size]
扫描只读取文件。不会向任何地方发送任何内容。报告和求助文本会将你的 Windows 用户文件夹替换为 %USERPROFILE%。

[size=4][b]致谢[/b][/size]
重制版脚本和 XML 覆盖规则:v1ld 的 [url=https://gist.github.com/v1ld/2b9bad413bc7fc3d1c453a58ea7c153e]注解与模组分层实地指南[/url]。
源代码(MIT):[url=https://github.com/La2o/Witcher3-RemasteredModCompatibilityDoctor]GitHub[/url]。非常欢迎附带“复制求助文本”内容的错误报告。