用UE5-MCP一句话描述,搭出一个UE5关卡

用UE5-MCP一句话描述,搭出一个UE5关卡

【免费下载链接】UE5-MCPMCP for Unreal Engine 5项目地址: https://gitcode.com/gh_mirrors/ue/UE5-MCP

第一次打开 UE5-MCP 仓库,你可能会困惑:整个项目没有一行可运行的代码,只有15份 Markdown 文档。但这恰恰是它最有价值的部分:如果你试过"用一句话描述场景、让 AI 把关卡搭出来",就知道把 Blender 和 UE5 之间的链路自己拼起来有多麻烦——Blender 不会生成、UE5 接不住、导入后材质丢纹理。UE5-MCP 把这条链路完整整理了出来,从场景生成、资产导入、关卡自动化到蓝图脚本,命令形式、配置项、坑点全都有。

一句话看懂 UE5-MCP

它是一套"AI 关卡设计"工作流文档,基于 MCP(Model Context Protocol)+ BlenderMCP 技术栈,给想搭 AI 关卡流水线的开发者用。README 里官方也坦率说明:因时间限制项目没有继续推进,但文档可以直接拿来用。所以它不提供一个开箱即用的软件包,而是给你一整套命令形式(如mcp.generate_scene、mcp.generate_terrain)、配置样例和排查清单,照着就能开工。

UE5-MCP 能帮你做什么

一句话描述,Blender 生成场景

你输入一句自然语言,它给你一整个场景。比如mcp.generate_scene "A medieval village with a castle and a marketplace.",AI 会解析句子里的空间关系、摆放物体并自动贴纹理,还能接入 PolyHaven 免费资产库用真实模型。接着可以继续微调:mcp.add_object "tree" 5.0 2.5 0.0在指定坐标放一棵树,mcp.generate_texture "rock_model" "mossy stone"给模型贴上青苔石纹理。场景满意后,一条命令导出 .fbx,UE5 直接就能导入。

UE5 里一键铺关卡

你输入地形尺寸和资产数量,它给你一个能跑的关卡骨架。mcp.generate_terrain 1000 1000 "high"生成 1000×1000 的高细节地形,mcp.populate_level "trees" 500再往关卡里撒 500 棵树,全程不用手动摆放。配置文件里两个数字还能改变结果:auto_populate决定要不要自动铺满,npc_spawn_density(0 到 1)控制 NPC 密度。完整命令清单在 commands.md,端到端流程另附一份 workflow 文档可对照。

让 AI 写蓝图

你输入一句玩法逻辑,它给你一个 Blueprint。比如mcp.generate_blueprint "A door that opens when the player interacts.",系统帮你搭节点图;跑不通时用mcp.debug_blueprint检查缺线的节点。关卡做完后,mcp.profile_performance "desert_map"会分析关卡性能,给出灯光、多边形数这类优化方向。

🚀 装好 UE5-MCP 只需 3 条命令

第一步,克隆仓库并安装 Python 依赖(清单来自文档):

git clone https://gitcode.com/gh_mirrors/ue/UE5-MCP pip install numpy scipy pillow requests openai unrealcv

第二步,开插件:UE5 的 Edit → Plugins 里启用 Python Editor Script Plugin 和 PCG Framework,重启编辑器;Blender 的 Edit → Preferences → Add-ons 里启用 Node Wrangler。

第三步,在 Blender 里跑第一句mcp.generate_scene "A forest with a waterfall"。跑通后,你会在视口里看到物体逐个出现、纹理贴上,整条链路就算跑起来了。前提:Blender 3.x、UE55.1+、Python 3.x,文档建议16GB以上内存,AI 功能需要 OpenAI API Key。

⚠️ 翻车了先看这里

如果你执行mcp命令完全没反应,大概率是环境没搭起来:mcp.xxx 是这套文档定义下来的命令形式,要基于 BlenderMCP + UnrealCV 的栈才能跑。先用python --version确认 Python 在,再重装依赖,最后查mcp_config.json有没有配错。

如果资产导入 UE5 后材质或纹理丢了,大概率是导出时没打包纹理。导出时加上--include-textures(如mcp.export_asset "house_model" "fbx" --include-textures),再确认 Blender 里纹理路径是相对路径。

如果 UE5 里检测不到 MCP,大概率是 Python Editor Script Plugin 没启用:去 Edit → Plugins 里勾上并重启编辑器。AI 功能不工作时,检查mcp_config.json里的provider和api_key是否正确,详细排查步骤在 troubleshooting.md。

想搭自己的 AI 关卡流水线却不知道从哪下手,就把这 15 份文档通读一遍,命令形式、配置项、常见坑都写在里面,读完就能动手:

git clone https://gitcode.com/gh_mirrors/ue/UE5-MCP

【免费下载链接】UE5-MCPMCP for Unreal Engine 5项目地址: https://gitcode.com/gh_mirrors/ue/UE5-MCP