TornLux/UnrealBridge

解决的问题

UnrealBridge 解决了 AI 智能体（如代码助手）无法直接、可靠地检查和修改 Unreal Engine 项目的问题。它提供了一个结构化的桥接器，为智能体提供了一套类型化的操作（通过 Python 函数），用于查询和编辑资产、蓝图图表、动画、Niagara 特效等，并支持实时更新和撤销功能。

工作原理

该桥接器作为插件在 Unreal Editor 中运行。它启动一个本地服务器，智能体的 Python 客户端通过 TCP 连接到该服务器。智能体以 Python 代码的形式发送命令，桥接器会根据生成的包含 26 个库中 1388 个可用函数的清单，在本地（使用 AST 预检）对命令进行验证，从而在命令到达编辑器之前捕获错误。命令在游戏线程上执行，并将结果返回。该桥接器还支持响应式事件订阅，因此智能体可以在事件发生时收到通知，而无需轮询。一套桥接库涵盖了动画、蓝图编辑、Niagara VFX、资产管理等特定领域。

适用对象

适用于开发者和 AI 辅助工作流，当基于 LLM 的智能体（如 Claude Code、Codex、Gemini CLI 等）需要在 Unreal Engine 项目中执行复杂任务时——例如创建动画蓝图、设置 Niagara 特效、编辑蓝图图表或验证游戏玩法。它专为 Windows 上的交互式编辑器会话而构建，支持 UE 5.3+。

亮点

• 基于 AST 的幻觉防御：预检解析 Python 代码并根据清单进行检查，在测试中将桥接调用失败率从 24% 降低到 16%。
• 深度资产结构内省和写入操作：提供用于动画、蓝图图表、Niagara 等的库，并配备自动布局和质量工具。
• 响应式事件订阅：智能体可以订阅引擎事件并获取回调，无需轮询。
• 原生 Python 执行：涵盖 26 个库中的 1388 个函数，所有操作都封装在事务中以支持撤销/重做。
• 与 Agent Skills 轻松集成：为遵循 Agent Skills 开放标准的 Claude Code 和其他运行时提供技能支持。