---
name: level-builder-tool
description: 白模关卡自动生成 Python 脚本工具，位于 tools/level-builder/
metadata:
  type: project
---

# Level Builder 工具

## 位置
`tools/level-builder/`

## 功能
两阶段流水线：解析搭建指南 Markdown → JSON → UE5 Actor

## 使用方式
```bash
# 解析
python tools/level-builder/main.py parse -i docs/technical/关卡-v01-搭建指南.md -o output/level_v01.json

# 验证
python tools/level-builder/main.py validate -i output/level_v01.json

# 报告
python tools/level-builder/main.py report -i output/level_v01.json -o output/搭建报告.md
```

## UE5 构建
在 UE5 编辑器 Python 控制台中：
```python
exec(open(r"tools/level-builder/main.py").read())
# 然后 main(["build", "-i", "output/level_v01.json"])
```

**Why:** 替代手动白模关卡搭建流程，从策划执行案/搭建指南自动生成关卡
**How to apply:** 收到白模搭建任务时，优先运行此工具而非手动操作

## 依赖
- UE5 PythonScriptPlugin 已在 .uproject 中启用
- 37 种 BSP 资产映射（config/asset_mapping.py）
- 当前解析搭建指南（parsers/build_guide_parser.py），未来扩展执行案解析器

## 数据
- v0.1 解析结果：265 个 Actor（STR:123, PROP:53, BND:61, INTR:10, COLL:9, LGT:8, PLAY:1）