TornLux/UnrealBridge

它解决了什么问题

UnrealBridge 提供了一个结构化的接口，使 AI 代理能够实时控制和编辑 Unreal Engine 编辑器。它弥合了代理的高层级请求与 Unreal Engine 复杂且通常私有的内部 API 之间的差距，通过严格的验证和类型化的操作界面，降低了代理驱动修改的失败率。

它如何工作

该系统由一个适用于 Unreal Engine (5.3+) 的 C++ 插件和一个基于 Python 的客户端组成。代理通过 Python 命令行接口 (bridge.py) 与系统交互，该接口基于 AST 执行「预检」检查，对照包含 1,388 个可用函数的清单，提前捕获幻觉和参数错误，然后通过 TCP/JSON 将命令发送到编辑器。在 Unreal Engine 内部，服务器将这些命令分发到 GameThread，通过原生 Python API 或专用的 UnrealBridge*Library C++ 包装器执行。该桥接还支持反应式事件订阅，使编辑器能够主动通知代理事件（如资产变更或 Actor 生命周期事件），而无需轮询。

适用于谁

此工具专为需要可靠方式以编程方式操作 Unreal Engine 资产、蓝图和世界状态的游戏开发、自动化测试和 NPC 原型设计的 AI 代理开发者而设计。

主要亮点

• 幻觉防御：使用本地 AST 解析和函数清单在命令到达引擎前进行验证，显著降低调用失败率。
• 深度资产内省：提供对动画蓝图、状态机和资产依赖树的全面读写访问。
• VFX 和绑定工作流：专用于创建 Control Rig 层级、IK 重定向器和 Niagara VFX 系统的库。
• 蓝图质量工具：包含高级图谱操作工具，如自动布局、孤儿/未命名节点的 lint 检查，以及将子图提取为函数。
• 反应式事件系统：支持对 GAS 事件、属性变更和编辑器端资产修改的主动回调。
• 原生 Python 集成：结合 26 个专用库与对 unreal.* API 的直接访问，所有操作均封装在事务中，支持完整的撤销/重做功能。