过场动画武器切换器

《赛博朋克2077》过场动画武器动态替换 MOD 使用指南

【核心介绍】
修补游戏 `.scene` 过场动画文件，将默认武器占位符自动替换为你当前实际装备/持有的对应类型武器（如手枪、左轮、霰弹枪），提升沉浸感与一致性。

【安装指南】

1. 下载本 MOD 并解压所有文件，完整粘贴至《赛博朋克2077》游戏根目录（即包含 `Cyberpunk2077.exe` 的文件夹）；
2. 确保覆盖路径中同名文件（如 `r6\scripts\CutsceneWeaponSwapper.reds`），缺一不可；
3. 本 MOD 无需前置依赖，但需确保已安装官方更新「Phantom Liberty」扩展包（否则部分场景不生效）。

【功能详情】
✅ 已优化：

• 自动识别并替换 12 个主线/支线/资料片过场动画中的武器模型（含「The Ripperdoc」「Life During Wartime」「Spider and the Fly (Phantom Liberty)」等）；
• 按优先级匹配武器：① 最后使用武器 → ② 当前装备武器 → ③ 库存中同类型武器；
• 场景适配逻辑：手枪/左轮类场景（绝大多数）自动匹配；「Search and Destroy」任务强制匹配霰弹枪。
  ❌ 未修改：
• 非武器相关过场元素（角色动作、镜头、对话、UI）；
• 未列入支持列表的其他 `.scene` 文件（如自定义模组新增场景）。
  ✨ 额外调整：
• 若未找到匹配武器，自动跳过修补，保留原默认模型（无崩溃风险）；
• 支持「Phantom Liberty」资料片全部新增武器类型及绑定逻辑。

【使用要求】

• 必须安装官方扩展包「Phantom Liberty」；
• 游戏版本需为 v2.1 或更高（建议使用最新稳定版）；
• 无需额外工具（如 WolvenKit、Cyber Engine Tweaks），纯文件覆盖即可运行。

【兼容性说明】

• 兼容范围：所有官方主线、支线、街边故事及「Phantom Liberty」新增过场；
• 不兼容模组：
• 修改相同 `.scene` 文件的其他过场动画补丁（如「过场动画武器替换」旧版）；
• 直接重写 `CutsceneWeaponSwapper.reds` 或同类脚本的模组；
• 兼容补丁：暂未推出（若与其他武器类模组共存，请按加载顺序将本 MOD 置于靠后位置）。

【注意事项】

• 「Killing Moon (Phantom Liberty)」结局场景仅部分支持，武器显示可能因分支条件存在延迟；
• 若库存中无匹配武器类型（如场景需霰弹枪但你未持有），将回退至默认模型，属正常行为；
• 卸载时请手动删除 `Cyberpunk 2077
  6\scripts\CutsceneWeaponSwapper.reds` 文件，避免残留冲突。

【更新日志】

• 2024 年 5 月 12 日 新增对「Gig: The Man Who Killed Jason Foreman (Phantom Liberty)」Rinder 谈话场景支持；
• 2024 年 4 月 3 日 修复「Transmission」场景在未装备火器时的匹配逻辑；
• 2023 年 12 月 8 日 首发支持「Phantom Liberty」全部新增过场文件（含 `ep1\quest\main_quests\q306\scenes\q306_10_finale.scene`）。