NS_unknown_game/game/docs/modules/scene_camera.md

Scene and Camera

职责

场景模块负责局内生命周期、关卡装配、摄像机和 battle zone 流程。

主要源码：

• game/src/scene/whitebox_scene.*
• game/src/scene/camera_controller.*

WhiteboxScene

当前负责：

• 加载 LevelDefinition。
• 创建玩家。
• 配置摄像机。
• 驱动 battle zone 状态。
• 调用 StageRenderer。
• 调用 DebugOverlay。
• 推入 GameUiOverlay。
• 播放关卡 BGM 和 battle zone 进入音效。
• 保存 debug 开关。

摄像机

CameraController 当前支持：

• 玩家横向跟随。
• dead zone。
• 平滑移动。
• 世界边界 clamp。
• battle zone 临时 camera bounds。

进入/离开 battle zone 时，camera bounds 通过短过渡平滑切换，避免硬切瞬移。

Battle Zone

当前 battle zone 还是场景骨架阶段：

• 玩家进入触发区后激活。
• 摄像机锁定到 zone camera bounds。
• F2 debug 清场后解除锁定。
• enemy spawn point 只做 debug 显示，暂不刷敌。

下一步

• 用敌人清空结果替代 F2 debug 清场。
• 给 battle zone 增加入口/出口锁定数据。
• 把场景切换、重置、加载/卸载流程独立成 SceneFlow 模块。