用途:该技能面向虚幻引擎(Unreal Engine)中编辑器或游戏帧率被人工限制的场景,帮助排查并清除各类 FPS 上限,使运行达到不限制状态或指定的目标帧率。
主要能力:技能归纳出五个可能导致帧率被压低的独立来源,并给出“不限制”时应设置的值:
- 控制台变量 t.MaxFPS:设为 0(完全放开)或较高的目标值如 240;
- r.VSync / r.VSyncEditor:设为 0,因为开启时会锁定到显示器刷新率(如 60 Hz);
- [/Script/Engine.Engine] 中 DefaultEngine.ini 的 bUseFixedFrameRate / FixedFrameRate:设为 False;
- 同一节的 bSmoothFrameRate / SmoothedFrameRateRange:设为 False,这是常见的约 60 帧编辑器上限来源;
- [/Script/UnrealEd.EditorPerformanceSettings] 中 EditorPerProjectUserSettings.ini 的 bThrottleCPUWhenNotForeground:设为 False,该项会在编辑器失去焦点时压低帧率。 技能还提示:UE 5.7 中 r.FrameRateLimit 不是控制台变量,set_console_variable 会报“找不到控制台变量”;INI 中的 FrameRateLimit 键位于 [/Script/Engine.Engine] 下,但 t.MaxFPS 才是可靠的运行时上限。
使用方式:技能强调先诊断、不要猜测。t.MaxFPS = 0 已表示不限制,若编辑器仍卡在 60,说明上限来自别处(通常是 VSync 锁定到 60 Hz 显示器,或平滑帧率范围)。在改动前应逐一读取上述所有来源。技能区分“被上限固定”与“运行缓慢”:若帧率低而非固定在整数,则属于负载问题而非上限,应先运行 unreal.PerformanceService.frame_timing()(取代已移除的 editor_control 工具的新服务)判断受限于 CPU 还是 GPU;只有存在人为压制时才处理这些上限。
技能提供了基于 Python 的工作流:使用 unreal.EngineSettingsService 读取控制台变量与 INI 值;通过 set_console_variables_from_json 设置 t.MaxFPS、r.VSync、r.VSyncEditor;通过 set_engine_ini_value 修改 bUseFixedFrameRate、bSmoothFrameRate 和 bThrottleCPUWhenNotForeground;随后调用 save_all_engine_config 保存。cvars 立即生效,INI 修改需保存且可能需要重启编辑器。
验证方式:应用后确认 t.MaxFPS 为设定值,并在编辑器 FPS 叠加显示(Show FPS)或 PIE 中的 stat fps 中观察帧率升至 60 以上;若仍固定在 60,最可能的原因是质量预设重新启用了 r.VSync/r.VSyncEditor,或受限于显示器本身,因为 VSync 最高只能到显示刷新率。
示例脚本:scripts/uncap_fps.txt,通过 execute_python_code 运行,可读取全部五项上限并按目标帧率解除限制。
适用场景:虚幻引擎项目中编辑器或游戏出现“锁定”“被限制”“卡住”等帧率异常且怀疑存在人为上限时。
限制与缺失:资料未提供该技能的价格、收费方式、支持的引擎版本范围(仅提及 UE 5.7 的一处说明)、安装步骤或依赖要求,这些内容暂未提供。