Document controls and input mapping

This commit is contained in:
2026-06-09 15:30:33 +08:00
parent 3a19005bbf
commit 61249e2a29
4 changed files with 62 additions and 20 deletions
@@ -155,9 +155,9 @@ mindmap
当前输入映射:
- 移动:键盘 `A/D`、方向键、手柄左摇杆、方向键、Switch 左摇杆/方向键
- 跳跃:键盘 `Space/W/Up`、手柄 `A/B`Switch `A/B`
- 攻击:键盘 `J/K`、手柄 `X/Y`、Switch `X/Y`
- 详见 `../controls.md`
- 当前已覆盖 PC 键盘、SDL GameController 和 Switch `PadState`
- 角色逻辑只消费 `InputState`,不直接读取平台输入 API
下一步:
@@ -178,7 +178,7 @@ mindmap
- `scene/whitebox_scene.*`
- `scene/camera_controller.*`:玩家跟随、dead zone、平滑和世界边界 clamp。
- `CameraZoneLock`:玩家进入 battle zone 后摄像机平滑切换到 zone camera bounds,可移动锁定范围会防御性保证不小于视口,当前`F2` 或离开 zone 做 debug 清场解锁。
- `CameraZoneLock`:玩家进入 battle zone 后摄像机平滑切换到 zone camera bounds,可移动锁定范围会防御性保证不小于视口,当前通过 debug 清场或离开 zone 解锁。
下一步:
@@ -355,8 +355,7 @@ mindmap
下一步:
- `debug/debug_overlay.*` 已经提供碰撞、玩家包围盒、battle zone、camera lock 和 spawn point 绘制。
- `F1` 切换 debug overlay 总开关
- `F3-F6` 分别切换碰撞/网格、玩家框、battle zone/camera、spawn point。
- Debug overlay 已支持总开关和分项开关,具体快捷键记录在 `../controls.md`
- 绘制 hitbox / hurtbox。
- 输出当前场景、角色状态、FPS。
- 增加日志分级和异常状态重置入口。
@@ -587,7 +586,7 @@ mindmap
1. 已完成:`StageLayerSource``StageLayer` 同时支持色块占位和 sprite 资源路径。
2. 已完成:`StageAssetSlots` 建立 `stage_01` 资源槽位和素材来源记录,做到素材可直接落位。
3. 已完成:`StageProps` 把后景/前景 props 统一到 layer 数据。
4. `BattleZone`:把 `F2` debug 清场替换为敌人清空自动解锁。
4. `BattleZone`:把 debug 清场替换为敌人清空自动解锁。
5. `EnemyActor`:做第一个敌人占位,接入出生点。
6. `CombatSystem`:把 hitbox/hurtbox 真正跑起来。
7. `SpriteAnimator`:把玩家动画从硬编码改成组件。