NS_unknown_game/game/docs/README.md

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/，避免混在根目录。