8011cb6472
- P-008 交互系统技术设计审查通过,审查记录 docs/plans/reviews/P-008-review.md - D-001 关卡执行案审查通过,审查记录 docs/plans/reviews/D-001-review.md - 新增 AI 美术调研参考图(我的暑假/放学后少年/真实场景/美术风格) - 新增关卡执行案、白模搭建指南和搭建报告 - 完善工作流技能:质量门审查、Agent记忆、需求分析 - 更新交互系统和角色控制系统技术设计文档 - 清理过时参考文档
10 KiB
10 KiB
v0.1 白模搭建报告 — 城郊小街
P-006 任务产出 — 搭建准备阶段 最后更新:2026-06-07
一、搭建概要
| 项目 | 值 |
|---|---|
| 关卡文件 | Content/Maps/LVL_SuburbanV01.umap(需在 UE5 编辑器中创建) |
| 搭建指南 | docs/technical/level-v01-build-guide.md |
| 场景尺寸 | 8000cm × 6000cm(80m × 60m) |
| 区域数量 | 7 个(Z1-Z7) |
| 预估总 Actor 数 | ~195 |
| BSP 资产包 | Content/BlockingStarterPack/ |
各类别预估数量
| 类别 | 数量 |
|---|---|
| 结构体 (STR) | ~80 |
| 布景 (PROP) | ~45 |
| 交互物 (INTR) | 10 |
| 收集品 (COLL) | 10 |
| 边界 (BND) | ~45 |
| 光源 (LGT) | 5 |
| 合计 | ~195 |
二、逐区域对照
Z1 家
| 条目 | 文档要求 | 实际方案 | 偏差 |
|---|---|---|---|
| 院墙高度 | 250cm | Wall_400x300(300cm 高) | 轻微:+50cm,视觉影响小 |
| 院门宽度 | 200cm | WallDoor_200x300 | ✅ 匹配 |
| 院门高度 | 220cm | WallDoor_200x300 门洞约 100cm 开口 | ⚠️ 需验证门洞实际开口高度 |
| 房屋尺寸 | 600×380×280 | 按偏移放置墙体围合 | ✅ 匹配 |
| 旧自行车 | Car01 缩放 50% | Car01 缩放 20% | 轻微:BSP Car01 默认较大,20% 更接近自行车尺寸 |
| 老式冰箱 | Barrel 或 Cube | Cube 缩放模拟方冰箱 | 轻微:Barrel 圆柱形不如 Cube 方形更像冰箱 |
| 交互物 3 个 | I01/I02/I06 | 标记位置 | ✅ 匹配 |
| 收集品 1 个 | C10 猫眼弹珠 | 标记位置 | ✅ 匹配 |
Z2 小卖部
| 条目 | 文档要求 | 实际方案 | 偏差 |
|---|---|---|---|
| 建筑尺寸 | 600×400×280 | 按偏移放置 | ✅ 匹配 |
| 卷帘门 | GarageDoorOpen_01 | ✅ | ✅ 匹配 |
| 遮阳棚 | Floor_200x300 × 2 | ✅ | ✅ 匹配 |
| 玻璃柜台 | Cube + MI_DevGlassWhite | ✅ | ✅ 匹配 |
| 零食货架 | Fence_Small_400 竖放 × 2 | Fence_Small_400 排列 | ✅ 匹配 |
| 老式冰柜 | Cube 缩放 + MI_DevWhite | Container_Normal 缩小替代 | 轻微:Cube 方案更简单 |
| 招牌 | Cube 薄片 + MI_DevBlue | ✅ | ✅ 匹配 |
| 交互物 2 个 | I05/I07 | 标记位置 | ✅ 匹配 |
| 收集品 1 个 | C09 小弹力球 | 标记位置 | ✅ 匹配 |
Z3 主街道
| 条目 | 文档要求 | 实际方案 | 偏差 |
|---|---|---|---|
| 街道尺寸 | 5000×500 | Floor_1000x1000 × 5 平铺 | ✅ 匹配 |
| 南墙 C 段 | X=1600-4000, 2400cm | 6 块 Wall_400x300 | ✅ 匹配 |
| 南墙 D 段 | X=4000-5000, 1000cm | 2 块 Wall_400x300 + Wall_200x300 | ✅ 匹配 |
| 北墙 A 段 | X=0-2300, 2300cm | 5 块 Wall_400x300 + 1 块 Wall_200x300 | ✅ 匹配 |
| 北墙 B 段 | 300cm 开口 | 开放通行 | ✅ 匹配 |
| 北墙 C 段 | X=2600-3500, 900cm | 2 块 Wall_400x300 + 1 块 Wall_100x300 | ✅ 匹配 |
| 北墙 D 段 | 1500cm 开口 | 开放通行 | ✅ 匹配 |
| 公用电话亭 | Cube+Cylinder | Cube 单体缩放 | 轻微:简化为单体 |
| 广告墙 | DisplayPanels_400x200 | ✅ | ✅ 匹配 |
| 交互物 2 个 | I04/I09 | 标记位置 | ✅ 匹配 |
| 收集品 1 个 | C08 透明冰花弹珠 | 标记位置 | ✅ 匹配 |
Z4 空地
| 条目 | 文档要求 | 实际方案 | 偏差 |
|---|---|---|---|
| 地面高度 | +10cm | Floor Z=10 | ✅ 匹配 |
| 东边界围挡 | BarrierWall_600 × 2 | ✅(需堆叠 2 层) | ⚠️ BarrierWall_600 高仅 100cm,需堆叠 |
| 北边界围挡 | BarrierWall_600 × 2 + BarrierWall_200 | ✅(需堆叠) | 同上 |
| 西边界矮墙 | BarrierWall_200 × 6 | ✅ | ✅ 匹配 |
| 大梧桐树 | Tree_01 | ✅ | ✅ 匹配 |
| 交互物 2 个 | I03/I08 | 标记位置 | ✅ 匹配 |
| 收集品 3 个 | C01/C03/C04 | 标记位置 | ✅ 匹配 |
Z5 巷子
| 条目 | 文档要求 | 实际方案 | 偏差 |
|---|---|---|---|
| 巷子宽度 | 300cm | 实际约 260cm(2580-2300-20墙厚) | 重大:宽度差 40cm,仅 87% 设计宽度 |
| 巷子长度 | 2000cm | 墙体 Y=1300-3300 覆盖 | ✅ 匹配 |
| 墙壁高度 | 300cm | Wall_400x300(300cm) | ✅ 匹配 |
| 老窗户 | FakeWindowsFrame | ✅ | ✅ 匹配 |
| 交互物 1 个 | I10 废纸箱 | 标记位置 | ✅ 匹配 |
| 收集品 1 个 | C02 红色花纹弹珠 | 标记位置 | ✅ 匹配 |
Z6 水塘边
| 条目 | 文档要求 | 实际方案 | 偏差 |
|---|---|---|---|
| 水面高度 | Z=-20cm | ✅ | ✅ 匹配 |
| 水面尺寸 | 1200×800 | Floor 缩放覆盖 | ✅ 匹配 |
| 岸边三面 | 各约 300cm | Floor 覆盖 | ✅ 匹配 |
| 芦苇丛 | Cylinder × N | ✅ | ✅ 匹配 |
| 交互物 | 无 | — | ✅ 匹配 |
| 收集品 2 个 | C05/C06 | 标记位置 | ✅ 匹配 |
Z7 老居民楼
| 条目 | 文档要求 | 实际方案 | 偏差 |
|---|---|---|---|
| 建筑尺寸 | 1200×600×1800 | Building_01 默认尺寸待验证 | ⚠️ 需在编辑器中确认/缩放 |
| 碰撞围墙 | 阻止靠近 | Wall_400x300 排列 | ✅ 匹配 |
| 不可进入 | 无门洞 | ✅ | ✅ 匹配 |
| 晾衣杆 3 个 | Beam_300 × 3 | ✅ | ✅ 匹配 |
三、资产替代清单
| # | 文档建议 | 实际使用 | 原因 |
|---|---|---|---|
| 1 | BarrierWall_600/200(围挡) | 建议改用 Wall_400x300 旋转 90° | BarrierWall 高仅 100cm 需堆叠 2-3 层,Wall_400x300 高 300cm 一步到位更高效 |
| 2 | Car01 缩放 50%(自行车) | Car01 缩放 20% | BSP Car01 默认尺寸(约 450cm 长)远大于自行车,20% 缩放至约 170cm 更接近 |
| 3 | Barrel(冰箱) | Cube 缩放 | Barrel 为圆柱形,冰箱应为方形,Cube 更合适 |
| 4 | Container_Normal(冰柜) | Cube 缩放 | 同上,Cube 更简单直接 |
| 5 | BarricadeWall_100(路障) | 未使用 | 执行案未引用此资产(D-001 审查已修正) |
四、缩放记录
| Actor | 资产 | 默认尺寸 | 缩放 | 实际尺寸 | 用途 |
|---|---|---|---|---|---|
| 自行车 | Car01 | ~450×180×150 | (0.2, 0.2, 0.2) | ~90×36×30 | 旧自行车 |
| 冰箱 | Cube | 100×100×100 | (0.3, 0.3, 1.6) | 30×30×160 | 老式冰箱 |
| 门垫 | Cube | 100×100×100 | (0.6, 0.4, 0.02) | 60×40×2 | 扁薄长方体 |
| 日历 | Cube | 100×100×100 | (0.3, 0.02, 0.4) | 30×2×40 | 墙面薄片 |
| 玻璃柜台 | Cube | 100×100×100 | (2, 0.6, 0.9) | 200×60×90 | 扁长方体 |
| 招牌 | Cube | 100×100×100 | (3, 0.05, 0.4) | 300×5×40 | 薄长条 |
| 积水坑 | Cube | 100×100×100 | (1.2, 0.8, 0.01) | 120×80×1 | 扁平水面 |
| 电话亭 | Cube | 100×100×100 | (0.8, 0.8, 2.2) | 80×80×220 | 方形亭 |
| 电线杆 | Cylinder | ~100Ø×100 | (0.04, 0.04, 12) | ~Ø4×600 | 高细圆柱 |
| 支撑柱 | Cylinder | ~100Ø×100 | (0.05, 0.05, 3.6) | ~Ø5×180 | 晾衣杆柱 |
| 花盆 | Cylinder | ~100Ø×100 | (0.2, 0.2, 0.25) | ~Ø20×25 | 窗台小花盆 |
| 青蛙 | Cube | 100×100×100 | (0.05, 0.05, 0.04) | 5×5×4 | 微型 |
| 荷叶 | CirclePlatform | ~100Ø | (0.06, 0.06, 0.01) | ~Ø6 | 水面小圆 |
| 弹珠圈 | CirclePlatform | ~100Ø | (0.16, 0.16, 0.01) | ~Ø16 | 地面圆圈 |
| 下水道盖 | CirclePlatform | ~100Ø | (0.12, 0.12, 0.02) | ~Ø12 | 路面小圆 |
| 芦苇 | Cylinder | ~100Ø×100 | (0.08, 0.08, 2) | ~Ø8×200 | 细长植物 |
五、未实现项
| # | 项目 | 原因 | 建议处理 |
|---|---|---|---|
| 1 | .umap 关卡文件 |
无法在 CLI 中创建二进制 UE5 关卡文件,需在 UE5 编辑器中操作 | 用户根据搭建指南在编辑器中创建 |
| 2 | 交互物逻辑 | 交互物仅放置占位标记,不包含交互逻辑代码 | 6b-6f 子任务实现 |
| 3 | 收集品逻辑 | 收集品仅放置占位标记,不包含拾取逻辑 | 6b-6f 子任务实现 |
| 4 | 物理碰撞设置 | 边界和墙体需启用碰撞,需在编辑器中设置 | 搭建时设置 Collision Preset = BlockAll |
| 5 | 材质实例覆盖 | 部分材质需要在编辑器中创建动态材质实例(MI) | 搭建时在 Details 面板设置 |
| 6 | Outliner 文件夹分组 | 需在编辑器中手动拖拽 Actor 到对应文件夹 | 搭建时组织 |
六、比例验证结果
E1 角色比例检查(待编辑器中执行)
| 检查项 | 预期结果 | 状态 |
|---|---|---|
| Z1 院门可通过 | 门洞 200cm 宽,主角 120cm 身高 | ⬜ 待验证 |
| Z1 房屋门可通过 | WallDoor_200x300 门洞 | ⬜ 待验证 |
| Z2 卷帘门可通过 | 400cm 开放门洞 | ⬜ 待验证 |
| 室内摄像机不穿墙 | 净高 280cm,摄像机 100cm | ⬜ 待验证 |
| 窗台高度 | WallWindow 窗台约 100cm | ⬜ 待验证 |
| 桌面高度 | SimpleTable_01 ~75cm | ⬜ 待验证 |
E2 流线通行检查(待编辑器中执行)
| 路径 | 状态 |
|---|---|
| Z1 院门 → Z3 街道 | ⬜ 待验证 |
| Z3 → Z2 小卖部 | ⬜ 待验证 |
| Z3 → Z4 空地 | ⬜ 待验证 |
| Z3 → Z5 巷子 | ⬜ 待验证 |
| Z5 → Z6 水塘边 | ⬜ 待验证 |
| Z7 不可到达 | ⬜ 待验证 |
E3 已知尺寸偏差(搭建前识别)
| # | 偏差 | 等级 | 说明 |
|---|---|---|---|
| 1 | Z5 巷子实际宽度约 260cm vs 设计 300cm | 重大 | Wall 厚度 20cm 占用空间。建议:将东墙东移至 X=2600+20=2620,或接受 260cm 宽度 |
| 2 | BarrierWall 高度仅 100cm vs 设计围挡 200cm | 轻微 | 需堆叠 2 层,或改用 Wall_400x300 旋转 90° |
| 3 | Building_01 默认尺寸待确认 vs 设计 1200×600×1800 | 轻微 | 需在编辑器中测量并按需缩放 |
| 4 | Z3 北墙偏移 480cm vs 区域深度 500cm(PM 审查残留) | 轻微 | 20cm 差异在 500cm 深度中影响极小 |
| 5 | 第五章南边界汇总表 "BarricadeWall" 应为 "BarrierWall"(PM 审查残留) | 轻微 | 泛指文本,不影响搭建 |
七、下一步
- 用户在 UE5 编辑器中按搭建指南操作:创建关卡文件 → 按 Phase B→C→D→E 顺序放置 Actor
- 验证阶段:执行 E1/E2/E3 检查清单,记录实际验证结果
- 更新本报告:将编辑器中的实际偏差补充到报告
- PM 验收门审查:搭建完成后通知 PM 执行 ⑥程序实现验收门审查