带真实Betaflight的FPV无人机 - 增强版

[size=4][b]描述：[/b][/size]
[color=#D4D4D8]这是将 hammerill 的 gtaiv-fpv（GTA IV）移植到 GTA V Enhanced 的版本。

预告片：https://youtu.be/C_lgsiII5-w

[b]主要功能：[/b]
- 真实 Betaflight 2026.6 在环：你的 rates、模式、PID 和 OSD 布局。导入你真实四轴的 "diff all"。
- 通过 USB 连接你的遥控器（EdgeTX、OpenTX、FrSky 模拟器狗等）、手柄或键盘。设置向导会映射摇杆和开关。
- 真实比例的无人机模型：一架 5" 花飞四轴，其桨叶随电机转动（损坏的桨叶会消失），以及用于 3" 四轴和 whoop 的 DJI Avata 2。四轴预设会选择模型，甚至可在飞行中切换。
- 飞手整装待发：玩家头上戴着 FPV 眼镜（黑色、灰色、白色、红色、蓝色或绿色），手中握着 RadioMaster TX12，有四种握持姿势，包括 Arena War 的无人机控制器。飞行时帽子和眼镜会摘下，之后会重新戴上。
- 三种摄像机：FPV 眼镜视角、追尾（可调距离、高度和跟随）、以及从玩家视角的视线视角。
- 两种风格的 Betaflight OSD：模拟 30x16，或 DJI 风格高清 53x20 画布，各自拥有独立的元素布局。自定义启动 logo。
- 眼镜字体：放入你眼镜 SD 卡中的字体（DJI O3 SNEAKY_FPV 字体表或 WTFOS 字体）。
- 眼镜视角：鱼眼镜头、画面周围的眼镜边框、眼镜 HUD（信号格、计时器、录制红点），以及每种风格的视频观感。模拟风格会有雪花和撕裂线条，数字风格会有块状和冻结。
- 眼镜视角中的摇杆叠加层，如同 FPV 视频中那样。
- 无线电信号：RSSI 和 RSSI dBm 会随着距起飞点的距离以及被建筑物遮挡而下降。
- GPS：速度、高度、返航箭头和距离。返航点是你解锁的地方，如同真实四轴。
- 检查点竞速：在飞行中用遥控器上的开关录制门。在你于标签页中设置的圈数下飞圈，或飞向终点门的点到点冲刺，屏幕上计时。
- 分享你的赛道：在标签页中将赛道复制为文本，并粘贴朋友发给你的赛道。你的个人最佳成绩按赛道保存，你的最佳圈会作为半透明幽灵一同飞行以供竞速。
- 与建筑物、道路、车辆、行人和道具碰撞。猛烈撞击会撞倒行人并在车辆上留下凹痕，并弯曲你的桨叶，直到你上锁并更换它们。
- 电机声音，且飞行时游戏内电台会继续播放。
- FPV DVR：无人机解锁时 NVIDIA ShadowPlay 会自动录制。
- 眼镜视角设置（边框开/关、边框大小、FOV、视频信号观感）可直接在 ReShade 的效果面板中调整，并带有重置按钮。
- ReShade 中 GTAVE.FPV 标签页里的飞行选项：完全真实（弯曲的桨叶保持弯曲）、解锁时修复、每次解锁时新的 GPS 返航点，以及飞手装备的贴合度。[/color]

[size=4][b]安装说明：[/b][/size]
[color=#D4D4D8]1. 将 ZIP 中的所有内容复制到游戏文件夹，与 GTA5_Enhanced.exe 同级。保留 reshade-shaders 文件夹。
2. 模型位于 dlcpacks\gtavefpv 文件夹。两种情况下都要添加的行：<Item>dlcpacks:/gtavefpv/</Item> 放在 </Paths> 之前。
- 使用 onigiri（推荐，NVE 已安装它）：将文件夹放入 onigiri\dlcpacks，并将该行添加到 onigiri\common\data\dlclist.xml。
- 使用 OpenRPF 或 RageOpenV（未测试）：将文件夹放入 mods\update\x64\dlcpacks，并将该行添加到 mods\update\update.rpf\common\data\dlclist.xml。先备份该归档文件，并且只编辑其中的那个文件。重建 update.rpf 会导致其他附加包出错。
3. 启动游戏，按 Home，开启 "GTAVE.FPV lens" 效果并将其移到列表末尾。保持开启：它只会在 FPV 视角中显示。
4. 按 F9 启动。打开 ReShade 中的 GTAVE.FPV 标签页，并运行一次无线电设置向导。[/color]

[b]操作：[/b]
- F9：启动无人机 / 返回玩家
- C：切换摄像机（FPV、追尾、视线）
- R：重生无人机，已修复
- Y：将玩家移动到无人机处
- O：OSD 风格，模拟或高清
- G：眼镜边框开/关
- P：在无人机所在位置换新螺旋桨（弯曲的桨叶在解锁时也会自动更换）
- , 和 .：电台
- N / M / U / L：竞速（录制或保存、标记门、撤销、下一场比赛）。你遥控器的 AUX3 开关也可标记门。
- E：标记终点门并保存点到点竞速
- 没有遥控器？Enter 解锁，W/S 油门，A/D 偏航，方向键俯仰和横滚。

[b][size=4]要求：[/size][/b]
[color=#D4D4D8]- GTA V Enhanced（故事模式）。
- 支持 Enhanced 的 ScriptHookV，包括其 ASI 加载器（dinput8.dll）。
- ReShade 6.x "with full add-on support"，DirectX 12。
- 可选：onigiri（随 NVE 提供）或 OpenRPF，用于加载包含无人机、眼镜和遥控器模型的附加 dlcpack。没有它，模组会使用游戏道具作为无人机。
- 可选：处于 USB 手柄模式的 FPV 遥控器，以及用于 DVR 的 NVIDIA 应用。

*所有测试均在安装 RenoDX DLSS 5 模组和 NaturalVision Enhanced（NVE）的情况下完成，本页面的每张截图和视频也都是用它们拍摄的。两者都不是必需的：模组在没有它们的情况下也能运行；游戏只是看起来像原版 GTA V Enhanced。[/color]

[color=#D4D4D8][b]提示：[/b]
- 飞行时关闭 DLSS 帧生成。它会增加输入延迟。
- 没有 OSD？检查你的 OSD 禁用开关：开启时，Betaflight 不绘制 OSD，眼镜 HUD 也会隐藏（便于拍摄干净画面）。
- Betaflight Configurator：启动无人机，启用手动连接模式，连接到 ws://localhost:5761。
- 眼镜字体放入 %APPDATA%\libfpv\fonts，每个字体一个文件夹。在 OSD 页面选择它们。

[b]已知问题：[/b]
- 板条栅栏和栏杆会作为实心面板碰撞，或者根本不碰撞。GTA 的碰撞在板条之间没有间隙。
- 遥控器是真实 TX12 的尺寸，因此在某些握持姿势中，手的位置会比遥控器稍近或稍宽。
- Rockstar Editor 无法录制 FPV 摄像机。请改用 DVR（ShadowPlay）。

[b]源码和许可证：[/b]
GPL-3.0-or-later。源码：https://github.com/bwcon/gtave-fpv 和 https://github.com/bwcon/libfpv[/color]

[size=4][b]致谢与鸣谢：[/b][/size]
[color=#D4D4D8]- hammerill：libfpv 和 gtaiv-fpv，本模组基于它们构建
- Betaflight 团队，以及 SimITL
- Alexander Blade：ScriptHookV
- crosire：ReShade
- Omar Cornut：Dear ImGui。Sean Barrett：stb_image。Sollumz 团队：用于转换模型的 Blender 工具。
- 5" 四轴（"Neon Falcon"）及其螺旋桨：由 bwcon 使用 Meshy AI 制作。
- 3" 和 whoop 模型："DJI Avata2"，作者 raphael.harris.gaffga，CC BY 4.0（https://sketchfab.com/3d-models/dji-avata2-e27ed758e2174a89a48368e84027f8d9），已精简并转换为 GTA V 格式。
- 眼镜模型："Tripo FPV DJI Goggles"，作者 line-o，CC BY 4.0（https://sketchfab.com/3d-models/tripo-fpv-dji-goggles-9edb8544e5ba4cd1985fd997d366b260），已精简并转换为 GTA V 格式。
- 遥控器模型："Radiomaster TX12 rc radio controller"，作者 flightclubua，CC BY 4.0（https://sketchfab.com/3d-models/radiomaster-tx12-rc-radio-controller-0edc6bca739d4aa6952bb6b8747318bb），已精简并转换为 GTA V 格式。
- DJI、Avata 和 RadioMaster 是其所有者的商标；本模组与它们无关联。
- 由 bwcon 移植到 GTA V Enhanced，与 Claude（Anthropic）共同编写[/color]