为 ACE COMBAT 8 离线单人模式提供鼠标指向飞控、独立跟随相机和方向指示。

移动鼠标指定一个世界方向，飞机通过俯仰、滚转和偏航输入尝试对准它。目标是提供类似“鼠标指向、飞机追随”的操作方式，而不是改变游戏的飞行模型。

仅供离线单人使用。不支持多人模式，也不保证与其他相机、输入或加载器模组兼容。游戏更新后，旧版本模组可能不再适用。

• 当前版本：0.2.30，性能专项第一、二阶段；最新安装包为 共存安装器 r1，游戏内代码未变。
• 目标环境：Windows x64，ACE COMBAT 8 Steam Build 25201480。
• 依赖发布包内配套的 RE-UE4SS；原生模块会校验加载器版本及游戏关键签名。
• 已完成构建与有限的协议、数学和状态模拟检查；新版性能收益及不同硬件兼容性仍需实机反馈。

本项目为非官方模组，与游戏开发商、发行商及 War Thunder 无关联。

• 鼠标指向飞行：目标方向保存在世界坐标中，飞机通过三轴输入追随目标。
• 到位制动与改平：结合机体角速度抑制过冲，在接近目标后逐渐改平。
• 独立跟随相机：相机平滑朝向目标，保留游戏原有视野角度变化。
• 方向指示：分别显示鼠标目标与实际机头方向，采用半透明标记。
• 键盘临时超控：WASDQE 对应的手动轴输入优先，不必关闭鼠标模式。
• 自由观察：按住 F 环绕观察，飞行目标不变；松开后相机平滑返回目标方向。
• 暂停处理：游戏暂停时冻结鼠标目标，恢复后将目标重新置于屏幕中心。
• 原生注视与演出让出：识别长按注视及已验证的演出相机激活状态，暂时让出相机和操控，结束后恢复。
• 可选性能统计：记录模组工作耗时和帧间隔，辅助排查卡顿。

模组修改玩家操作输入和相机视角，不修改气动、推力、武器伤害或存档数据。

1. 确认游戏版本适用，并完全退出游戏。
2. 从本仓库 Releases 下载完整发布包并解压。不要只复制 DLL 或单个脚本。
3. 如已安装旧版，建议先备份自定义 config.ini。共存安装器会保留已有配置。
4. 如已有 UE4SS，安装器会检查兼容性；兼容时复用框架，只安装本模组，未知或不兼容的安装不会被覆盖。

1. 运行解压目录中的 Install.cmd。

2. 在选择窗口中指定游戏根目录，即包含 Game 和 EasyAntiCheat 的目录。

3. 在 Steam 的游戏“属性 → 通用 → 启动选项”中设置本项目的离线启动参数：

   cmd /d /c "set EOS_USE_ANTICHEATCLIENTNULL=1&& %command% -anticheat_settings=AC8MouseAim_Offline.json"
   

   若原来有其他启动选项，请先备份，不要未经确认直接拼接。

4. 从 Steam 启动游戏，选择“专家”飞行操作，进入单人任务。

5. 建议使用无边框窗口模式。方向指示使用桌面透明覆盖层，独占全屏下可能不可见。

安装器会校验复制后的关键文件。0.2.30 需要配套的 UE4SS，不要自行替换成其他版本；校验失败时应检查安装，而不是关闭保护。

共存安装器不再一概拒绝已有 UE4SS：

兼容性按运行库校验值判断，而非仅比较版本名称；目前只自动支持 Game/Binaries/Win64/UE4SS 布局下已验证的运行库。复用模式不会修复、替换或重新启用已有加载器，原有框架必须能够正常工作。

安装前备份保存在游戏根目录的 AC8MouseAim-Backups。其他模组的启用状态及顺序保留，本模组条目合并到列表末尾；mods.json 的格式化可能变化，但其他字段和值保留。

这解决的是安装层面的共存，不保证功能层面无冲突。同时修改玩家输入、相机或相关钩子的模组仍可能互相干扰。

自由观察期间，目标保持原来的世界方向，而不是固定在屏幕坐标上；飞机仍会尝试朝该方向飞行。自由观察支持水平环绕，俯仰限制为 ±89°。

模组不会屏蔽游戏原有的 F 键绑定。如果发生冲突，请调整游戏键位。WASDQE 超控检测也使用这些固定按键。

手动注视需要持续按住约 0.35 秒才触发让出，短按切换锁定目标不会立即退出鼠标模式。该时间是模组的防误触门槛，不代表游戏内部阈值。

注视或已识别的演出期间，模组隐藏指示、冻结鼠标目标并放行原生操控和相机。结束后保留约 0.25 秒缓冲再恢复。当前已验证 ImpactCamera 激活路径，但不能保证覆盖所有剧情相机。

安装后的配置文件：

Game/Binaries/Win64/UE4SS/Mods/AC8MouseAim/config.ini

最常用的设置是鼠标灵敏度：

[control]
sensitivity=0.10

数值越大，移动相同鼠标距离时目标转动越快。修改后可按 F10 重新加载。

配置中部分 gain、damping 等字段为历史兼容项，并不用于调整当前控制器。请不要把所有字段都当作有效的手感参数。轴符号和输入槽位属于版本适配设置，正常情况下不应修改。

• 用进程内数字接口替换实时文本管道和相机目标文件。
• 同帧传递姿态与目标，不积压过期帧。
• 原生日志由后台线程写盘，使用有容量限制的队列；繁忙时丢弃诊断信息，而不是等待写盘。
• 输入钩子提前排除非玩家调用，减少重复键盘查询。
• 复用逐帧脚本中的部分读取和转换结果。

没有降低指示层刷新率，也没有改变其绘制方式。 飞控参数、相机位置及平滑参数保持不变；通信延迟减少后，响应可能比旧版更及时。

这些改动针对模组自身的开销，不保证消除游戏资源加载、GPU 瓶颈或其他软件造成的全部卡顿。

1. 进入容易复现问题的任务，按 F5 开始统计。
2. 正常游玩，经过一次明显卡顿或敌人刷新事件。
3. 再按 F5 结束统计，提供最新的 MouseAim-xxxxx.log。

统计约每 10 秒汇总，关闭时补报剩余数据。不需要同时开启 F6；F6 是更详细的相机状态采集，会产生额外文件操作。

日志位置：

Game/Binaries/Win64/UE4SS/Mods/AC8MouseAim/Logs/MouseAim-xxxxx.log
Game/Binaries/Win64/UE4SS/UE4SS.log

提交 Issue 时建议附上：

• 模组版本、游戏版本。
• CPU、GPU、内存、游戏所在存储设备类型。
• 分辨率、显示模式，以及是否使用其他模组。
• 具体任务和触发情况：持续掉帧、单位刷新卡顿，还是相机/标记视觉顿挫。
• 相关日志；如已有未加载模组时的对照结果，也请说明。

script_wall 包含 native_bridge，两者不能相加；frame_gap 包含游戏其他工作，不等同于模组耗时。统计不测量 GPU 时间，也不能单独证明卡顿原因。

F8 只停止鼠标辅助，不会卸载模组。关闭 F8 不能作为“完全原版”的性能基线。

• 游戏更新后失效：本项目包含版本相关的输入与相机适配。请先禁用模组，等待对应版本支持。
• 看不到方向指示：检查 F7 状态，并尝试无边框窗口模式。剧情注视或暂停时隐藏标记是预期行为。
• 启动失败、黑屏或崩溃：退出游戏，先禁用加载器恢复原版；反馈游戏版本和日志，不要混用不同发布包的文件。
• 部分演出未正确让出：当前状态检测并非覆盖所有演出。请说明任务和触发位置，再按需采集 F6 记录。
• 其他模组冲突：尤其是输入、相机、覆盖层和共用 UE4SS 的模组，不保证兼容。
• 新版性能待验证：自动检查不等于实机兼容性或性能验收，欢迎提供可复现反馈。

退出游戏，在游戏根目录运行 Disable-Mod-For-Multiplayer.cmd。脚本会先确认，再停用 dwmapi.dll 加载器入口；这会影响共用它的所有模组。脚本不会修改 Steam 启动选项，也不会处理所有其他类型的加载器。

若要恢复正常启动，请同时移除本项目的离线启动参数，恢复原来的启动配置。进入多人模式前务必退出游戏并完成停用；F8 不能代替这一步。项目不提供任何联网兼容性或账号安全保证。

退出游戏后重新安装上一版本的完整发布包。建议保留 0.2.29 安装包，作为性能专项版的回退选择。

退出游戏，在游戏根目录运行 Uninstall-AC8-Mouse-Aim.cmd，并手动移除 Steam 中本项目的离线启动参数。

共存安装器附带的卸载脚本只移走本模组及其辅助文件、移除本模组启用项，保留共用加载器、UE4SS、设置和其他模组。移走的文件可从 AC8MouseAim-Backups 恢复。

卸载本模组不等于禁用所有模组。 其他模组仍可能加载，进入多人模式前需要单独确认。旧版安装包中的卸载脚本没有这一共存保护，请使用新版脚本。

主要组成：

src/                  原生输入处理、飞控、相机修正、指示层及诊断
mod/AC8MouseAim/       Lua 脚本与配置
package/              安装、启动和卸载脚本
build.cmd             构建 Windows x64 原生 DLL
check.cmd             飞控与自由观察数学检查
check_lua.cmd         Lua 语法及相机数学检查

构建需要 Visual Studio 2022 的 MSVC x64 C++ 工具链及 Windows SDK。当前脚本还依赖与发布包匹配的 RE-UE4SS 源码，放在项目的同级 ue4ss-source 目录；并非仅克隆本项目即可无依赖构建。

在项目目录运行：

build.cmd

构建产物为 build/ac8_mouse_aim_010.dll，并复制到模组脚本目录。DLL 文件名保留历史命名，不代表发布版本。

0.2.30 通过配套 UE4SS 导出的 LuaMadeSimple 接口交换数值，不直接操作 Lua 虚拟机内部结构。原生相机仍在游戏相机更新后进行修正，保留版本、对象和数据时效检查。

请勿通过移除校验来适配未知游戏或加载器版本。修改飞控或相机时，应尽量保留已经稳定的更新时序，并只安排与改动范围相关的验证。

• RE-UE4SS：模组加载、Lua 运行环境和接口，MIT 许可。
• MinHook：原生函数钩子，BSD 2-Clause 许可。

项目原创代码的许可声明见 LICENSE.txt。参考代码和第三方组件保留各自许可证，请同时保留发布包中的许可文件及 THIRD_PARTY_NOTICES.txt。

本项目不包含游戏资产或游戏可执行文件。