Files
ChildHood/.claude/refs/blockout-asset-reference.md
starmen1265 84bdfb22de docs(workflow): 关卡设计工作流与关卡执行案体系
- Agent 文档新增关卡执行案产出规范与白模搭建工作流
- 开发流水线补充关卡执行案产出节点与白模搭建子任务(6a)
- 新增关卡执行案模板、BSP资产参考卡、关卡设计工作流规范
- 新增原型阶段设计文档索引 README
- .gitignore 补充 __pycache__ 规则
2026-06-06 23:55:14 +08:00

14 KiB
Raw Permalink Blame History

BlockingStarterPack 资产参考卡

供策划产出关卡执行案时引用 BSP 资产。策划只需引用资产类别名和近似尺寸(如 Wall_400x300),不需要写文件路径。程序负责最终映射到引擎中的具体资产。

所有尺寸以厘米(cm)为单位。资产路径前缀:Content/BlockingStarterPack/Meshes/


一、建筑模块(Architecture)

1.1 墙体(Walls)

命名规律:SM_Wall_<宽>x<高> — 宽度/高度均为 cm 单位

资产名 尺寸(宽cm × 高cm) 用途
Wall_100x100 100 × 100 短墙、装饰墙段
Wall_100x300 100 × 300 标准宽度墙面
Wall_100x400 100 × 400 标准宽度高墙
Wall_200x100 200 × 100 矮墙、半墙
Wall_200x300 200 × 300 常用 — 标准墙面
Wall_200x400 200 × 400 高墙面
Wall_400x100 400 × 100 矮长墙
Wall_400x300 400 × 300 常用 — 大片墙面
Wall_400x400 400 × 400 大片高墙

含门洞的墙:SM_WallDoor_<宽>x<高>

资产名 尺寸 说明
WallDoor_200x300 200 × 300 单门洞墙
WallDoor_200x400 200 × 400 单门洞高墙
WallDoor_400x300 400 × 300 宽墙含单门洞
WallDoor_400x400 400 × 400 宽墙含单门洞(高)
WallDoorDouble_400x300 400 × 300 宽墙含双门洞
WallDoorDouble_400x400 400 × 400 宽墙含双门洞(高)
WallDoorGarage_400x300 400 × 300 车库门墙
WallDoorGarage_400x400 400 × 400 车库门墙(高)

含窗户的墙:SM_WallWindow_<宽>x<高>

资产名 尺寸 说明
WallWindow_200x300 200 × 300 单窗墙
WallWindow_200x400 200 × 400 单窗墙(高)
WallWindow_400x300 400 × 300 宽窗墙
WallWindow_400x400 400 × 400 宽窗墙(高)
WallWindowDouble_400x300 400 × 300 双窗墙
WallWindowDouble_400x400 400 × 400 双窗墙(高)
WallWindowSmall_200x300 200 × 300 小窗墙
WallWindowSmall_200x400 200 × 400 小窗墙(高)

圆角墙:SM_WallRoundedCorner_<宽>x<高>_<角度>d(角度 45d 或 90d)

1.2 地板(Floors)

命名规律:SM_Floor_<宽>x<深>

资产名 尺寸(cm) 用途
Floor_100x100 100 × 100 小面积填充
Floor_100x200 100 × 200 窄条地面
Floor_100x300 100 × 300 走廊地面
Floor_100x400 100 × 400 长走廊
Floor_200x150 200 × 150 不规则填充
Floor_200x200 200 × 200 中等面积
Floor_200x300 200 × 300 常用
Floor_200x400 200 × 400 常用
Floor_300x300 300 × 300 大面积
Floor_300x400 300 × 400 大面积
Floor_400x400 400 × 400 大面积
Floor_1000x1000 1000 × 1000 超大地砖 — 快速铺设大范围地面

另有:FloorCorner(转角)、FloorRounded(圆角)、FloorTriangle(三角)、Floor 含 Trap(带活门开口)

1.3 门(Doors)

资产名 说明
DoorFrame 单门框
DoorFrameDouble 双门框
DoorFrameGarage 车库门框
RotativeDoor_01 / 02 / 03 旋转门(三种样式)
LateralDoor 推拉门
LateralDoorFrame_150 / 300 推拉门框(150cm/300cm 宽)
FakeDoor / FakeDoorDouble 假门(装饰,不可开)
GarageDoor_01 / 02 车库门(关闭)
GarageDoorOpen_01 / 02 车库门(打开)

1.4 窗户(Windows)

资产名 说明
WindowsFrame / WindowsGlass 单窗框/玻璃
WindowsFrameDouble / WindowsGlassDouble 双窗
WindowsFrameUp / WindowsGlassUp 上开窗
FakeWindowsFrame / FakeWindowsFrameDouble / FakeWindowsFrameUp 假窗(装饰)

1.5 楼梯(Stairs)

资产名 说明
Stair_100 / Stair_200 直梯(100cm/200cm 高)
StairPlane_100 / StairPlane_200 楼梯面(无侧板)
StairRounded_300_45d / 90d 圆弧梯

1.6 栏杆/围栏(Barriers)

命名规律:SM_Barrier<类型>_<长度>cm

  • Barrier01/02/03 — 三种样式(直线段,50/100/200/500cm)
  • BarrierAngle — 角度栏杆
  • BarrierBeam — 横梁栏杆
  • BarrierRounded01/02_45/90 — 圆弧栏杆(200-800cm)
  • BarrierStair — 楼梯栏杆
  • BarrierWall_200/400/600 — 实墙式栏杆(常用作围墙)
  • BarrierWallRoundedCorner — 实墙式圆角

独立围栏:

  • Fence_Normal_100/200/300/400 — 普通围栏
  • Fence_Small_100/200/300/400 — 矮围栏

1.7 飘窗(BayWindows)

SM_BayWindow<类型>_<宽>x<高> — 宽度 100/200/400,高度 300/400

  • BayWindow — 纯飘窗
  • BayWindowDoor — 带门的飘窗
  • BayWindowDoorDouble — 带双门的飘窗

1.8 横梁(Beams)

资产名 说明
Beam_300 / Beam_400 直梁(300/400cm)
RoundedBeam_300 / RoundedBeam_400 圆弧梁
Beam_400_45d / RoundedBeam_400_45d 45 度转角梁

二、建筑整体(Buildings)

2.1 小型建筑(SmallBuildings)

资产名 说明 建议用途
House_01 小房屋 A 家、小卖部等单层建筑
House_02 小房屋 B 居民平房
House_03 小房屋 C 仓库/杂物间
House_04 小房屋 D 另一种风格平房

2.2 大型建筑(BigBuildings)

资产名 说明 建议用途
Building_01 大楼 A 老居民楼(5-6层)
Building_02 大楼 B 办公楼/商场
Building_03 大楼 C 工业建筑
Building_04 大楼 D 另一种风格大楼

三、家具(Furnitures)

资产名 说明 尺寸参考
SimpleTable_01 简易桌 ~120×60cm
SimpleTable_02 简易桌 B ~100×60cm
DinnerTable_01 / 02 / 03 餐桌(三种) ~120-150cm
DiningChair_01 餐椅 ~45cm 座高
OfficeChair_01 办公椅 带轮
Armchair_01 扶手椅 休闲用
Laptop 笔记本电脑 小型桌面物件
Monitor_01 显示器 ~50cm 宽
Keyboard 键盘 桌面物件
Broom 扫帚 靠墙放
Cushion 坐垫 小型

四、卧室(Bedroom)

资产名 说明
BedSingle 单人床(含被褥)
BedSingle_Empty 单人床(空床)
BedDouble 双人床(含被褥)
BedDouble_Empty 双人床(空床)

五、卫浴(Bathroom)

资产名 说明
Toilet_01 马桶
ToiletClosed_01 马桶(盖关)
Urinal_01 小便池
ToiletPaper_01 / 02 卫生纸

六、装饰小物件(Decorations)

资产名 说明 用途
Bottle_01 / 02 / 03 饮料瓶/酒瓶 小卖部、街头散落
Books_01 / BooksOpen_01 书本 书桌、书架
Can_01 易拉罐 散落物、垃圾桶内
Flask_01 烧瓶 实验室场景
GlassFlask_01-04 玻璃瓶(四种) 装饰、收集
Mug_01 马克杯 桌面物件
Plate_01 盘子 餐桌
WaterGlass_01 水杯 桌面物件
Bucket_01 水桶 院子、巷子
Padlock_01 / Padlock_Open / Padlock_Break 挂锁(三种状态) 门、箱子
SimplePlug_01 插头 墙面细节
SimpleSwitch_01 开关 墙面细节
SpikedBall_01 / 02 铁蒺藜 路障

七、载具(Vehicles)

资产名 说明
Car01 / Car02 轿车(两种)
Truck01 / Truck02 卡车(两种)
TruckWithoutTrailer 卡车(无挂车)
HoodTruckWithoutTrailer 皮卡
Bus_Big 大巴
Boat_01 / Boat_02 船(两种)
Plane_01 飞机
Metro_01 地铁车厢
Trailer_01 / 02 / 03 挂车(三种)
SimpleWheel / SimpleRims 车轮/轮毂
TruckWheel / TruckRims 卡车轮
SimpleTire 轮胎
SmallLocomotive 小型机车
SmallWagon_Normal / SmallWagon_Large 小型车厢
SmallRail_200-1000 小型铁轨
SmallRailTurn_45d / 90d 小型铁轨转辙

八、道路设施(Roads)

资产名 说明
BarricadeBlocks_100 / 200 水马路障
Barricade_200 / 300 / 400 栏式路障
BarricadeWall_100 矮路障墙
RoadCone_Big / Normal / Small 锥桶(三种大小)
SpeedBump_100/200/400/600 减速带
SpeedBumpWithEnds_200/400/600 减速带(含端头)
SpeedBumpEnd 减速带端头
MetalPost_01 金属路桩
RoadLamp_01 路灯
RoadLight 道路照明灯

九、工业物件(Industrials)

资产名 说明 用途
Barrel 铁桶 巷子、工地散落
ExplosiveBarrel 爆炸桶(红色) 游戏交互物
WoodenBox_Small / Normal / Large 木箱(三种大小) 杂物堆、仓库
WoodenCrate_01 木条箱 搬运箱
WoodenPallet_01 / 02 木托盘 地面垫板
Container_Normal / Large 集装箱 工地
ContainerClosed_Normal / Large 集装箱(关闭) 工地
ContainerDoor_Left / Right 集装箱门 工地
ContainerShip_01 / ContainerShipEmpty_01 船运集装箱 港口场景
BigDumpster 大垃圾箱 街道
Fence_Normal_100-400 / Fence_Small_100-400 围栏 场地分隔
Radiator 散热器 室内墙面

十、垃圾(Trashs)

资产名 说明
TrashCans_01 垃圾桶(盖着)
TrashCansOpen_01 垃圾桶(打开)
TrashCansLid_01 垃圾桶盖(单独)

十一、灯光(Lights)

资产名 说明
CeilingLight01 / 02a / 02b / 03a / 03b 吸顶灯(多种)
CeilingLightBulb / CeilingLightBulbBreak 灯泡(正常/损坏)
CeilingLightFlat02a / 02b 平板灯
CeilingLightRotaryWarning 旋转警示灯
SpotLight / SpotLight_Support 射灯
FlamingTorch / FlamingTorchWithSupport / FlamingTorch_Support 火把
FlashLight 手电筒
RoadLamp_01 路灯
RoadLight 道路灯

十二、基础体(Primitives)

资产名 说明 用途
Cube 立方体 万能替代,可缩放
Cylinder 圆柱体 柱子、管道
Sphere 球体 装饰
Cone 圆锥体 装饰
Ramp 斜坡 地形过渡
QuarterPipe 四分之一管 装饰/地形
QuarterCylinder 四分之一圆柱 角落装饰
CirclePlatform 圆形平台 地面标记
SquarePlatform 方形平台 地面标记
SphereOctant / SphereOctantInvert 球体切片 装饰

弯曲基础体(CylinderBend/RectangleBend/RectangleAngle,各种半径 150-450cm)


十三、其他(Extra)

资产名 说明
Tree_01 树木(唯一的植被资产)
Ladder_01_200 / Ladder_01_Unit 梯子(两种)
Ladder_02_200 / Ladder_02_Unit 梯子 B(两种)
SnowMan_01 雪人
Campfire 营火
HumanMesh_01 / 02 人体参考网格
HumanCage / HumanCageWithFloor 人体碰撞参考框
ArrowBody / ArrowHead / ArrowBack 箭头组件
CameraPose_01-04 摄像机参考姿态
DisplayPanels_50x50 到 400x200 展示面板(8种尺寸)

十四、标识色材质速查

用于白模阶段区分不同区域/物体类型。命名规律:MI_Dev<颜色> 或 MI_Dev<颜色>_TPLA/TPWA(三平面变体)。

材质名 颜色 推荐用途
MI_DevRed 红色 危险区域、交互热点、围墙
MI_DevBlue 蓝色 水域、天空相关
MI_DevGreen 绿色 植被、草地、可通行
MI_DevBrown 棕色 泥土、木质结构
MI_DevGray 灰色 水泥、混凝土、道路
MI_DevWhite 白色 墙壁、室内
MI_DevBlack 黑色 阴影区域、遮挡
MI_DevYellow 黄色 警示、收集品标记
MI_DevOrange 橙色 施工区域、路障
MI_DevPink 粉色 角色/NPC 相关
MI_DevPurple 紫色 特殊/隐藏区域
MI_DevSkyBlue 天蓝 水面、天空
MI_DevFoliage 草绿 植物、树木
MI_LightGreen 浅绿 草地细节

特殊材质:

  • MI_DevGrid — 带网格的灰色材质,用于地面
  • M_DevMirror — 镜面材质
  • M_FullyBlack — 纯黑材质,用于遮挡/剪影
  • MI_DevGlassBlue/Green/Red/White — 透明玻璃材质
  • MI_DevLight_* — 自发光材质(绿/蓝/橙/白/黄/红/天蓝)
  • MI_StainDecalColor* — 污渍贴花(黑/蓝/绿/红/天蓝/黄)

十五、中式城郊场景替代方案速查

千禧年城郊结合区的许多物件在 BSP 中没有精确匹配,下表提供替代策略。

场景物件 BSP 替代方案 标识色建议
红砖围墙 Wall_400x300 组合 + MI_DevRed 红
绿色铁门/木门 RotativeDoor_01 + MI_DevGreen 绿
小卖部招牌 Cube 缩放为薄长条 + MI_DevBlue/Orange 蓝/橙
卷帘门 GarageDoor_01 + MI_DevGray 灰
玻璃柜台 Cube 缩放为扁长方体 + MI_DevGlassWhite 透明白
老式冰柜 Container_Normal 缩小 + MI_DevWhite 白
金属货架 Fence_Small 排列 + MI_DevGray 灰
公用电话亭 Cube+Cylinder 组合 灰
电线杆 Cylinder 高缩放 + MI_DevGray 灰
晾衣杆 Beam_300 + Cylinder 支撑 + MI_DevWhite 白
铁栏杆窗户 WallWindow + Beam 细条前置 灰
水泥路裂缝 Floor + MI_DevGray + Decal 贴花 灰
积水坑 Floor 嵌入地面 + MI_DevGlassBlue 天蓝
水塘水面 Floor_1000x1000 + MI_DevSkyBlue/GlassBlue 天蓝
芦苇/杂草 多个小 Cylinder 不同角度 + MI_DevFoliage 草绿
施工围挡 BarricadeWall_200/400/600 + MI_DevBlue 蓝
垃圾桶 TrashCans_01 + MI_DevGreen 绿
老式自行车 Car01 缩小至 ~50% 或 Primitives 组合 黑
弹珠/小物件 Sphere 缩小至 ~2cm 彩色
老式冰箱 Barrel 竖放或 Cube + MI_DevWhite 白
大脑袋电视 Monitor_01 + MI_DevGray 灰
水塔/工业设备 Cylinder + CylinderBend 组合 灰/棕
平房屋顶 Floor 覆盖 + MI_DevBrown 棕
台阶 Stair_100 或 Ramp 灰
围墙门洞 WallDoor_200x300 + RotativeDoor 红