starmen1265
0f96b79dba
两阶段流水线：搭建指南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>
45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
---
|
||
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）
|