# Game Modules

本目录按游戏源码模块拆分说明文档。查具体代码时优先从这里进入；跨模块路线、阶段计划和验收流程仍放在 `../planning/`、`../game_skeleton.md` 和 `../scene_acceptance.md`。

## 模块索引

- `core_services.md`：游戏启动、`GameServices`、资源路径、基础配置。
- `assets.md`：全局资源槽位、角色资源优先级、地图和 stage 资源落位。
- `data_map.md`：`LevelDefinition`、`.map` 加载、地图数据格式。
- `map_editor.md`：简易 `.map` 地图编辑器目标、范围和验收标准。
- `stage_rendering.md`：`StageRenderer`、场景分层、贴图/色块 fallback。
- `scene_camera.md`：`WhiteboxScene`、摄像机跟随、battle zone 锁镜头。
- `movement_collision.md`：`PlatformWorld`、`PlatformMover`、横版基础碰撞。
- `actor_player.md`：`PlayerActor`、玩家状态、动画和音效触发。
- `input.md`：`InputState`、PC/Switch 输入语义和后续配置计划。
- `ui_overlay.md`：`GameUiOverlay`、`UIScene`、`TextSprite` 和 fallback UI。
- `audio_save.md`：`GameAudio`、`GameSave`、音频 cue 和 debug 存档。
- `debug_tools.md`：`DebugOverlay`、调试开关、可视化范围。
- `combat.md`：当前 hitbox 预留和后续战斗模块拆分方向。

## 维护规则

- 新增源码模块时，同步新增或更新本目录对应文档。
- 单个模块文档只写模块职责、入口文件、数据流、当前状态和下一步。
- 跨模块验收结果写到 `../scene_acceptance.md`。
- 长期计划写到 `../planning/`，不要塞进模块文档。