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>
This commit is contained in:
2026-06-07 23:03:45 +08:00
parent 8011cb6472
commit 0f96b79dba
74 changed files with 10468 additions and 109 deletions
+1
View File
@@ -0,0 +1 @@
- [Level Builder Tool](level-builder-tool.md) — 白模关卡自动生成 Python 脚本(tools/level-builder/,265 Actor 解析验证通过)
@@ -0,0 +1,44 @@
---
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)