
夜城帧实验室
记录一次游戏运行会话,并告诉你每次卡顿的原因:着色器构建、世界流式加载、显存、单个REDscript和CET模组、驱动程序、磁盘。为我自己的300模组游戏而做。仅在游戏版本2.31上使用NVIDIA显卡测试过。
查看大图[size=5]Night City Frame Lab[/size]
一个用于重度模组化《赛博朋克 2077》的卡顿与性能记录器。
[size=4]我为什么做这个[/size]
这最初是为我自己的游戏做的。我运行着大约 300 个模组,游戏已经变成了卡顿地狱,而我完全不知道哪些模组在消耗什么。随机移除模组然后祈祷并没有让我有任何进展,所以我想要一个能记录一次游戏会话并告诉我每个慢帧究竟是什么造成的东西。
这就是它。它把我的游戏从卡顿地狱变得流畅。
它是围绕我自己的电脑构建的,所以它是一个模组作者给另一个模组作者的工具,而不是一个打磨过的产品。它只在 NVIDIA 显卡上制作和测试过。 我没有 AMD 显卡,所以它还没有针对 AMD(或 Intel)显卡进行优化或准备就绪。GPU 时钟、功耗和温度读数来自 NVIDIA 的驱动,其余部分尚未在其他显卡上测试。
[size=4]它向你展示什么[/size]
记录一次会话(在 Frame Lab 中启动、游玩、退出),你会得到一份报告,其中每个慢帧都按其成因着色:
- 着色器和光线追踪管线构建
- 世界流送、文件加载和实体生成
- REDscript 和 CET 模组,以及每个模组占用的脚本时间
- VRAM 占满,或游戏内存溢出到系统 RAM
- 磁盘读取、系统 RAM 不足、页面文件
- Windows 驱动占用 CPU(中断 / DPC)
- 游戏重置屏幕(重新应用全屏、重建屏幕缓冲区)
- GPU 密集型帧、GPU 达到功耗或温度上限
每个尖峰都会列出与它重叠的内容,并且会根据该会话自身的数字计算出一份“可以尝试”列表。它告诉你时间花在哪里。修复仍然取决于你。
其他标签页(游戏不需要运行):
- Mods:会话中每个模组及其测得的开销:脚本时间、游戏从它加载的文件,以及它参与了多少次尖峰。
- Compare:两个会话并排对比,这样你可以看到某项改动是否真的起了作用。
- Conflicts:替换同一游戏文件的归档(以及哪一个胜出)、被两个 REDscript 模组替换的游戏函数、被两个模组设置不同值的 TweakXL 值,以及你的 RED4ext、ArchiveXL、TweakXL、REDscript 和 CET 日志中的错误。
- VRAM:当前哪些程序在你的显卡上占用内存,并有一个按钮可将后台应用(浏览器、Discord、启动器)移到集成显卡。此外还会扫描每个模组增加了多少纹理内存,以及哪些纹理没有 mipmap。
- Experiments:人们为游戏使用的常见 Windows 调整,每一项单独开启并精确撤销,因此两次会话就能显示某一项是否对你的电脑有帮助。
[size=4]要求[/size]
- Windows 10 或 11,64 位。以管理员身份运行:PresentMon 和 Windows 事件跟踪需要它,写入 Program Files 下的游戏文件夹也需要它。
- Microsoft Edge WebView2 Runtime(Windows 11 已自带)。
- RED4ext 用于引擎记录器。没有它你仍然可以获得帧时间、GPU 和 PC 读数以及 Windows 事件,但无法获得引擎侧的内容(加载、流送、着色器、脚本时间)。
- redscript 和 Cyber Engine Tweaks(可选):加载屏幕标记和 CET 模组计时。
- WolvenKit(可选):报告显示游戏文件名而不是数字。
[size=4]游戏版本[/size]
在 2.31 上制作和测试,因为我的游玩流程会留在 2.31。它尚未在 2.5 上测试。 在其他游戏版本上,引擎记录器会省略它找不到的部分,并在其日志中说明,所以报告的大部分内容应该仍然有效,但我目前还不能保证。
[size=4]安装[/size]
将文件夹解压到任意位置(不要解压到游戏文件夹),然后启动 NightCityFrameLab.exe。 首次启动时它会查找你的游戏:Steam、GOG 和 Epic 安装、每个驱动器上的常见文件夹,以及它们旁边的副本("Cyberpunk 2077 - Modded" 等)。每个文件夹是一个"构建"。如果它漏掉了一个,使用 设置 > 添加构建 并选择包含 bin\x64 的文件夹。
[size=4]如何记录[/size]
- Capture 标签页:选择构建、命名会话并按下 START SESSION(游戏已关闭)。
- 启动游戏并游玩。去一些对你来说会卡顿的地方。
- 可选:在卡顿的地方按 F11,再按 F11 结束标记。每个模组的脚本时间在标记的部分内测量。
- 退出游戏。Frame Lab 会收集所有内容,从游戏中取回它的文件并打开报告。
加载屏幕和主菜单不计入数字。
[size=4]它在你的游戏文件夹中放入什么[/size]
仅用于一次会话:
- red4ext\plugins\HitchRecorder(引擎记录器)。它在一次游戏运行后会自动关闭,所以即使崩溃后下一次启动也是干净的。
- r6\scripts\NightCityFrameLab\FrameLab.Markers.reds(加载屏幕标记)。
当你退出游戏时,两者都会再次被移除。如果游戏或电脑在会话中途崩溃,Frame Lab 会在下次启动时提供移除它们的选项。游戏文件夹中的其他内容都不会被更改。CET 本身不会被触碰。
[size=4]Windows 或杀毒软件警告[/size]
该 exe 未签名,它请求管理员权限,它使用 Windows 的内核事件跟踪,并且它会为一次会话向游戏中放入一个插件。Windows 可能会显示"未知发布者"警告,一些杀毒软件可能会报毒。它更改的所有内容都列在上面。
[size=4]卸载[/size]
关闭你开启的任何 Experiments,并在 VRAM 标签页上撤销你移动的任何程序,然后删除文件夹。一次会话后游戏文件夹中不会留下任何东西。
[size=4]Bug[/size]
data\framelab.log 记录了它采取的每一步。每个会话文件夹还有来自引擎记录器的 hitch.log。请在 Bugs 标签页中将这些与你的报告一起发布。
[size=4]致谢[/size]
- PresentMon by Intel (MIT)
- uPlot by Leon Sorokin (MIT)
- go-webview2 by John Chadwick (MIT), with Microsoft's WebView2Loader
- golang.org/x/sys by the Go Authors (BSD-3)
- MinHook by Tsuda Kageyu (BSD-2)
- 将脚本函数映射到它们的 .reds 文件是来自 jekky 的 redscript-dap (MIT) 的想法
- CET 计时读取 LuaJIT 的数据布局(LuaJIT by Mike Pall 和 Cyber Engine Tweaks by yamashi 及贡献者,均为 MIT)
- 游戏函数哈希来自 psiberx 的 ArchiveXL 和 RED4ext.SDK
- 文件名来自 WolvenKit 的路径列表,从你自己的 WolvenKit 安装中读取
REQUIREMENTS TAB
Nexus 要求: RED4ext(Cyberpunk 2077 模组 2380) 注意:用于引擎记录器(加载、流送、着色器、脚本时间)。没有它你只能获得帧时间、GPU 和 PC 读数。 Cyber Engine Tweaks(Cyberpunk 2077 模组 107) 注意:可选。加载屏幕标记和 CET 模组计时。 redscript(Cyberpunk 2077 模组 1511) 注意:可选。加载屏幕标记(与 CET 一起使用)。
站外要求: Microsoft Edge WebView2 Runtime - https://developer.microsoft.com/en-us/microsoft-edge/webview2/ 注意:窗口需要它。Windows 11 已自带。 WolvenKit - https://github.com/WolvenKit/WolvenKit/releases 注意:可选。报告显示游戏文件名而不是数字。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。