诊断决策表：巫师 3 脚本编译报错与合并冲突类型归因
《巫师 3：狂猎》的底层逻辑运行在专有的 Redscript（.ws 脚本）之上。当玩家安装的多个 Mod 同时修改了相同的核心脚本（如 playerInput.ws、r4Player.ws 或 gameplayTypes.ws）时，游戏引擎在启动自检时便会弹出编译错误窗口并直接闪退。
| 编译器典型报错提示 | 底层语法破坏成因 | 冲突复杂度 | 技术处置方案 |
|---|---|---|---|
| Error [content0] unexpected symbol near... | 自动合并时括号缺失或缩进破坏导致 AST 断裂 | 高：代码块花括号闭合错误或 return 位置错乱 | 使用 KDiff3 手动审查三路差异，补齐花括号 |
| Cannot find function / Function redefined | 两个 Mod 在同一作用域下声明了完全相同的函数名 | 中：全局函数或变量重名冲突 | 注释掉冗余的重复定义，或统一合并函数内逻辑 |
| Type mismatch / Class not recognized | 次世代版本（v4.04）误装了老版本（v1.32）的旧版 Mod | 致命：底层类库与引擎接口发生架构级断裂 | 彻底卸载旧 Mod，换用适配次世代版本的专用包 |
| 每次开机都要重复漫长编译 | mod0000_MergedFiles 被设置为只读或权限受阻 | 低：编译生成的二进制缓存无法持久化落盘 | 赋予游戏 mods 目录当前 Windows 用户完全控制权 |
| 无报错成功启动但进游戏崩 | 逻辑语义死锁（两个 Mod 的状态机发生物理冲突） | 极高：语法完全合法但游戏逻辑死锁 | 逐个反向排查合并项，放弃存在机制冲突的功能 |
KDiff3 三路合并核心判读逻辑
Script Merger 底层调用 KDiff3 解决冲突。理解上方三个窗口的从属关系是成功合并的前提：
- A 窗口（Base）：原版游戏未修改的基准代码（来自
content0）。 - B 窗口（Mod 1）：第一个 Mod 所做的修改行。
- C 窗口（Mod 2）：第二个 Mod 所做的修改行。
- 底栏输出窗口（Merged Result）：最终写入合并补丁的生效代码。
- 无重叠冲突的自动拼接： 若两款 Mod 修改的代码行相隔较远，Script Merger 会自动将 B 与 C 的改动拼入输出底栏。
- 重叠代码块的手动处置：
当 B 与 C 同时修改了同一行：
- 严禁盲目勾选“同时应用 B 与 C”。
- 变量声明合并原则：若 Mod B 增加了
var dodgeDistance : float;，Mod C 增加了var staminaRate : float;，必须在函数头部将这两行变量声明全部保留。 - 逻辑主体合并原则：保留各自的逻辑分支，并确保末尾的类闭合花括号
}数量绝对匹配。
调控 mods.settings 强制固化加载优先级
《巫师 3》默认按文件夹名称的字典序加载 Mod，合并器生成的 mod0000_MergedFiles 凭借四个零的排头占领最高优先级。但对于极其复杂的大型整合，建议通过配置文件锁定权重：
[mod0000_MergedFiles]
Enabled=1
Priority=1
[modCombatOverhaul]
Enabled=1
Priority=10
[modTextureRepack]
Enabled=1
Priority=20
- 打开
%USERPROFILE%\Documents\The Witcher 3\。 - 打开或创建
mods.settings文本文件。 - 数字越小，优先级越高（Priority 1 会无条件覆盖 Priority 20 的同名资源）。
- 确保合并补丁
mod0000_MergedFiles始终被显式固定为Priority=1或0。
模组更新后的缓存重置准则
// 用于检查巫师 3 模组目录与合并脚本健康度的 PowerShell 脚本
$WitcherPath = "C:\Games\The Witcher 3 Wild Hunt"
$ModsDir = Join-Path $WitcherPath "mods"
$MergedDir = Join-Path $ModsDir "mod0000_MergedFiles"
if (Test-Path $MergedDir) {
$WsCount = (Get-ChildItem -Path $MergedDir -Filter "*.ws" -Recurse).Count
Write-Host "已检测到 mod0000_MergedFiles，包含 $WsCount 个合并生成的 .ws 脚本。" -ForegroundColor Green
} else {
Write-Warning "未找到合并目录，若安装了多个脚本 Mod 启动时极可能报错！"
}
- 一旦新增、删除或更新了任何包含
.ws文件的模组，必须第一时间在 Script Merger 中删除旧的Merged Scripts并重新扫描合并，严禁让残留的历史失效补丁参与编译。