REDmod 2.5 部署修复

REDmod 2.5 部署修复

修复REDmod部署在2.5版本后失败并报错“导入的类(如'ISerializable')必须派生自某个基类”的问题。一个小型PowerShell补丁程序修复了三个导致编译器出错的REDmod脚本文件,使REDmod脚本模组恢复正常工作。包含备份和-Undo撤销选项。已在游戏中测试。

[size=4][b]修复内容[/b][/size]
自 2.5 补丁起,每次包含脚本的 REDmod 部署都会在 [b]Stage 2/5 - Script Compilation[/b] 阶段失败:
[code]ScriptCompiler: ERROR: Imported classes (like 'ISerializable') must derive from something.
ERROR: Script compilation has failed![/code]在 Vortex 中显示为 [b]“REDmod deployment failed”[/b] / “Failed to run tool”。这不是你的模组的问题:即使用一个空的测试模组也会发生。

[size=4][b]原因[/b][/size]
REDmod DLC 在 [font=Courier New]tools\redmod\scripts[/font] 中附带的脚本源码无法用 REDmod 自带的编译器编译:
[list]
[][font=Courier New]mods\codeware\callbackSystem.script[/font] 声明了引擎的根类 [font=Courier New]ISerializable[/font] 但未指定父类,而编译器只允许 [font=Courier New]IScriptable[/font] 这样做。为它指定父类后可以编译,但游戏会拒绝启动,因此修复方案改为移除 [font=Courier New]ISerializable[/font] / [font=Courier New]CResource[/font] 的声明,以及两个返回 [font=Courier New]CResource[/font] 的 [font=Courier New]ResourceEvent[/font] 成员。[/]
[][font=Courier New]tarot_main.script[/font] 和 [font=Courier New]inventoryItemMode.script[/font] 将一个 [font=Courier New]ref< inkCompoundRef >[/font] 传给 [font=Courier New]inkWidgetRef.Get[/font],编译器无法转换。修复方案改为按值传递该参数(同一个控件,行为不变)。[/]
[/list]REDmod 脚本唯一失去的是 [font=Courier New]ResourceEvent.GetResource()[/font]([font=Courier New]GetPath()[/font] 保留)。游戏自身的脚本中没有任何地方使用它。

[size=4][b]使用方法[/b][/size]
[list=1]
[]下载并解压 zip 到任意位置(不要解压到游戏文件夹)。[/]
[]右键点击 [b]Fix-REDmod-Deploy.ps1[/b] > [b]Run with PowerShell[/b]。它会自动查找 Steam、GOG 和 Epic 的安装位置;对于其他文件夹,使用 [font=Courier New]-GamePath "D:\Games\Cyberpunk 2077"[/font] 运行。[/]
[]从启动器、Vortex 或 MO2 再次部署。[/]
[/list]要撤销:使用 [font=Courier New]-Undo[/font] 运行它。它会从每个文件旁边保留的 [font=Courier New].ynkfix-backup[/font] 副本恢复原始文件。

[size=4][b]为什么用这个方案而不是变通方法[/b][/size]
关闭 REDmod 部署,或将原版 [font=Courier New]final.redscripts[/font] 复制到 [font=Courier New]r6\cache\modded[/font],可以让游戏启动,但 REDmod 模组的脚本更改不会生效。此方案修复了编译本身,因此 REDmod 脚本模组可以再次正常工作。

[size=4][b]安全性[/b][/size]
[list]
[
]就地编辑这三个文件;不附带任何 CDPR 文件。[/]
[
]在更改每个文件之前进行备份;[font=Courier New]-Undo[/font] 可以精确恢复它们。[/]
[
]可以安全地运行两次:已修复的文件会被跳过。[/]
[
]如果文件内容不匹配(例如在 CDPR 热修复之后),它会跳过该文件并发出警告,而不是猜测。[/]
[
]它是一个简短的纯文本脚本:在运行之前用记事本打开并阅读它。[/*]
[/list]
[size=4][b]测试情况[/b][/size]
Cyberpunk 2077 2.5(Steam),REDmod 2.5:修复前部署失败,修复后成功;启用模组后游戏可以进入菜单并加载存档;一个覆盖 [font=Courier New]player.script[/font] 的 REDmod 测试模组在游戏中运行(其屏幕消息出现)。尚未在 GOG 或 Epic 安装上测试;欢迎反馈。

如果你手动运行 [font=Courier New]redMod.exe[/font],还需传入 [font=Courier New]-rttiSchemaPath "<game>\tools\redmod\metadata.json"[/font]:它的默认路径是相对于当前文件夹的。

[size=4][b]源码[/b][/size]
在 GitHub 上开源:[url=https://github.com/OriginalLeeDunn/ynk-cyberpunk77-mods/tree/main/tools/redmod-2.5-deploy-fix]ynk-cyberpunk77-mods / tools / redmod-2.5-deploy-fix[/url]

使用 AI 编码助手(Claude,通过 Claude Code)制作,它帮助追踪了原因并编写了脚本。我在游戏中进行了测试。