
视野控制
允许阻止不需要的FOV偏移并提供额外FOV处理工具的API。
查看大图[center][size=5][color=#ffff00]此模组是一个依赖项。它扩展了游戏功能,但本身不会执行任何操作。仅在另一个模组需要它并明确要求你安装时才下载。[/color][/size][/center]
[line]
[size=6][b]FOV Control[/b][/size]
[size=4]原生 [b]RED4ext[/b] 插件,提供:[/size]
[list]
[]通过安全、版本容错的模式补丁实现的 [b]FOV 锁定[/b]。[/]
[]在引擎的 [b]内部 FOV[/b] 与游戏图形设置中显示的 [b]显示 FOV[/b] 之间进行精确的 [b]FOV 转换[/b]。[/]
[]一个全局 [b]补丁门控[/b],用于临时阻止任何内存写入(Lock/Unlock/Toggle)。[/]
[/list]
兼容最新的 [b]RED4ext[/b]。所有原生函数均暴露给 [b]REDscript[/b],因此可从 [b]CET[/b] 调用。
[line]
[size=5][b]功能[/b][/size]
[b][size=4]1) 补丁门控(全局写入开关)[/size][/b]
这些原生函数让你允许或拒绝此插件执行的任何内存补丁,从而可以在特定时刻硬性阻止 Lock/Unlock/Toggle。
[quote][code]public native class FovControl extends IScriptable {
public static native func IsPatchingAllowed() -> Bool
public static native func PreventPatching() -> Bool // 如果阻止现已激活则返回 true(幂等)
public static native func ReleasePatching() -> Bool // 如果补丁再次被允许则返回 true[/code][/quote]
语义:
[list]
[][b]IsPatchingAllowed[/b]:[color=#6fa8dc]true[/color] → 支持补丁且允许写入;[color=#6fa8dc]false[/color] → 所有写入尝试均被忽略。[/]
[][b]PreventPatching[/b]:将门控设置为 [b]阻止[/b];可安全地重复调用。[/]
[][b]ReleasePatching[/b]:将门控设置为 [b]允许[/b];可安全地重复调用。[/]
[/list]
[b][size=4]2) FOV 锁定控制[/size][/b]
切换用于阻止运行时 FOV 变化的补丁。
[quote][code] public static native func IsLocked() -> Bool
public static native func Lock() -> Bool
public static native func Unlock() -> Bool
public static native func ToggleLock() -> Bool[/code][/quote]
[b]备注:[/b]
[list]
[]所有调用均为 [b]幂等[/b](在已锁定时调用 [color=#93c47d]Lock()[/color] 会返回 [color=#6fa8dc]true[/color] 且不执行任何操作)。[/]
[]如果补丁当前被 [b]阻止[/b],[color=#93c47d]Lock[/color]/[color=#93c47d]Unlock[/color]/[color=#93c47d]Toggle[/color] 会返回 [color=#6fa8dc]false[/color] 且不写入。[/]
[]插件内部会在首次使用时验证目标地址,并记录任何失败。[/]
[/list]
[b][size=4]3) 内部 ↔ 显示 FOV 转换[/size][/b]
在引擎的 [b]内部 FOV[/b] 与图形设置中看到的 [b]显示 FOV[/b] 之间进行转换。
映射使用根据实测值手工制作的 [b]单调分段线性[/b] 曲线,锚点之间的值通过线性插值计算。
[quote][code] public static native func ConvertFormat(fov: Float, isSettingsFormat: Bool) -> Float
}[/code][/quote][list]
[][color=#f9cb9c]isSettingsFormat[/color] = [color=#6fa8dc]false[/color] → 将 FOV 解释为 [b]内部[/b] 值,返回 [b]显示[/b](图形设置)值。[/]
[][color=#f9cb9c]isSettingsFormat[/color] = [color=#6fa8dc]true[/color] → 将 FOV 解释为 [b]显示[/b](图形设置)值,返回 [b]内部[/b] 值。[/]
[/list]
[size=4][b]REDscript 示例:[/b][/size]
[quote][code]let displayValue: Float = FovControl.ConvertFormat(68.2379837, false); // 内部 → 显示
let engineValue: Float = FovControl.ConvertFormat(100.0, true); // 显示 → 内部[/code][/quote]
[line]
[size=5][b]REDscript 集成[/b][/size]
[b][color=#93c47d][size=4]CameraComponent[/size][/color][size=4] 辅助函数[/size][/b]
便捷辅助函数,可直接在摄像机组件上 [b]以显示单位获取/设置 FOV[/b]。
[quote][code]@addMethod(CameraComponent)
public func GetDisplayFOV() -> Float
@addMethod(CameraComponent)
public func SetDisplayFOV(displayFov: Float) -> Void[/code][/quote][list]
[][color=#93c47d]GetDisplayFOV()[/color] 返回当前摄像机的 [b]图形设置风格[/b] FOV。[/]
[][color=#93c47d]SetDisplayFOV()[/color] 接受 [b]显示 FOV[/b] 并写入相应的 [b]内部 FOV[/b](在内部空间中带有安全保护带)。[/]
[/list]
[b][size=4]可选的 Codeware 集成[/size][/b]
如果存在 [b]Codeware[/b],会添加轻量辅助函数,以便从 [color=#93c47d]PlayerPuppet[/color] 和 [color=#93c47d]VehicleComponent[/color] 访问 TPP 摄像机:
[quote][code]@addMethod(PlayerPuppet)
public func GetTPPCameraComponent() -> wref<vehicleTPPCameraComponent>
@addMethod(VehicleComponent)
public func GetCameraComponent() -> wref<vehicleTPPCameraComponent>[/code][/quote]无论是否存在 Codeware,这些辅助函数都存在,但在没有 Codeware 时返回 [color=#6fa8dc]null[/color]/[color=#6fa8dc]nil[/color]。
[b][size=4]CET (Lua) 示例[/size][/b]
[quote][code]local player = Game.GetPlayer()
-- 变体 A
if player then
local camera = player:GetTPPCameraComponent()
camera:SetDisplayFOV(100)
end
-- 变体 B
if player then
local vehicle = Game.GetMountedVehicle(player)
if vehicle then
vehicle:GetCameraComponent():SetFOV(68.2379837)
end
end[/code][/quote]
[b][size=4]备注:[/size][/b]
[list]
[]两个变体实际上完全相同,都会将 TPP 的引擎内部 FOV 设置为 [color=#6fa8dc]68.2379837[/color],这对应于图形设置中的 [color=#6fa8dc]100[/color]。[/]
[]此外,[color=#93c47d]GetTPPCameraComponent()[/color] 现在遵循与 [color=#93c47d]GetFPPCameraComponent()[/color] 相同的使用模式。[/]
[/list]
[line]
[size=5][b]需求[/b][/size]
必需
[list]
[]Cyberpunk 2077([b]版本 2.31[/b])[/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/2380]RED4ext[/url](加载器)[/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/1511]REDscript[/url](库)[/]
[/list]可选
[list]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/107]Cyber Engine Tweaks[/url] 用于快速测试[/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/7780]Codeware[/url](用于可选的 [color=#93c47d]CameraComponent[/color] 辅助函数)[/]
[/list]
[line]
[size=5][b]安装[/b][/size]
1. 将构建好的 DLL 放入
[quote][code]<Cyberpunk 2077>\red4ext\plugins\FovControl\FovControl.dll[/code][/quote]
2. 放置 REDscript 文件
[quote][code]<Cyberpunk 2077>\r6\scripts\FovControl\FovControl.reds[/code][/quote]
3. 启动游戏。检查日志:
[quote][code]<Cyberpunk 2077>\red4ext\logs\FovControl.log[/code][/quote]
[line]
[size=5][b]CET (Lua) 冒烟测试(可选)[/b][/size]
[quote][code]print("WasLocked:", FovControl.IsLocked(), "ToggleLock:", FovControl.ToggleLock(), "IsLocked:", FovControl.IsLocked())[/code][/quote]
[line]
[size=5][b]日志记录[/b][/size]
该插件使用 [b]RED4ext logger[/b]。你可以在以下位置找到消息:
[quote][code]<CP2077>\red4ext\logs\FovControl.log[/code][/quote]
关键条目:
[list]
[][color=#ea9999]EnsureTarget: patch target resolved[/color] – 已找到模式,补丁位置就绪。[/]
[][color=#ea9999]Write3: failed to change page protection for patching[/color] – 操作系统拒绝了页面保护更改。[/]
[][color=#ea9999]Write3: wrote [.. .. ..] at 0x...[/color] – 写入成功(跟踪)。[/]
[][color=#ea9999]ApplyPatch: write failed[/color] – 写入被抑制(补丁被阻止)或失败。[/]
[/list]
[line]
[size=5][b]故障排除[/b][/size]
[list]
[][b]无效果 / [color=#93c47d]IsLocked()[/color] 始终为 [color=#6fa8dc]false[/color]:[/b] 检查日志:[color=#f9cb9c]EnsureTarget[/color] 是否找到了模式?空的日志意味着 [b]是的[/b](已找到模式)。[/]
[][b]写入失败:[/b] 查找 [color=#ea9999]VirtualProtect failed[/color];某些覆盖层或杀毒软件 [color=#d5a6bd]理论上[/color] 可能会造成干扰。[/]
[][b]补丁被阻止:[/b] [color=#93c47d]PreventPatching()[/color] 会阻止所有 [color=#93c47d]Lock[/color]/[color=#93c47d]Unlock[/color]/[color=#93c47d]Toggle[/color] 写入,直到调用 [color=#93c47d]ReleasePatching()[/color]。[/]
[/list]
[line]
[size=5][b]版本说明[/b][/size]
- 针对 [b]最新[/b] RED4ext 加载器和当前游戏构建。
- 扫描具有容错性,但 CP2077 中的 [b]重大代码生成变更[/b] 可能需要更新此模组。
[line]
[size=5][b]模组兼容性(CET 示例)[/b][/size]
如果你的代码中有类似片段:
[quote][code]local player = Game.GetPlayer()
if player then
local camera = player:GetFPPCameraComponent()
camera:SetFOV(69)
end[/code][/quote]
你应该大致将其改为:
[quote][code]local player = Game.GetPlayer()
if player then
local camera = player:GetFPPCameraComponent()
--确保后续 FOV 更改被应用。
if FovControl then camera:PendingSetFOV() end
camera:SetFOV(69)
end[/code][/quote]
这样模组就能可靠地确保其 [color=#93c47d]SetFOV[/color] 调用始终生效。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。