Unreal MCP Study

虚幻MCP实践

在Unreal Engine上使用MCP练习PCG节点和图形的学习库。

与制作复杂的游戏相比，该报告的重点是反复练习将Unreal Editor和MCP连接起来，然后创建PCG Graph并添加/修改/调试基本节点的流程。

这次回购是为了什么

• 熟悉Unreal Engine MCP工作流
• 练习PCG Graph生成和节点编辑流
• 使用MCP快速执行重复的PCG实验
• 在没有结果时熟悉检查点

执业范围

本报告首先涵盖以下内容：

• Unreal Editor与MCP连接
• 验证PCG插件的激活
• 生成PCG图形
• 添加和连接基本PCG节点
• 调整参数
• 调试结果

初始练习节点基于以下三个节点进行：

• Surface Sampler
• Scatter
• Transform Points

需求

• 虚幻引擎 5.x
• MCP自动化桥
• 编辑器脚本工具
• 共轭梯度

根据需要，可以使用以下插件。

• 尼亚加拉
• 级别序列编辑器
• 控制装置
• 几何脚本

项目设置

在开始PCG实践之前，首先需要准备Unreal Editor。

1. 创建或打开Unreal项目。
2. PCG 激活插件。
3. Editor Scripting Utilities激活。
4. MCP Automation Bridge项目 Plugins/在中安装。
5. 重新启动编辑器。
6. 验证MCP连接是否可用。

环境变量

例子:

• UE_PROJECT_PATH
• MCP_AUTOMATION_HOST=127.0.0.1
• MCP_AUTOMATION_PORT=8091

练习流程

建议的练习顺序如下：

1. 确认Editor连接
2. 检查PCG插件准备情况
3. 生成PCG图形
4. 添加和连接基本节点
5. 调整参数
6. 调试结果

存储库结构

• docs/setup.md\

整理Unreal Editor和MCP连接的准备过程。

• docs/troubleshooting.md\

清理连接失败、插件问题、未输出结果等问题。

• docs/exercises/\

留下可以按照顺序进行的PCG实践文档。

• prompts/\

下面是可以直接复制到MCP的提示示例。

• checklists/\

记录实习前的准备情况和实习后的确认事项。

学习目标

该报告的目标不是从理论上深入解释PCG，\ 通过MCP在Unreal Editor中多次快速重复PCG操作。

也就是说，熟悉下一个流程是关键。

• 连接
• 制造
• 受精
• 再次确认
• 不行就调试

常见问题

第一次设置时经常遇到以下问题：

• MCP Automation Bridge插件列表中看不到
• 需要构建C++插件
• Unreal Editor正在运行，无法编译模块
• 虽然创建了PCG Graph，但看不到结果
• 节点已连接，但未创建示例点

这种情况。 docs/troubleshooting.md将在中整理。

后续步骤

初始练习稳定后，可以向下扩展。

• 更多PCG节点实践
• 基于地形/网格的PCG测试
• Seed，Density，Bounds比较实验
• 以调试可视化为中心的实践
• 添加示例练习映射

最新更新：简单防御原型

最近，除了MCP练习之外，我们还添加了一个非常简单的基于C++的防御原型。

• MCP_Study 添加运行时模块和目标文件
• DefenseGameMode, DefenseEnemy, DefenseTower 实施游戏类
• 波形赞助商，塔式自动攻击，添加分数/波形增加逻辑
• 实施敌人攻击塔，塔体力为0时被摧毁。
• 在塔式机顶部显示基于三维网格的体力条（背景/笔）
• 防御测试图 Content/Maps/Defence.umap 添加

执行提示：

1. 在Unreal Editor中打开项目后Compile
2. Defence 打开映射
3. PIE运行后检查塔式机与敌人的交互和体力条的变化