# Unreal MCP 五方块小场景任务书

本站原创教学任务，2026-10-13。目标值不是执行记录。本材料没有运行 Unreal 编辑器、模型或场景创建。

## 环境与范围

- 依据 UE 5.8 官方 Experimental Unreal MCP 插件文档；版本与工具以本机为准。
- 使用独立练习项目。先手动保存或复制基础关卡到 /Game/Tutorials/L_QR_MCP_Blockout；已有同名路径时先选新的练习路径并同步本任务书。
- 原关卡与工程保留备份；只创建或调整五个 QR_Tut_ 前缀任务对象。
- 使用基础 Cube 或本机实际可用的等效方块，沿用基础关卡灯光。不修改蓝图、工程配置、其他 Actor 或外部资产。

## 坐标与尺寸

默认长度为 cm；旋转目标均为 0 / 0 / 0 度。若项目单位改动，先明确换算。
位置是世界坐标中心，尺寸是目标包围盒 X / Y / Z；不能将厘米直接当作 Scale。
先确认当前基础方块实际尺寸及工具单位，再计算缩放，逐项读回。

| 标签 | 中心 X / Y / Z（cm） | 尺寸 X / Y / Z（cm） |
| --- | --- | --- |
| QR_Tut_Floor | 0 / 0 / -5 | 600 / 600 / 10 |
| QR_Tut_Pedestal | 0 / 0 / 30 | 120 / 120 / 60 |
| QR_Tut_Backdrop | 0 / 160 / 90 | 300 / 10 / 180 |
| QR_Tut_Left | -150 / 0 / 10 | 20 / 20 / 20 |
| QR_Tut_Right | 150 / 0 / 10 | 20 / 20 / 20 |

## 执行与验收

先读取实际工具集与 schema。找不到创建、命名、设置变换或读回能力时记录缺项，改用手动编辑器操作，不编造函数名。
一次调用结束后才发起下一次；超时先查询现状，避免重复创建。
每个标签恰好一项，位置与尺寸在本练习 ±1 cm 容差内；容差是教学规则，不是引擎能力承诺。
地面上表面位于 Z=0；其他四个方块底部位于 Z=0。多个角度查看悬空、穿插与重复对象。
在 acceptance.csv 填写实际值、工具返回或本人截图证据；目标 CSV 不能复制成实际值。

## 保存与回滚

验收通过后仅保存练习关卡，并记下路径与修改清单。
未通过时保留失败原因，回到手动保存的备份；不删除未知资产或其他关卡。
结束练习可执行 ModelContextProtocol.StopServer；如果不希望下次自动启动，另关闭 Auto Start Server。

## 官方依据

https://dev.epicgames.com/documentation/unreal-engine/unreal-mcp-in-unreal-editor
https://dev.epicgames.com/documentation/en-us/unreal-engine/units-of-measurement-in-unreal-engine