PBZ Cinematic Letterbox｜影之刃零电影宽银幕

主要功能

• 自动剧情检测：识别实时演算剧情，自动显示或隐藏电影黑边。
• 视频 CG 检测：增加对部分预渲染过场的识别支持，实际覆盖情况仍待验证。
• 平滑切换：黑边以约0.3秒渐变出现或消失。
• F8 一键开关：游戏启动默认启用，按 F8 关闭，再按一次重新启用自动检测功能。
• 分辨率适配：根据游戏视口尺寸计算遮幅比例，支持不同分辨率的动态计算。
• 跨场景恢复：尝试在切换场景、读取存档后重新建立黑边控件。

另外，本版本加入了战斗状态、菜单状态和输入模式的只读检测日志，为后续制作「探索与剧情显示电影画幅，战斗中恢复完整视野」功能做准备。

注意：战斗与菜单自动切换尚未实装，目前不会根据是否进入战斗自动关闭黑边。

安装方法

必需前置： 《影之刃零》专用 UE4SS

1. 安装与当前游戏版本兼容的 UE4SS。
2. 解压本 MOD 压缩包。
3. 将 PBZCinematicLetterbox 文件夹放入游戏目录下的 platform\steam\ue4ss\Mods。
4. 确认 PBZCinematicLetterbox\Scripts\main.lua 和 enabled.txt 均存在。
5. 启动游戏即可，按 F8 可以启用或关闭 MOD。

卸载时退出游戏，删除 Mods 内的 PBZCinematicLetterbox 文件夹即可。

当前验证情况

此前开发版本已在游戏中确认：UE4SS 能够加载 Lua 脚本、读取实时演算剧情状态，并成功绘制上下电影黑边。

当前 probe3 版本已通过 Lua 语法检查和模拟测试，但尚未完成游戏内实测。

已知问题

• 连续 CG 或切换场景时，黑边可能短暂消失。
• 部分预渲染 CG 可能未被正确识别。
• 黑边可能遮挡靠近画面上下边缘的字幕或跳过提示。
• 不同分辨率、DPI 缩放与游戏版本的兼容性尚未全部验证。

如果遇到黑边异常，可以尝试按 F8 临时关闭。欢迎反馈具体场景及 UE4SS 日志，后续将根据实机测试继续修复。

制作说明

本 MOD 使用 ModCraft AI 辅助开发，并结合人工调试、游戏内测试与代码检查持续迭代。

采用游戏内置 UMG 控件进行遮幅绘制，不重新分发游戏模型、贴图或音视频资源。UE4SS 为单独安装的第三方前置。

当前版本属于功能测试阶段，后续计划完善连续 CG 检测与战斗状态联动。