41 lines
2.1 KiB
Markdown
41 lines
2.1 KiB
Markdown
# 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/map_editor.md`：简易 `.map` 地图编辑器实现状态；完整工具说明见 `../../tools/map_editor/DOCUMENTATION.md`。
|
|
- `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/`，避免混在根目录。
|