Summary

UnrealBridge provides a typed control surface for Unreal Engine, enabling AI agents to introspect assets, author Blueprints/AnimBPs, and edit levels in real-time. It offers reactive event subscriptions and undoable writes, enhancing AI-driven content creation and automation.

How It Works

The system employs multi-layered safety: AST preflight validates agent scripts locally, type tracking and an optional kwargs-only wrapper prevent errors. Communication uses UDP for discovery and TCP for commands, with all write operations safely managed within Unreal Engine's transaction system for undo/redo. Approximately 1033 UFUNCTIONs across 22 libraries are exposed.

Quick Start & Requirements

Clone the repo, run link_agents_skills.bat (Windows) or equivalent symlink (Mac/Linux). Sync the plugin to your UE project via sync_plugin.bat. Launch your UE project; the plugin starts the server. Verify with bridge.py CLI (ping, exec).

Requirements

• Unreal Engine 5.3+ (some libraries require 5.7+)
• Python 3.9+ on PATH
• Visual Studio 2022 (specific MSVC versions for UE 5.3/5.4)
• Windows 10/11 (scripts are Windows-centric)

Highlighted Details

• AST-based Hallucination Defense: bridge_preflight.py validates calls against a manifest, reducing agent failure rates.
• Deep Asset & Blueprint Authoring: Libraries for AnimBP, asset dependencies, and Blueprint graph manipulation (layout, linting, commenting).
• Reactive Event Subscription: Agents subscribe to engine events for proactive callbacks, eliminating polling.
• PIE Runtime Control: Enables AI agents to interact with the game world during Play-In-Editor sessions.

Maintenance & Community

No specific details on maintainers, community channels, or sponsorships were found.

Licensing & Compatibility

Released under the MIT License, permitting commercial use and integration into closed-source projects.

Limitations & Caveats

Requires UE 5.3+ (some libraries 5.7+). Specific MSVC toolchains are needed for UE 5.3/5.4. Helper scripts are Windows-centric, requiring manual adaptation on other OS.