AI导哈

虚幻引擎MCP实践

一个用于练习Unreal Engine中MCP与PCG节点和图形交互的学习仓库。

  • by CastleBison
  • C++
  • 本地部署
  • 更新于
在 GitHub 查看 CastleBison/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运行后检查塔式机与敌人的交互和体力条的变化

相关 MCP