企业官网建设流程全解析

UE5-MCP 安装与使用：一句话生成场景并导入 UE5 关卡

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

UE5-MCP 是一个基于模型上下文协议的自动化工具，把 AI 指令接入 Blender 和 Unreal Engine 5：一句话生成场景、导出 fbx、批量摆置关卡、生成蓝图。它解决的是关卡搭建慢、资产搬运丢材质的两个老问题，适合熟悉 Blender 或 UE5 任意一端、想加快关卡生产流程的开发者。

它解决什么问题

• 手工摆关卡最耗时间：几百棵树、几十块石头要手动放，而mcp.populate_level "trees" 500直接把数量写进命令。
• Blender 和 UE5 之间的资产搬运容易丢材质：Blender 端导出.fbx、.obj或.gltf，UE5 端由 MCP 处理导入并自动贴纹理、分配材质。
• 蓝图逻辑要连节点：mcp.generate_blueprint "A door that opens when the player interacts."一句话生成"玩家交互开门"的蓝图。

🚀 从零跑起来

先备环境：Blender 3.x 或更高、UE5.1 或更高、Python 3.x，内存 16GB 以上、带独立显存的 GPU（推荐 NVIDIA RTX 30 系以上）。

第一步，克隆仓库并装好 Python 依赖：

git clone https://gitcode.com/gh_mirrors/ue/UE5-MCP cd UE5-MCP pip install -r requirements.txt

第二步，两边各启用一次插件：Blender 里Edit → Preferences → Add-ons打开 MCP 插件和 Node Wrangler；UE5 里Edit → Plugins打开 Python Editor Script Plugin、UnrealCV Plugin、PCG Framework，启用后重启 UE5。

第三步，把 OpenAI API key 写进~/.mcp/ue5_mcp_config.json（Blender 端用同目录下的blender_mcp_config.json）。完成后运行mcp.list_commands，能看到命令列表就说明装好了。

🧪 一个真实任务：一句话到 UE5 关卡

任务：在 Blender 里生成一座迷雾森林里的城堡，再放进 UE5 的地形上。

打开 Blender 并加载 MCP 插件，执行下面三条命令——先生成场景，再补一棵树，最后把城堡导出成 fbx：

mcp.generate_scene "A medieval castle in a misty forest, moss-covered stone walls" mcp.add_object "tree" 5.0 2.5 0.0 mcp.export_asset "castle" "fbx" "./exports/castle.fbx"

你会看到：视口里出现按描述搭建的城堡和迷雾森林，树落在坐标 (5.0, 2.5, 0.0) 处；./exports/下多出一个带纹理的castle.fbx。想换画风不必重写句子，改配置里的default_style为cartoon或sci-fi再跑一次即可。

把castle.fbx导入 UE5，接着生成地形并批量摆树：

mcp.generate_terrain 1000 1000 "high" mcp.populate_level "trees" 500

关卡编辑器里会出现一块 1000×1000 的地形，500 棵树随机分布其上。可微调的位置：default_terrain_size改地形尺寸，npc_spawn_density以 0.0–1.0 控制密度，dynamic_lighting关掉能省性能。最后用mcp.profile_performance "level_name"查一下这个关卡的性能瓶颈。

AI 能懂的描述怎么写

mcp.generate_scene吃的是完整句子，不是关键词堆砌。文档示例都按"主体 + 环境 + 氛围 + 细节"的顺序写：

• 错误示范：mcp.generate_scene "cool"——没有主体、环境、风格，AI 只能瞎猜。
• 正确示范：mcp.generate_scene "A futuristic city with neon lights and flying cars."——城市是主体，霓虹是氛围，飞车是细节，每个词都落在具体属性上。

三条技巧：

1. 用完整英文句子描述，一条命令只写一个场景。
2. 参数拿不准时，先mcp.list_commands看清单，再mcp.help "command_name"查具体参数格式。
3. 风格不对先改配置而不是改句子：default_style（realistic / cartoon / sci-fi）和terrain_detail（low / medium / high）都在 Blender 配置文件里。

踩坑速查

命令找不到 → mcp 不在 PATH，或虚拟环境没激活 → 用echo $PATH检查，source venv/bin/activate激活环境。

场景不生成 → Blender 插件没加载，或blender_mcp_config.json没配对 → 启用插件并重启 Blender；给命令加--debug看具体报错。

导出资产到 UE5 后掉纹理 → 纹理没有打包 → 导出时加--include-textures，并回 Blender 核对纹理路径。

UE5 检测不到 MCP → Python Editor Script Plugin 没开 →Edit → Plugins里打开并重启 UE5。

接下来去哪

完整命令清单在 commands.md，Blender 到 UE5 的五步完整流程在 workflow.md，导出格式、纹理分辨率（1K–8K）、LOD 层级等所有配置项在 configurations.md，出问题时先翻 troubleshooting.md。需要说明：README 中作者表示因时间所限项目未继续推进，仓库目前以这套文档为主要参考。从 commands.md 里挑一条命令在 Blender 里跑通，再回头读配置，是最短的上手路径。

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