TornLux/UnrealBridge

解決的問題

UnrealBridge 提供了一個結構化的介面，讓 AI 代理可以即時控制和編輯 Unreal Engine 編輯器。它彌補了代理的高階請求與 Unreal Engine 複雜且通常私有的內部 API 之間的差距，透過嚴格的驗證和類型化的操作介面，降低代理驅動修改的失敗率。

工作原理

該系統由一個適用於 Unreal Engine (5.3+) 的 C++ 插件和一個基於 Python 的客戶端組成。代理與 Python CLI (bridge.py) 互動，該 CLI 會根據 1,388 個可用函數的清單進行基於 AST 的「預檢查」，在命令透過 TCP/JSON 發送到編輯器之前，捕捉幻覺和參數錯誤。在 Unreal Engine 內部，伺服器將這些命令分派到 GameThread，並透過原生 Python API 或專用的 UnrealBridge*Library C++ 包裝器執行。該橋接還支援反應式事件訂閱，讓編輯器能主動通知代理事件，例如資產變更或角色生命週期，而無需輪詢。

適用對象

此工具專為開發遊戲開發、自動化測試和 NPC 原型設計的 AI 代理的開發者設計，提供可靠的方式來程式化操控 Unreal Engine 的資產、藍圖和世界狀態。

主要特色

• 幻覺防護：使用本地 AST 解析和函數清單，在呼叫到引擎之前進行驗證，大幅降低呼叫失敗率。
• 深度資產探查：提供對 Animation Blueprints、狀態機和資產依賴樹的完整讀寫存取。
• VFX 與綁定工作流程：專用程式庫用於建立 Control Rig 層次結構、IK Retargeter 和 Niagara VFX 系統。
• 藍圖品質工具：包含先進的圖形操作工具，例如自動佈局、孤兒/未命名節點的靜態檢查，以及將子圖形提取為函數。
• 反應式事件系統：支援 GAS 事件、屬性變更和編輯器端資產修改的主動回調。
• 原生 Python 整合：結合 26 個專用程式庫與對 unreal.* API 的直接存取，所有操作皆包裝在交易中，支援完整的 Undo/Redo 功能。

這是一個能讓 AI 代理即時控制 Unreal Engine 的橋接層，透過 AST 驅動的驗證防止幻覺，並深度整合藍圖、VFX 和綁定工作流程。— @username