STALKER 2 超宽屏与镜头调整工具，适用于UE 5.5.4

[center][size=6][b]潜行者2 超宽屏与镜头调整（适用于 UE 5.5.4）[/b][/size] [size=4][b]游戏玩法 • 过场动画 • 对话视场角 • 自定义画面构图[/b][/size]

[b]版本 0.5.0[/b][/center]

[size=4][b]关于本模组[/b][/size] 这是一个针对 Steam 版《潜行者2：切尔诺贝利之心》的统一超宽屏、影院与镜头/视场角修复模组。 本模组修正了 21:9 和 32:9 显示器上的游戏镜头行为，修复了过场动画宽高比和 Hor+ 视场角，添加了自定义过场画面构图，并提供了感知视场角的对话缩放控制。

[b] [size=4]与其他镜头/视场角模组的兼容性 [/size][/b] [quote]与其他修改游戏[b]镜头、视场角、对话缩放、过场画面构图、宽高比镜头行为或相关镜头状态[/b]的模组的兼容性无法保证。 [b]提交 Bug 报告时，必须仅安装 STALKER2CameraTweaks 作为唯一的镜头/视场角相关模组进行复现。[/b] 仅在使用其他镜头/视场角相关修改时出现的问题[b]将不被视为 STALKER2CameraTweaks 的 Bug 报告。[/b] 除非它们修改相同的镜头系统，否则其他无关模组没有问题。[/quote][size=4][b]功能特性[/b][/size] [list] []修复 [b]21:9 和 32:9[/b] 宽高比下的游戏画面转换问题。 []添加感知视场角的对话缩放：原生、自适应、减弱和禁用。 []在游戏镜头重建（包括死亡/读档）后自动重新启用。 []保留您选择的游戏视场角设置。 []根据游戏运行时镜头状态修正过场动画宽高比。 []应用正确的 [b]Hor+ 过场视场角[/b]。 []在 Auto（自动）模式下，同一游戏会话期间动态跟随运行时宽高比变化，无需重启游戏。 []支持自定义过场画面构图： [b]自动 / 原生 / 16:9 / 21:9 / 32:9[/b]。 []允许 16:9 用户使用信箱模式呈现的更宽过场画面构图。 []自动创建并同步 INI 配置文件。 []使用带保护的签名解析，而非固定的补丁特定 RVA。 []如果所需签名或指令验证不再匹配，将安全失败。 [/list][size=4][b]自定义过场画面构图[/b][/size] 过场画面构图可以独立于您的物理显示器进行选择。 [list] [][b]自动[/b] — 跟随游戏当前运行时镜头宽高比。 [][b]原生[/b] — 保持游戏原始的过场宽高比行为不变。 [][b]16:9[/b] — 强制使用 16:9 过场画面构图。 [][b]21:9[/b] — 强制使用 21:9 过场画面构图。 [*][b]32:9[/b] — 强制使用 32:9 过场画面构图。 [/list]例如，在 [b]16:9 显示器上强制使用 32:9[/b] 会产成更宽的过场画面，并伴有上下黑边。 过场视场角会根据所选的构图策略自动处理。 原生模式保持游戏原始的过场宽高比和视场角行为不变，而自动和强制模式则会为所选构图应用适当的视场角行为。

[size=4][b]对话缩放[/b][/size] 版本 0.5.0 添加了适应实际游戏视场角的对话缩放功能： [list] []原生 - 保持游戏原始的对话缩放，目前目标为 70 度。 []自适应 - 相对于当前游戏视场角，保留游戏原生光学变焦强度。 []减弱 - 应用自适应光学变焦强度的一半。这是默认模式。 []禁用 - 对话期间保持游戏视场角不变。 [/list]保留了原生对话过渡时机，包括离开对话时的平滑恢复。

[size=4][b]配置说明[/b][/size] 模组会自动创建 STALKER2CameraTweaks.ini。 默认配置： [code][Gameplay] Enabled=true

[Cinematics] ; Auto, Native, 16:9, 21:9, 32:9 AspectRatio=Auto

[Dialogue] ; Native - keep the game's original dialogue zoom, currently targeting 70 degrees. ; Adaptive - preserve the native optical zoom strength relative to the current gameplay FOV. ; Reduced - apply half of the Adaptive optical zoom strength. ; Disabled - keep the current gameplay FOV during dialogue. Zoom=Reduced

[Hotkeys] ; Optional runtime controls for testing and comparing settings without restarting. ; Hotkeys are disabled by default and are not required for normal use. ; Supported keys: F1-F12, 0-9 and A-Z. Enabled=false

; Key used to select the mode for the next cinematic. ; Auto -> Native -> 16:9 -> 21:9 -> 32:9 -> Auto. CinematicCycle=F9

; Key used to select the zoom mode for the next dialogue. ; Native -> Adaptive -> Reduced -> Disabled -> Native. DialogueCycle=F10[/code]自动模式会跟随游戏运行时的镜头宽高比并应用匹配的 Hor+ 视场角。它也会在同一会话中游戏分辨率变化时进行更新。 原生模式保持游戏原始的过场宽高比和视场角行为不变。强制模式则提供带有匹配视场角的自定义过场画面构图。 自适应模式相对于当前游戏视场角保留游戏原生的光学变焦强度。减弱模式应用该光学效果的一半强度。禁用模式在对话期间保持游戏视场角不变。 手动修改 INI 需要重启游戏。运行时热键选择无需重启，并将应用于下一个相应的过场动画或对话。按下热键后，正在进行的过场动画或对话不会重建。

[size=4][b]环境需求[/b][/size] [list] []Steam 版《潜行者2：切尔诺贝利之心》 []测试版本： [b]2.0.4[/b] []虚幻引擎 [b]5.5.4[/b] []Ultimate ASI Loader (x64) [/list][size=4][b]安装方法[/b][/size] [list=1] []安装 [b]Ultimate ASI Loader[/b] 并将 [b]dsound.dll[/b] 放置于： [code]Stalker2\Binaries\Win64[/code] [][b]现有用户请注意：[/b] 删除之前的 [b]STALKER2UltrawideFix.asi[/b]、[b]STALKER2GameplayAspectFix.asi[/b] 及其旧的 INI/日志文件。 [b]请勿将旧文件与 STALKER2CameraTweaks.asi 一同加载。[/b] []解压： [code]STALKER2CameraTweaks.asi STALKER2CameraTweaks.ini[/code]到相同的 Win64 目录中。 []启动游戏。 [/list]该模组会创建 [b]STALKER2CameraTweaks[/b][b].log[/b] 日志文件。 报告兼容性问题时，请附上此文件。 日志会记录加载的 [b]模组 SHA-256 值、游戏可执行文件 SHA-256 值[/b]以及签名解析状态。

[size=4][b]测试情况[/b][/size] [list] []21:9 和 32:9 游戏玩法，包括启动、宽高比切换以及死亡/读档后的镜头重建。 []自动过场动画模式： 16:9 → 21:9 → 32:9 → 16:9 → 21:9 → 32:9 在单次会话中通过游戏内分辨率更改进行，无需重启。 []原生过场策略。 []在 5120x1440 分辨率下强制 16:9、21:9 和 32:9 过场画面构图。 []在 2560x1440 分辨率下强制 32:9 过场画面构图，产生预期的过场信箱模式呈现。 []运行时宽高比更改后的过场动画 → 游戏玩法恢复。 []在 Steam 2.0.4 版本上测试对话缩放的原生、自适应、减弱和禁用模式。 []连续对话循环以及过场动画到对话的状态隔离。 []为下一个过场动画或对话进行运行时 F9/F10 策略选择。 []对话解析器在 Steam 2.0.2、2.0.3 和 2.0.4 版本上经过静态验证。这并非对旧版本运行兼容性的证明。 [/list][size=4][b]已知问题[/b][/size] [list] [][b]过场动画后的镜头过渡：[/b] 在某些过场动画结束后、游戏将控制权交还给玩家时，仍可能短暂出现镜头/投影偏移。 [][b]21:9 武器/视角模型视场角：[/b] 游戏武器/视角模型视场角可能在过场动画、读档或游戏镜头重建后进入不正确的状态。瞄准或打开菜单会刷新游戏的视角模型状态。这与游戏镜头宽高比修复是分开的问题。 [*]请勿将 STALKER2CameraTweaks.asi 与 STALKER2UltrawideFix.asi、STALKER2GameplayAspectFix.asi 或实验性的过场动画 ASI 模组组合使用。 [/list][size=4][b]游戏更新兼容性[/b][/size] 游戏玩法、过场动画和对话的挂钩位置使用带保护的签名和指令验证动态解析，而非固定的补丁特定 RVA。 仅移动已验证代码位置的游戏更新[b]可能无需模组更新即可继续工作[/b]，而结构性更改则可能需要新的签名。 如果验证失败或结果不明确，相关挂钩设计为[b]安全失败[/b]，而不会针对未知代码路径进行安装。 此版本已在 Steam [b]2.0.4[/b] 版本上通过运行时验证。

[size=4][b]Defender 通知[/b][/size] [quote]Microsoft 已审查发布版本二进制文件并将其归类为 [b]“非恶意软件”。[/b] 如果您的系统上仍有旧检测，请更新 Microsoft Defender 安全情报并重新扫描该文件。[/quote][size=4][b]支持开发[/b][/size] 此模组是跨越多个游戏版本进行大量逆向工程、运行时追踪、实现和测试的成果。 完整的研究与开发历史可在 GitHub 上获取。 如果此模组对您有帮助，并且您想支持未来的开发： [list] [][url=https://ko-fi.com/elhait]Ko-fi[/url] [][url=https://donatello.to/Elhait]Donatello[/url] [/list]感谢您的支持。

[size=4][b]源代码与研究[/b][/size] [list] [][url=https://github.com/Elhait/STALKER-2-Ultrawide-Fix-for-UE-5.5.4]GitHub 源代码与研究历史[/url] [][url=https://www.nexusmods.com/stalker2heartofchornobyl/mods/2337]WIDEBOY Fixes by BigChenga[/url] - 对话视场角调查期间使用的研究参考；本模组的对话实现是独立逆向工程和运行时验证的。 [*]第三方库和代码归属列于 THIRD_PARTY_NOTICES.md 中。 [/list]