diff --git a/game/docs/planning/game_architecture_board.md b/game/docs/planning/game_architecture_board.md index a2fd1a2..05a8c92 100644 --- a/game/docs/planning/game_architecture_board.md +++ b/game/docs/planning/game_architecture_board.md @@ -404,14 +404,19 @@ mindmap ## 当前优先级 +当前调整为先做场景。理由:先把第一关的世界宽度、分层数据、镜头范围、视觉层和 debug 标记搭起来,后续 `BattleZone`、敌人刷出和战斗系统才有稳定承载位置。 + 下一步建议按这个顺序做: -1. `BattleZone`:做清版推进的核心框架。 -2. `EnemyActor`:做第一个敌人占位。 -3. `CombatSystem`:把 hitbox/hurtbox 真正跑起来。 -4. `SpriteAnimator`:把玩家动画从硬编码改成组件。 -5. `StageLayer`:把白盒视觉层扩展为背景、tiles 和 props。 -6. `InputConfig`:把默认键位/手柄映射迁移到可配置数据。 +1. `StageLayer`:把白盒视觉层扩展为背景、地面、平台和 props。 +2. `LevelDefinition`:补齐世界尺寸、玩家出生点、镜头限制、敌人出生点和 battle zone 数据。 +3. `StageRenderer`:支持远景/中景/地面/props 分层绘制,先用色块或占位图也可以。 +4. `SceneDebug`:显示碰撞、出生点、battle zone、镜头锁定范围,补 `F1` 开关。 +5. `BattleZone`:在场景数据稳定后做触发、锁镜头、清场解锁。 +6. `EnemyActor`:做第一个敌人占位,接入出生点。 +7. `CombatSystem`:把 hitbox/hurtbox 真正跑起来。 +8. `SpriteAnimator`:把玩家动画从硬编码改成组件。 +9. `InputConfig`:把默认键位/手柄映射迁移到可配置数据。 ## 素材协作提示 diff --git a/game/docs/planning/scene_build_plan.md b/game/docs/planning/scene_build_plan.md index fdd7c38..aed7f85 100644 --- a/game/docs/planning/scene_build_plan.md +++ b/game/docs/planning/scene_build_plan.md @@ -199,12 +199,34 @@ game/assets/stage/stage_01/ 5. 再接 props,丰富场景轮廓。 6. 最后接 effects 和音频。 -## 9. 下一轮建议任务 +## 9. 当前执行顺序 -你找到素材后,下一轮优先做: +本轮开始先做场景,不等待最终素材。第一阶段目标是把第一关变成可替换素材的灰盒场景骨架,让后续素材只需要填到既定层级和数据结构里。 + +### 先做工程骨架 + +1. 扩展 `LevelDefinition`:加入世界尺寸、玩家出生点、镜头限制、敌人出生点、battle zone 占位数据。 +2. 扩展 `StageRenderer`:支持背景层、地面/平台视觉层、后景 props,第一版可以继续用色块。 +3. 扩展白盒关卡宽度到 2400 到 3200 像素,并整理成 3 段推进节奏。 +4. 加入 3 个 battle zone debug 标记,但暂不做锁镜头和刷敌逻辑。 +5. 加入 spawn point debug 标记,用于后续接 `EnemyActor`。 +6. 补 `F1` debug 开关,至少能切换碰撞、battle zone、spawn point。 + +### 素材回来后再替换 + +1. 整理素材到 `game/assets/stage/stage_01/`。 +2. 记录素材来源和授权。 +3. 先接背景图,验证相机移动。 +4. 再接地面/平台 tiles,验证碰撞对齐。 +5. 再接 props,丰富场景轮廓。 +6. 最后接 effects 和音频。 + +## 10. 下一轮建议任务 + +下一轮优先做: -- 创建 `stage_01` 资源目录。 -- 新增 `StageRenderer`。 - 扩展 `LevelDefinition`。 -- 把当前白盒平台替换成第一版 tile 视觉。 +- 扩展 `StageRenderer`。 +- 将第一关扩到 2400 到 3200 像素。 +- 加入 battle zone / spawn point debug 数据。 - 保留 debug 碰撞显示。