# Game Docs

本文档目录只放游戏层相关文档；引擎、构建和仓库级说明仍保留在项目根目录。

## Planning

- `planning/development_plan.md`：横板 2D ACT 清版游戏开发总计划，包含里程碑、玩法阶段、技术阶段和风险。
- `planning/game_architecture_board.md`：游戏整体架构白板，包含思维导图、模块划分、数据流和阶段路线。
- `planning/scene_build_plan.md`：第一关场景搭建计划，包含素材清单、场景分层和验收标准。

## References

- `../assets/ASSETS.md`：全局资源槽位，包含字体、音频、PVF、NPK、SoundPack 和角色动画 fallback 路径。
- `modules/README.md`：游戏模块文档索引，按源码模块拆分说明。
- `controls.md`：玩家操作、平台输入映射和开发调试快捷键。
- `engine_capability_audit.md`：引擎已有能力复盘，以及游戏层应优先复用的系统。
- `game_skeleton.md`：当前游戏骨架如何接入引擎基础能力。
- `scene_acceptance.md`：第一关场景骨架验收流程和最近一次验收结果。

## Modules

- `modules/core_services.md`：启动、服务、配置、资源路径。
- `modules/assets.md`：资源槽位和素材落位。
- `modules/data_map.md`：地图数据和 `LevelDefinition`。
- `modules/stage_rendering.md`：场景分层和渲染。
- `modules/scene_camera.md`：场景流程、摄像机、battle zone。
- `modules/movement_collision.md`：横版移动和平台碰撞。
- `modules/actor_player.md`：玩家 Actor、状态和动画。
- `modules/input.md`：输入语义。
- `modules/ui_overlay.md`：局内 UI overlay。
- `modules/audio_save.md`：音频 cue 和存档。
- `modules/debug_tools.md`：调试显示。
- `modules/combat.md`：战斗模块预留和后续接入。

## Naming

- 文件名使用小写 `snake_case`。
- 长期有效的计划放入 `planning/`。
- 临时调研、实验记录后续单独放入 `research/` 或 `notes/`，避免混在根目录。