# 机甲部位血量 HUD v1.11.1

驾驶外骨骼机甲时，在屏幕右下角（靠近中间）显示一块简洁的机甲状态面板：

- **机体结构血条**：顶部详细血条，显示百分比与当前 / 最大值，每 10% 一格刻度。
- **部位血量**：机甲轮廓图上直接标出每个部位的血量百分比——驾驶舱左前 / 右前、驾驶舱后部、髋关节、左腿、右腿。
- **武器臂血量**：左右武器臂各自显示血量，打爆后标记“损毁”。
- **状态颜色**：浅灰 = 完好（>75%），黄 ≤75%，橙 ≤50%，红 ≤25% 并闪烁；部位被打爆显示暗红“损毁”；暂时读不到显示 `--`。
- **多人同场也能用**：附近有队友机甲时，会自动判断哪两条手臂装在你自己驾驶的机甲上，只显示你自己的武器臂血量；两台机甲真正贴在一起、无法可靠区分时，手臂暂时隐藏，绝不会把队友的血量显示成你的。
- **高清中文字体**：抗锯齿字形，1x / 1.5x / 2x 缩放下都清晰。

## 支持的机甲

| 机甲 | 左臂 | 右臂 |
|---|---|---|
| EXO-45 爱国者 | 火箭臂 | 机枪臂 |
| EXO-49 解放者 | 左机炮 | 右机炮 |
| EXO-51 伐木者 | 喷火臂 | 反坦克炮 |
| EXO-55 突破 | 护盾臂 | 霰弹枪臂 |

| 部位 | 满血 |
|---|---|
| 机体结构 | 1800 |
| 驾驶舱左前 / 右前 / 后部 | 各 400 |
| 髋关节 | 400 |
| 左腿 / 右腿 | 各 550 |
| 左 / 右武器臂 | 各 800 |

左右以驾驶员视角为准：屏幕左侧 = 机甲左侧。

## 安装

1. **完全退出游戏。**
2. 在模组管理器中**停用并删除所有旧版“机甲部位血量HUD”**（包括 v1.x 与各测试版 t1–t7 / d1–d4），只保留本版本。
3. 导入本 ZIP，启用选项 “机甲部位血量 HUD”。
4. 前置：**Bingus Shared Loader**（本包不附带），保持其原有加载顺序。
5. 可与 DRIVER HUD 等其它模组同时启用。
6. 部署后启动游戏，坐进机甲即可看到面板。

## 多人使用说明

- 进入任务后，第一次上机时需要几秒钟建立识别，之后近距离并排、面对面、转身都能正常显示自己的双臂。
- 通过“位置匹配”确定的手臂，旁边会显示一个小的黄色 `≈` 标记，表示这是按武器挂点位置自动识别的结果。
- 换座后面板会自动切换到新驾驶的机甲；下机步行时面板隐藏。
- 两台机甲完全重叠、或游戏数据暂时不稳定时，手臂会短暂隐藏，稍后自动恢复。

## 设置（可选）

把包内的 `mech_hud.cfg.example` 复制为：

```
%APPDATA%\Arrowhead\Helldivers2\mech_hud.cfg
```

修改后重启游戏生效。常用项：

| 选项 | 默认 | 说明 |
|---|---|---|
| `right` / `bottom` | 0.27 / 0.035 | 面板离屏幕右边 / 下边的距离（占屏幕比例） |
| `scale` | 1 | 缩放，0.5 ~ 2.5 |
| `alpha` | 0.9 | 整体不透明度，0.1 ~ 1 |
| `plate` | 0.28 | 底板不透明度，0 = 不要底板 |
| `debug` | false | 改为 true 时写日志 `mech_hud.log` 及诊断文件，用于反馈问题 |

多人识别相关的 `spatial` / `tagged_ref` / `mount_match` 默认均为 true，一般不需要改动。

## 安全与兼容

- **完全只读**：不修改血量、护甲、弹药或任何游戏数值；不注入线程、不改内存权限、不调用任何会改变游戏状态的接口。
- 游戏更新后，HUD 启动时核对读取所依赖的关键游戏代码与数据布局：布局未变就继续工作，不再因为程序版本号变化而停用；关键代码有任何变化才自动停用，不会读错数据。
- 遇到无法确认的部位或手臂时一律不显示，不会乱标。

## 遇到问题

在 `mech_hud.cfg` 中设置 `debug=true`，重启游戏复现问题，然后提供 `%APPDATA%\Arrowhead\Helldivers2\` 下的 `mech_hud.log` 与 `mech_hud_spatial_*.json`。

## 更新记录

- **v1.11.1** — 适配 2026-09-24 游戏更新（Steam build 25480438）。版本校验由“文件身份完全一致”改为“关键代码与布局匹配”，参照 DRIVER HUD 1.4.5 的做法；读取偏移和 14 处代码校验与 DRIVER HUD 1.4.5 逐字节一致。功能、界面不变。
- v1.11.0 — 正式版。多人同场时按机体位置与武器挂点识别自己的武器臂，近距离也能显示；换座自动切换。默认关闭调试日志。
- v1.10.0 — 高清抗锯齿中文字体；收录突破霰弹枪臂。
- v1.9.0 — 修正武器臂血量；损毁标记；面板移至右下角。
- v1.6 – v1.8 — 极简轮廓机甲图标，部位百分比直接标在图上。
- v1.0 – v1.5 — 首个版本及界面迭代。

## 致谢与许可

原生只读读取器改编自 FireScallion 的 DRIVER HUD 1.3.5（MIT），见 `LICENSE-DRIVER-HUD.txt` 与 `CREDITS.md`。不包含 DRIVER HUD / HUD+ 的材质、字体或图标。中文字形由 Noto Sans CJK SC（SIL OFL 1.1）预先栅格化，不包含字体文件。武器挂点等组件数据来源见 `CREDITS.md`。

源码与离线测试在 `Source/`，构建方法：`python tools/build.py`，测试入口位于 `Source/tests/`（需要 Python + lupa）。