Files

T

starmen1265 0f96b79dba feat(tools): 白模关卡自动生成Python脚本——Level Builder

两阶段流水线：搭建指南Markdown → JSON → UE5 Actor
- 解析器：4种表格变体+范围展开+坐标表达式计算
- 配置：37种BSP资产映射+13种材质+7区域定义
- 验证：265个Actor全部通过，0错误
- Builder：UE5 Python API自动放置Actor+材质+Outliner
- 报告：自动生成搭建报告Markdown

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-07 23:03:45 +08:00

3.7 KiB

Raw Blame History

关卡执行案审查报告

审查日期：2026-06-07 审查对象：v0.1 关卡执行案 -- 城郊小街 — docs/design/prototype/level-v01-suburban-execution.md 审查依据：docs/design/prototype/level-design-workflow.md 第五章 -- PM 关卡文档质量门检查项 宏观阶段：原型

审查范围说明

根据 level-design-workflow.md 第五章，关卡执行案的质量门仅做资产存在验证。空间精度、比例、跨文档一致性等维度由程序在白模搭建过程中验证（Phase E），PM 不在质量门阶段检查。

检查结果

5.1 关卡资产存在验证

BSP 资产类别验证

关卡执行案中共引用 42 个 BSP 资产类别名（含 Primitives），逐一验证结果如下：

检查项	结果	说明
墙体类（Wall 系列）	全部通过	Wall_400x300、Wall_200x300、Wall_100x300、Wall_400x100、WallDoor_200x300、WallDoorGarage_400x400、WallWindow_400x300、WallWindowSmall_200x300 均存在
地板类（Floor 系列）	全部通过	Floor_1000x1000、Floor_300x400、Floor_200x300 均存在
门类（Door 系列）	全部通过	RotativeDoor_01、GarageDoorOpen_01 均存在
窗户类（Window 系列）	全部通过	FakeWindowsFrame 存在
横梁类（Beam 系列）	全部通过	Beam_300 存在
围栏/围挡类	全部通过	BarricadeWall_600、BarricadeWall_200（= BarrierWall_200）、Fence_Small_400 均存在
基础体（Primitives）	全部通过	Cube、Cylinder、CirclePlatform 均存在
家具类	全部通过	SimpleTable_01、SimpleTable_02、BedSingle、Monitor_01 均存在
载具/工业/装饰类	全部通过	Car01、Barrel、Bucket_01、WoodenBox_Small、WoodenBox_Normal、WoodenPallet_01、TrashCans_01 均存在
植被/灯光/建筑类	全部通过	Tree_01、RoadLamp_01、Building_01 均存在
展示面板类	不通过	DisplayPanels_300x200 不存在（见问题 #1）

Primitives 组合方案验证

检查项	结果	说明
Primitives 组合方案合理性	全部通过	所有标记为 Primitives 组合的替代方案均使用 Cube/Cylinder/CirclePlatform，搭配缩放或标识色材质，方案合理可行

标识色材质验证

检查项	结果	说明
标识色材质范围	全部通过	引用的 12 种材质（MI_DevRed/Orange/Gray/Brown/White/Blue/SkyBlue/Green/Yellow/Foliage、MI_DevGlassWhite/GlassBlue）均在 14 种基础标识色 + 玻璃材质范围内

判定

不通过 -- DisplayPanels_300x200 资产不存在，需策划修正引用。

问题清单

问题 #1（必须修正）

位置：Z3-P06 广告墙，第三节 Z3 区域 3.3.3 布景物清单

问题：引用了 DisplayPanels_300x200，该尺寸在实际资产目录中不存在。

实际可用的 DisplayPanels 尺寸：

SM_DisplayPanels_50x50
SM_DisplayPanels_100x50
SM_DisplayPanels_100x100
SM_DisplayPanels_200x50
SM_DisplayPanels_200x100
SM_DisplayPanels_200x200
SM_DisplayPanels_400x100
SM_DisplayPanels_400x200

建议修正方案（策划选择）：

改用 DisplayPanels_400x200 并相应调整广告墙尺寸参数（宽 300cm -> 400cm），或
改用 DisplayPanels_200x200（正方形，比例变为 1:1），或
改用 Primitives 组合（Cube 薄片 + MI_DevYellow 标识色），保持原尺寸 300cm 宽不变

备注

本次审查未检查以下维度（由程序在 Phase E 白模搭建过程中验证）：

空间精度与坐标一致性
比例与尺寸合理性（儿童视角）
跨文档一致性（交互系统/收集系统执行案的编号对应）
资产拼接可行性（如"裁剪"标注的实际操作性）

3.7 KiB Raw Blame History Unescape Escape