# J-20-A-and-C 增强包 2025.08发布说明
## 🛠️功能修复
* 机炮不再一次性打完（2025.07中引入的bug）
* 昼夜模式中头盔显示部分对象不再消失
* 背光灯和泛光灯旋钮已更正位置
* 修复 HUD 姿态刻度溢出显示范围的问题（采用单独 page 和层的裁切修复）
---
## 🚀新增功能
### 🎮通用按键绑定
* 机炮模式开关、机炮模式按钮、机炮模式开、机炮模式关
* 昼夜模式开关、昼夜模式开、夜晚模式关
* 主武器开关、主武器开、主武器关
* 背光和泛光按键绑定
* UFCP On（全亮）、UFCP Off（全暗）
* HUD On（全亮）、HUD Off（全暗）、HUD 亮度轴
* MFCD 亮度旋钮
---
### 🤖自动化
* 热机出生时，如任务起始时间18:00~6:00
  * 自动打开背光灯和泛光灯
  * 自动切换夜间模式按钮
  * 自动头盔亮度到低亮
---
### 🪖头盔显示（HMD）
#### 📶RWR 信号投影
* 三种状态图标  
  * 搜索：紫色方框  
  * 锁定：45° 旋转红色方框内嵌于搜索框  
  * 发射：红色圆环包围锁定框  
* 信号源识别文字位于图标上方，状态文字位于下方  
* 发射状态下图标与文字闪烁
* 右侧垂直 5 段式白色信号功率条
* 可显示头盔背面 180° RWR 信号源，并用黄色“背面”标识  
* 对 RWR 高优先级前 5 个目标进行方块着色（RWR不区分敌我）  
#### 🧠聚类与抗干扰
* acmLock 和 BVR 锁定改用聚类目标  
* 将雷达目标替换为过滤排序后的聚类目标，提升抗干扰能力及性能  
#### 🧭态势感知
* 显示目标的相对航向与地速  
* 态势目标仅连线至最近 5 个  
* 背向目标显示时加“背面”标记  
#### 📍导航点显示
* 导航模式下区分转向点与降落点  
* 对地模式下区分转向点与攻击点  
* 导航点背向显示时添加“背面”标记  
#### 🎯锁定交互与动效
* 候选锁定目标的 NCTR 文本在范围内变为白色以提示  
* BVR 模式下可通过头盔指向选择待锁定目标，并使用 TMS 向下键执行锁定  
---
### 🧑‍💻HUD
* 使用归一化角度算法消除导航点跳变  
* 优化布局，提升可读性和一致性  
---
### 📡雷达系统
* 增强目标回波预处理限制值，进一步提升 ECM 抗干扰及系统性能  
* 大范围重构雷达设备代码（特别是头盔目标与 acmLock 过程），实现各种姿态下的精准锁定  
* Roll 机动优化：即使达到 90° 以上，MFD 锁定与头盔雷达指向亦能正确反映  
---
### 💣武器系统
* 支持搭载 CM-102A 反辐射导弹  (感谢 B站：麻辣兔兔柚 提供武器包)
* 更新武器发射逻辑 可以人工发射CM-102A 
* 更新 MFD 等武器显示布局，以集成 CM-102A
* Top条仅显示弹数大于0的武器挂载项目
* 更新挂架优选规则，优先选中外部挂架
* 修复导弹的negtive drag和negtive weight
---
## 🧪开发调试增强
* `utils.lua` 增加无干预获取命令名函数 `Get_command_name`  
* `utils.lua` 新增角度归一化算法 `Normalize_angle`  

## ⚠️ 已知问题和解决方案
* 使用VR设备时，对象过多导致静默渲染崩溃
  - 默认停用MFD EADI页面的速度、高度刻度条边上的数字，EHSI上的刻度条、机场标记等对象
  - 在不使用VR设备时，可以通过副屏幕设定选项中的模式选项切换：VR/非VR，以重新启用EADI条上的数字和EHSI上的刻度条、机场标记等
  - 注意：使用时VR设备，请自行判断是否尝试打开此设置
* 当前MP3列表引用了并不存在的歌曲列表导致log中报错
  - 已通过新增机体编辑器选项"Enable MP3Player" 将MP3播放器作为可选特性，默认为不选中
* 飞机选项“Enable NGV”实际并不会起作用
  - 当前飞机已具有微光夜视仪，已移除此选项


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

# J-20-A-and-C 增强包 2025.07

## 🔧 系统功能优化

* **FLIR显示修正**
  J-20C机型现已正确显示FLIR页面。

* **广角WACQ模式增强**
  扫描距离提升至 20 海里，主屏幕 P3 的广角与长孔径模式距离动效已根据各自扫描范围完成更新。

* **头盔 IR 锁定环修复**
  WeaponSystem 代码修复后，头盔上可正确显示 IR 锁定内环及锁定后的动效。

## 🎮 显示与交互界面更新

* **辅助屏幕稳定性优化**
  从 AA 和 AG 模式退出后，副屏幕将自动返回主菜单，避免在 VR 模式下的潜在崩溃问题。

* **新增 VR/非 VR 显示模式选项**
  在副屏幕设置页面新增选项，可通过 OSB6 切换 VR/非 VR 模式。默认设定为 VR 模式以简化 P3 显示对象并增强稳定性。
  在非 VR 模式下，主屏幕 P3 可显示更多导航信息，如方向刻度、机场位置、飞行计划与航路点。
  **注意：请勿在 VR 模式下启用非 VR 参数。**

* **雷达目标处理能力增强**
  系统现已支持超过 15 个目标的雷达处理。

## ⚔️ 武器系统升级

* **任务编辑器挂载页面调整**
  舱口状态改为开启，PL-17 在挂载状态下替换为 PL-15 模型以避免穿模，导弹发射后恢复为正常的 PL-17 模型。

* **切换武器逻辑优化**
  切换武器时将自动跳过空挂架与无效导弹型号，提高缠斗时的效率。
  **注意：当前弹种耗尽后仍需手动切换至其他型号。**

* **DLZ 与 TOF 解算实现**

  * **TOF 显示**：在主显示器 MFD 的 Top 页面可追踪最多 6 枚已发射导弹的 TOF 倒计时。HUD 与头盔采用表盘式同心圆布局：指针逆时针旋转，末段为红色（暂设 30°），表盘 300° 对应 150 秒。倒数归零后指针复位并隐藏。
  * **DLZ 显示**：STT 锁定后，在 HUD 与头盔显示锁定框外的圆点表示目标距离，圆点沿框体逆时针移动：
    * 顶边：最大射程至动态最大射程之间
    * 左边：动态最大射程至动态最佳射程之间
    * 底边：动态最佳射程至动态最小射程之间
    * 右边：动态最小射程至武器最小射程之间
      当目标位于视角之外时，HUD 中间将显示锁定框及信息，目标进入视野后自动隐藏。

## 👁 HUD 与头盔显示增强

* **主武器保险状态显示（Master Arm - SAFE）**
  HUD 与头盔现可显示主武器保险开关（Master Arm）处于 SAFE 状态的提示信息。

* **HUD 新增信息项**
  增加真空速、垂直爬升率的显示内容。

* **STT 锁定逻辑与布局优化**
  HUD 与头盔上的 STT 锁定信息布局与逻辑已重新调整，更加清晰。

* **HUD 显示角度校准**
  HUD 角度范围已校准，实现头盔与 HUD 显示的无缝衔接，目标相对航向与机体攻角信息可准确展现。

* **垂直扫描 VACQ 模式更新**
  垂直扫描 VACQ 模式范围更新为 8° × 90°。

## 🛠️ Debug 层优化

* **头盔调试信息优化**
  头盔显示中的 debug 信息已移至单独的页层文件，显示与输出由 [`utils.lua`](https://utils.lua) 中的全局变量 `Render_debug_info` 控制。

* **HUD 调试信息优化**
  HUD 相关的调试显示逻辑已同步重构，与头盔调试逻辑保持一致，统一由 `Render_debug_info` 管理。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

# J-20-A-and-C 增强包 2025.06 发布

## 🛫 舱盖与视角优化

* **舱盖升级**：更换为透明且清晰度极高的新型设计。
* **默认视角调整**：默认视角回归中央，为飞行员提供更自然的起始观看视角。

## 🎨 材质与输入绑定优化

* **材质文件替换**：更新为含有 alpha 通道的版本，提升性能并消除日志警告信息。
* **输入绑定增强**：修复并优化多个按键与轴的绑定问题，使摇杆和油门杆绑定更顺畅。具体请在游戏内查阅绑定。

## 🧩 模型与函数增强

* **模型参数调整**：部分参数参考 F-22 版本，效果待进一步验证。
* **四元数计算函数新增**：新增一系列四元数相关函数，提升空间计算精度与便捷性。
* **调试输出函数新增**：新增 Log_and_print 函数，便于调试信息输出。
* **额外句柄支持**：增加大量新句柄，提升系统扩展能力。

## 💣 武器挂载增强

* **PL-17 集成**：新增单发版本及虚构 4 发弹舱版，支持玩家发射。
* **PL-15 更新**：新增虚构 2 发弹舱版本，支持玩家使用。
* **PL-10E 更新**：新增虚构 4 发弹舱版本，支持玩家使用。
* **主军械独立绑定**：Arm/Safe 按钮可独立绑定，操作更灵活。
* **显示改进**：主显示器顶部页面显示 PL-17 数量；P4 屏幕新增机炮与弹药显示；HUD、HMD 与 MFD 显示弹量信息。

## 📡 雷达系统重构与增强

* **ACM 锁定功能重写**：除 WACQ 模式外，所有雷达进入增稳模式，避免因姿态变化导致的随机俯仰或滚转。
* **跟踪改进**：锁定过程中更准确地跟随飞机姿态变化。
* **自动锁定优化**：基于最近距离目标进行自动锁定，提升效率。
* **锁定速度提升**：典型锁定时间缩短至 0.4-0.8 秒。
* **新增 HACQ 模式**：DMS 向下长按启用，扫描范围 50 海里，水平宽度 120°，垂直宽度 10°。
* **BST 模式长孔径调整**：DMS 向上长按触发，水平与垂直均为 5°。

## 🖥️ MFD 雷达与 EHSI 显示增强

* **BVR 与 ACM 模式显示优化**：雷达页面显示不同 ACM 模式下的扫描宽度，波束扫动效果根据实际范围调整。
* **单位切换校正**：英制与公制切换时，雷达距离比例显示准确。
* **BST 模式显示优化**：波束与头盔跟随效果更真实。
* **锁定后显示优化**：目标颜色标示、距离比例、十字准星与波束跟随效果均正确展示；自动切换最合适的雷达显示比例；EHSI 显示目标 NCTR 数值。

## 🪖 头盔功能强化

* **目标显示增强**：根据雷达扫描结果显示目标，敌方红色、未知黄色、友方绿色。显示效果更真实。
* **目标过滤与聚类显示**：新增基于时间过滤与距离聚类的目标显示方式，以蓝色边框标示。
* **BST 模式瞄准修正**：修复使用头盔进行目标瞄准时的问题。

## 🎯 HUD 显示改进

* **头盔效果延伸至 HUD**：几乎所有头盔增强效果同步至 HUD。
* **文本布局与字体调整**：重新设计文本位置与字体大小，提升可读性。
* **动态准星显示**：空对空内置机炮动态准星准确展现。
* **HACQ 模式参考线**：表现为两条间隔 10° 的水平线。
* **HUD 角度校准**：实现头盔与 HUD 间无缝衔接，准确显示攻角与相对航向信息。

## ✈️ J-20A 更新内容

* **内置机炮新增**：J-20A 型机新增内置机炮功能。

## ⛔ 停用功能

* **简化主屏幕 EHSI 显示**：不再显示机场与详细方位刻度，解决 VR 模式下进入机舱时 DCS 无日志告警后崩溃的问题。

## ⚠️ 已知问题

* **辅助屏幕崩溃问题**：VR 模式下切换辅助屏幕 EHSI 页面前需退出巡航模式，否则可能崩溃。
* **目标数量性能问题**：目标超过 15 个时，雷达与相关功能可能无法正常工作，原因待查。