# UI Overlay

## 职责

UI 模块负责局内 HUD、状态显示和调试面板。当前只有最小 overlay。

主要源码：

- `game/src/ui/game_ui_overlay.*`

## 当前能力

`GameUiOverlay` 继承引擎 `UIScene`，通过 `SceneManager` 进入 UI scene stack。

有字体时：

- 使用 `TextSprite` 显示游戏状态。
- 显示 debug 状态、battle zone、音频、存档、PVF、NPK、AudioDB 状态。

缺字体时：

- 使用 `Renderer::drawQuad` 画 fallback 色条。
- 不因字体缺失阻断 PC/Switch 启动。

## 资源

字体候选：

```text
assets/fonts/debug.ttf
assets/fonts/ui.ttf
```

## 下一步

- 增加血量、连击、联机状态等 gameplay HUD。
- 增加 debug 面板，替代部分 F 键调试。
- 确认 Switch 字体资源进入 RomFS 后再启用正式文字 UI。