该技能是 Unreal Engine 5.9 上使用 MCP(Model Context Protocol)的实战经验层,不是 Epic 的官方参考文档。当它与官方文档在工具名称或参数上不一致时,建议在运行中的服务器上执行 describe_tools 并以实际结果为准。
用途:通过编辑器内置的 Unreal MCP 服务器(插件 ModelContextProtocol)把编辑器的工具集暴露给 AI 智能体,使智能体能够创建项目、编写编辑器脚本、导入资产、驱动游戏、验证规则、录制画面并打包发布。技能适用于 UE 5.9;在 UE 5.8 上应改用 unreal-5-8 技能,因为其中的 Python 工具、截图工具和辅助脚本在 5.8 不工作。
主要能力与组织方式:SKILL.md 说明方法、常见陷阱与核心原则;references/ 目录按任务拆分文件,包括 setup-and-lifecycle.md(新项目、启动、日志、握手、.mcp.json)、editor-python.md(编辑器脚本、关卡、PIE、回读)、drivable-game.md(C++ 测试钩子、探针、编译检查、无头运行)、import-and-materials.md(导入 .glb 网格、角色与动画片段、插槽、材质、天空)、animation.md(C++ 动画、交叉淡入淡出、受击时序、骨骼限制)、hud-and-input.md(菜单与 HUD、键盘/手柄/触摸、手机安全区)、sound.md(导入声音并用录音检查)、capture-and-recording.md(截图、曝光、构图、帧率、逐帧素材)、sharing-an-editor.md(多个智能体会话共用一个编辑器与代码检出)、packaging.md(Mac 独立应用、iPhone 构建与签名)、web.md(Wasm/WebGPU 网页构建、托管与游玩统计)、from-5.8.md(从 5.8 迁移及尚未重跑的 5.8 经验)。
使用方式(基于资料整理):在 macOS 上先构建编辑器目标,再前台启动编辑器(服务器自动在 127.0.0.1:8000/mcp 启动),用 scripts/ue_wait.sh 等待就绪,随后通过 scripts/uemcp.py info 与 py 子命令进行首次调用。.uproject 需要启用 ModelContextProtocol(默认开启)、AllToolsets 和 PythonScriptPlugin。技能提供两级接口:随附工具集(用 list_toolsets/describe_toolsets/describe_tools 发现,用 call_tool 调用)和 execute_python(完整编辑器 Python,可使用 unreal 模块、顶层 await,并可在脚本内调用 call_tool)。多数实际工作通过 execute_python 完成。
适用场景:希望让 AI 智能体参与 UE 5.9 游戏从灰盒到可玩、带菜单/HUD/声音/多设备输入、再到 Mac/iPhone/Web 打包的完整流程;也适合需要建立可脚本化验证(模拟按键、探针读取、回执 JSON)的团队。
限制与注意事项(资料明确提及):UE 5.8 不适用;编辑器是单进程单游戏线程,MCP 为串行通道,并非批处理管线;服务器响应不代表编辑器可用(隐藏模态对话框会冻结游戏线程),编辑器运行也不代表服务器存在(端口绑定失败时编辑器仍可运行);返回值可能遗漏或误导(导入成功返回空列表、保存静默跳过、5.9 上删除返回 True 但未删除),需要回读位置、速度、规则判定、磁盘 PNG 等作为证据;手机和浏览器构建不使用 Lumen 或 Nanite,编辑器中的画面不等于打包后的画面;随附视频录制器在 Mac 上无法运行;C++ 工具集模板尚未针对 5.9 重新构建。价格、收费、平台支持范围等未在资料中说明,暂未提供。