武昌摄像机 - 可调变焦和视场角

[size=4][b]描述[/b][/size]
[size=3][color=#D4D4D8]描述你的 Mod 的主要用途[/color][/size]

[size=4][b]安装说明[/b][/size]
[size=3][color=#D4D4D8]列出用户安装你的 Mod 时必须遵循的所有步骤[/color][/size]

[size=4][b]主要功能[/b][/size]
镜头缩放与 FOV

[size=4][b]前置要求[/b][/size]
[color=#D4D4D8]UE4SS

WuchangCamera v1.0 — 明末：渊虚之羽 镜头距离与 FOV 调节 Mod
================================================================

一、功能
通过键盘调节第三人称镜头距离和视野角度（FOV）。
支持恢复原版镜头、临时关闭，以及自动记住上次设置。
本包为当前用户已确认恢复正常的版本，采用游戏镜头配置修改方式。

二、前置要求
需要游戏已安装并能正常运行 UE4SS。本压缩包不包含 UE4SS 加载器。
已在制作时的本机游戏与 UE4SS 环境中使用；其他游戏更新版本需自行验证兼容性。
无需安装其他镜头 Mod。

三、安装
1. 完全退出游戏。
2. 打开本压缩包，将其中的 Project_Plague 文件夹解压到游戏根目录，
  即包含 Project_Plague.exe 的文件夹；合并同名文件夹。
3. 安装完成后，应能找到：
  游戏根目录\Project_Plague\Binaries\Win64\ue4ss\Mods\WuchangCamera\Scripts\main.lua
4. 启动游戏，进入存档后使用下列按键。

包内自带 enabled.txt，用于启用本 Mod；无需覆盖其他 Mod 的 mods.txt。
如果你曾在 mods.txt 中手动将 WuchangCamera 禁用，请将对应项改为启用。
也可以只把包内的 WuchangCamera 文件夹复制到现有 UE4SS 的 Mods 目录。

四、默认按键
Page Up      拉近镜头，每次减少原版距离的 5 个百分点
Page Down    拉远镜头，每次增加原版距离的 5 个百分点
Ctrl + ↑      减小 FOV，每次 2 度，人物看起来更大
Ctrl + ↓      增大 FOV，每次 2 度，显示更多周围环境
Home          恢复原版距离，并解除 FOV 覆盖
End          关闭／开启 Mod，保留当前自定义参数

关闭后按任一调节键也会重新开启 Mod。
Home 恢复后的参数同样会保存；之后按 Page Up 可重新拉近。
无需数字小键盘，部分笔记本需用 Fn 组合键输入 Page Up / Page Down。
本版使用按键控制，未绑定鼠标滚轮。

五、初始设置与范围
首次安装默认镜头距离：原版的 80%。
首次安装默认 FOV：跟随游戏，不强制覆盖。
距离范围：原版的 40%～160%。
FOV 范围：40～140 度。
调节键在正常游玩时生效；菜单或暂停中不调节距离/FOV，Home 和 End 仍可使用。

六、自定义与设置保存
Mod 目录中的 config.lua 可修改按键、步长、范围和首次默认距离。
修改文件前请退出游戏，修改后重新启动。
StableFollow 默认 false，保留游戏原有跟随行为。

实际使用后的参数自动保存在 Mod 目录下的 settings.ini，约 250 毫秒内合并保存。
FOV=0 表示跟随游戏的 FOV。
已有 settings.ini 中的当前参数优先于 config.lua 的首次默认值。
本包不携带制作者的个人 settings.ini，因此不会把个人镜头偏好带给其他玩家。
覆盖更新时，你已有的 settings.ini 会保留。需要恢复时可直接按 Home。

七、性能与实现
不使用高频原生镜头拦截，不关闭游戏碰撞检测。
已移除调试轮询，缓存玩家控制器，只在参数变化或角色重建时写入距离配置。
保存操作已合并；达到调节极限后继续按键不会重复应用或写盘。
End 关闭后不再定时访问游戏对象。
本 Mod 不修改游戏存档、原始 pak、画质设置或其他 Mod。

八、停用与卸载
临时停用：游戏内按 End。
永久停用：退出游戏，将 WuchangCamera 文件夹内 enabled.txt 改名为 enabled.off。
          如果你另外在 mods.txt 中启用了本 Mod，也应将对应项关闭。
彻底卸载：退出游戏，删除 UE4SS Mods 目录中的 WuchangCamera 文件夹。
无需删除或替换其他 Mod 文件。

九、常见问题
按键无效：确认 UE4SS 已加载、目录没有多套一层、已进入存档，且按键未被其他 Mod 占用。
          占用记录可在 UE4SS.log 中搜索 [WuchangCamera] 或 binding skipped。
人物过近或视野不习惯：按 Page Down 拉远，或按 Home 恢复。
帧数异常：在同一位置和朝向按 Home 比较原版镜头；按 End 可以关闭本 Mod 进行排查。
参数未保存：确认游戏目录可写，并在调节后稍等片刻再退出。
状态信息：Mod 目录中的 status.txt 和 UE4SS.log 中的 [WuchangCamera] 记录。

十、压缩包内容
Project_Plague\...\Mods\WuchangCamera\
  config.lua
  enabled.txt
  Scripts\main.lua
  Scripts\camera.lua
  使用说明.txt
以及压缩包根目录的 安装与使用说明.txt。
不包含调试脚本、运行日志、个人设置、存档或 UE4SS 二进制文件。[/color]
[color=#D4D4D8]不包含调试脚本、[/color]