starmen1265
8011cb6472
- P-008 交互系统技术设计审查通过，审查记录 docs/plans/reviews/P-008-review.md - D-001 关卡执行案审查通过，审查记录 docs/plans/reviews/D-001-review.md - 新增 AI 美术调研参考图（我的暑假/放学后少年/真实场景/美术风格） - 新增关卡执行案、白模搭建指南和搭建报告 - 完善工作流技能：质量门审查、Agent记忆、需求分析 - 更新交互系统和角色控制系统技术设计文档 - 清理过时参考文档
213 lines
10 KiB
Markdown
213 lines
10 KiB
Markdown
# 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 审查残留） | 轻微 | 泛指文本，不影响搭建 |
|
||
|
||
---
|
||
|
||
## 七、下一步
|
||
|
||
1. **用户在 UE5 编辑器中按搭建指南操作**：创建关卡文件 → 按 Phase B→C→D→E 顺序放置 Actor
|
||
2. **验证阶段**：执行 E1/E2/E3 检查清单，记录实际验证结果
|
||
3. **更新本报告**：将编辑器中的实际偏差补充到报告
|
||
4. **PM 验收门审查**：搭建完成后通知 PM 执行 ⑥程序实现验收门审查
|