unreal-harness

# Unreal Claude 集成工具 用于虚幻引擎和 Claude 代码的多功能集成工具。 不是另一个 MCP。 # 不是另一个 MCP 该项目允许 Claude 代码使用： 1) [**虚幻编辑器操作**](./docs/USAGE.md) [^1] 来处理界面上的几乎所有内容 2) **多模型多模态** [^2] 来查看和测试视觉效果 3) **AWS、TypeScript 和 Pulumi** [^3] 来支持多人游戏 4) **Neo4j 用于蓝图和图表** [^4] 5) **GIMP** [^5] 图片编辑器 6) **开源示例游戏** [^6] 7) *并行性* 和一些锁定原语用于同时运行的代理 8) **自定义技能** - 具有精心策划和指导的技能，适用于： - `/onboard` 和 `/bootstrap` - 设置您的机器以进行 UE 开发并建立新游戏 - `/architect` - C++ 前向架构和品味 - `/docs` - 文档和规范驱动的设计 - `/see` 和 `/capture-pose` - 来自编辑器或 PIE 的视觉反馈和捕捉 - `/automated-tester` - 自动无头和 UI 测试及捕捉驱动的循环 - `/position` - 编辑器内和游戏中的空间推理 - `/networking` - 多人网络指导/调试 - `/gamelift` - 专用服务器托管和匹配指导 - `/npc_logic` - 状态树和感知系统指导 - `/refactor` - 多种形式的 Claude 代码驱动的重构循环 - `/build` - 创建构建和分发 ... **及其他**，并且不断增长。 在我用于指导 MCP 开发的实际游戏项目中，我经常使用大约 40 个技能。 9) **截图和视频捕捉** 即将在我的另一个项目中推出： 9) **SteamSDK** 和 **Epic Online Services** 工具和示例 10) **网格生成** && **动画生成** 11) **Blender** 支持 使用其自己的 TypeScript/C++ 虚幻引擎 MCP，而不是官方的 Epic Games MCP。 与 UE 5.7 兼容。 ## 操作截图：编辑器和示例游戏 <table> <tr> <td width="50%"><video src="https://github.com/user-attachments/assets/7259fcfe-263e-405f-a77e-406d1d5c7b67" width="400" muted playsinline controls></video></td> <td width="50%"><video src="https://github.com/user-attachments/assets/07cee163-6330-4b84-abee-7f159f515ee6" width="400" muted playsinline controls></video></td> </tr> </table> ## 安装和运行 假设您已经拥有 [**Bun**](https://bun.com/get)、[Claude 代码](https://code.claude.com/docs/en/quickstart) 和 [**虚幻引擎**](https://www.unrealengine.com/download)： ```bash git clone https://github.com/oliver-io/unreal-harness cd unreal-harness bun install bun run mcp claude # 请求 claude 进行 /onboard - 它会调查您的机器，询问最小或完整安装，并引导您完成自动或手动安装 ``` 这会在 `http://127.0.0.1:8765/mcp` 启动 MCP 服务器。 打开虚幻引擎并启用插件，桥接器就会在 `127.0.0.1:55557` 上启动。 ### 依赖项 **最小** - 足以驱动具有所有约 260 个工具的实时编辑器 - 只需要 Bun、虚幻引擎、git 和 C++ 工具链，UE 可以用它编译（在 Windows 上，即带有“C++ 游戏开发”工作负载的 VS 2022）。 所有其他内容都是可选的，并且每个功能都是按需的：`uv` 用于测试套件，Gemini 密钥用于视频分析和视觉批评，OpenAI 密钥 + Python 用于 AI 艺术，GIMP 用于分层 UI 管道，Docker + Neo4j 用于图形投影，Pulumi + AWS CLI 用于托管。 `/onboard` 会检测您拥有的内容，询问您想要的内容（最小/完整/按需选择），并在您同意的情况下从官方源安装缺失的部分 - 完整的矩阵位于 [onboard 技能的依赖文档](.claude/skills/onboard/DEPENDENCIES.md) 中。 [^1]: 大多数基本的编辑器操作都已暴露在 MCP 下。 许多操作都经过了增强，具有验证和指导功能，以便 Claude 不会重复常见的错误（例如，它在空间推理方面存在困难）。 [^2]: 可选地使用 Gemini 和 OpenAI 进行图像审查和生成。 这允许集成创建、查看和分析图像。 [^3]: 用于多人游戏或分发的部署。 连接并引导使用 TS/Pulumi/AWS 来建立游戏、网站、队列、外部服务、专用服务器托管等的堆栈。 这意味着玩游戏的门槛可以降低到“使其值得玩”的程度。 [^4]: 将蓝图和 UE 图形结构转储到 Neo4j 中，并具有丰富的本体论，以理解大型蓝图结构（例如动画蓝图、状态机、状态树等）或第三方 BP 集成。 关键在于，这些都通过 Neo4j 中的边与 UE 外部引用交叉链接，而不是简单的數據转储。 [^5]: 用于 2D 纹理和资产。 可选地能够使用 GIMP 并理解层以构建复杂的 UI 小部件、HUD 等，无论是手动（您可以跳过复杂的导出链并让 Claude 处理它们）还是其他方式。 GIMP 通过 [maorcc/gimp-mcp](https://github.com/maorcc/gimp-mcp) 驱动，这是一个外部 GIMP 3.2 MCP 服务器 - `/onboard` 文档介绍了设置。 [^6]: HOVERBALL，本存储库中的示例游戏。 您可能开始看到，这并不是真正的 MCP。 这是一套厚重的集成工具，其中一些工具非常有意见，但仅因为 *我需要时就创建了它们。* 就像您应该构建您想玩的游戏一样，您也应该构建您需要的工具来完成它（如果它们尚不存在，对于我来说，它们并不存在）。 # 它做什么？ 它的目的是将我的软件工程技能转移到游戏开发中。 不要误会：我不是虚幻引擎专家，这就是重点（您也不需要成为专家）。 如果您是专家，那么这可能对您来说非常酷，尤其是如果您已经知道如何使用 Claude 代码。 本质上，它是一套工具，暴露出指导和虚幻引擎级别的功能。 它编码了刻意的、有意见的流程，例如测试方法和网络偏好。 这样做是为了让这个存储库能够让非专家完成制作看起来很好、感觉良好的游戏的过程 - 并将它们交付到分发和生产中 - 而不需要花费大量时间学习工具层。 # 是 AI 垃圾吗？ 我是说，如果你想的话。 但我不是这里的门槛；你已经可以获取 Claude 代码，并要求它连接到 UE 的公开 TCP 服务器，并让你制作一些没人想要的游戏。 我不会阻止你这样做，也不会阻止你使用我的工具，以更方便的方式做到这一点。 ## 没有足够的时间学习一切 我通常很忙于工作、生活、乐器、软件爱好项目、房屋周围的爱好项目。 生活总是很忙。 我有很多游戏想法，但大多数我甚至没有开始。 您（读者）可能会喜欢其中一些，如果我制作了它们；其他人可能不会。 如果我 **从未将想法变成游戏**，您就永远不会知道。 我觉得你们中的很多人都和我一样。 也许和我一样，您甚至尝试过但未能掌握 UE（或其他游戏引擎）的专业知识，原因很充分，它是一个密集的工具。 我懂代码。 我对待这个集成工具就像对待一个知道 UE 的朋友或同事一样，这就是我所需要的。 # 文档 文档将随后发布。 目前，Claude 是您理解如何使用它的最佳资源，因为它在集成工具本身中已经有很好的文档记录。 # 示例游戏 我包含了一个小/大型示例游戏与存储库一起。 这很有用，因为它允许您的 Claude 代码会话查看结构、代码，甚至可能查看完整游戏的运行时。 这可以让它避免某些一开始就不明显的陷阱，或者只是为您提供一个坚实的基础来开始，如果您的游戏架构类似。 ## 示例游戏资产 目前正在添加 HOVERBALL 中付费和许可资产的存根。 因为我为这些付费了（下面的资产积分），所以我无法将它们包含在游戏的开源版本中，这意味着您在示例游戏中加载某些内容（例如摩托车）时可能会看到“盒子”类型的体验。 当这项工作完成后，您应该能够从源代码检出直接在 UE 引擎中打开 HOVERBALL。 然而，目前，我只包含了游戏的 C++、TypeScript 服务层和文档。 ## 示例游戏结构 示例游戏文档仍在分发中。 ## 示例游戏托管/多人游戏 请查看。 它位于 [HOVERBALL.gg](https://hoverball.gg)，您可以下载它，排队参加游戏，并亲自玩。 您甚至可以提出问题或贡献，它并不完美，但它是一个功能齐全的游戏。 ### 游戏内身份验证和签名 游戏的身份验证很棘手。 我可能会在某个时候推出 OAuth 提供程序，因为通过 Steam 或 Epic Online Services 进行身份验证需要法律文件、审查期和批准，这些会阻止像演示概念这样的东西立即分发。 当然，不建议安装随机游戏。 我正在努力获取证书[^7]来签署安装程序等，但在那之前，您可能需要信任 Some Guy 的真实性来玩 HOVERBALL。 如果您信任，我可以忽略 **未知发布者** 警告。 承诺不会用恶意软件攻击您。 [^7]: 给 Windows 二进制文件签名出乎意料地麻烦。 这些是我试图避免学习的事情，但 *c'est la vie* 在游戏开发中。 # 它完美运行吗？ 不！ 这个项目正在积极地进行中。 我可以被鼓励为星星、点赞、浏览量、啤酒、良好的祝愿、积极的氛围和批评者工作得更努力。 是的，没错，批评者也可以。 我会随着每个互联网批评者的反馈而变得更强大。 我的争议将像一朵非常漂亮的花一样绽放。 给我你的愤怒，或者只是建设性的批评，这也很有帮助。 # 注意事项、警告和未完成的工作 - 我尚未对一些 AWS 内容进行彻底的安全审查，因为它主要用于测试您的游戏。 如果您想推进到合法的生产环境，您需要做更多的工程设计。 我有一个战术中世纪大型多人在线角色扮演游戏（*lmfao*），我正在开发，它有一个完整的堆栈，我将逐渐将模式移植到这个存储库中。 - Claude 经常会搞砸很多事情，所以不要以为您可以一劳永逸地制作 GTA6。 您会发现制作复杂的游戏仍然很难，因为它们很复杂。 - 我将这个集成工具移植到一个更厚、更有意见的游戏项目中。 可能有一些残留物和糟糕的说明，但我将切换到以这个存储库作为自己的食物，并修复问题。 # 测试 很多东西都很难测试，但我确实使用了一些自动化测试来保持代理开发的正常进行。 正在积极改进。 # 许可证 MIT - 请参阅 [LICENSE](LICENSE)。 # 资产积分 [meshal.97](https://www.fab.com/sellers/meshal.97) - 摩托车 [SpectraMotions](https://www.fab.com/sellers/SpectraMotions) - 摩托车动画 [Harhtif](https://www.fab.com/sellers/Harhtif) - 无人机 [VFX Vault](https://www.fab.com/sellers/VFX%20Vault) - 爆炸特效 # 故障排除、贡献和抱怨 - 打开问题或拉取请求，我会修复它，如果它被破坏了 - 在 Twitter 上关注 @oliver-io 来抱怨或欢呼 - 在城镇周围找到我 祝您使用虚幻引擎编辑器时好运，玩得开心！