TornLux/UnrealBridge

What it solves

UnrealBridge provides a structured interface that allows AI agents to control and edit the Unreal Engine editor in real time. It bridges the gap between an agent's high-level requests and the complex, often private, internal APIs of Unreal Engine, reducing the failure rate of agent-driven modifications through strict validation and typed operation surfaces.

How it works

The system consists of a C++ plugin for Unreal Engine (5.3+) and a Python-based client. The agent interacts with a Python CLI (bridge.py), which performs an AST-based "preflight" check against a manifest of 1,388 available functions to catch hallucinations and argument errors before the command is sent via TCP/JSON to the editor. Inside Unreal Engine, a server dispatches these commands to the GameThread, where they are executed via the native Python API or specialized UnrealBridge*Library C++ wrappers. The bridge also supports reactive event subscriptions, allowing the editor to proactively notify the agent of events like asset changes or actor lifecycles without polling.

Who it’s for

This tool is designed for developers building AI agents for game development, automated testing, and NPC prototyping who need a reliable way to programmatically manipulate Unreal Engine assets, blueprints, and world state.

Highlights

• Hallucination Defense: Uses local AST parsing and a function manifest to validate calls before they reach the engine, significantly reducing call failure rates.
• Deep Asset Introspection: Provides comprehensive read/write access to Animation Blueprints, state machines, and asset dependency trees.
• VFX and Rigging Workflows: Dedicated libraries for authoring Control Rig hierarchies, IK Retargeters, and Niagara VFX systems.
• Blueprint Quality Tooling: Includes advanced graph manipulation tools such as auto-layout, linting for orphans/unnamed nodes, and subgraph extraction into functions.
• Reactive Event System: Supports proactive callbacks for GAS events, attribute changes, and editor-side asset modifications.
• Native Python Integration: Combines 26 specialized libraries with direct access to the unreal.* API, all wrapped in transactions for full Undo/Redo support.