NS_unknown_game/game/docs/modules/README.md

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 地图编辑器目标、范围和验收标准；完整工具说明见 ../../../tools/map_editor/DOCUMENTATION.md。
• 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/，不要塞进模块文档。