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>
1.3 KiB
1.3 KiB
name, description, metadata
| name | description | metadata | ||
|---|---|---|---|---|
| level-builder-tool | 白模关卡自动生成 Python 脚本工具，位于 tools/level-builder/ |
|
Level Builder 工具
位置
tools/level-builder/
功能
两阶段流水线：解析搭建指南 Markdown → JSON → UE5 Actor
使用方式
# 解析
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 控制台中：
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）