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:
@@ -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)
|
||||
Reference in New Issue
Block a user