### 1. Product Overview
GenAI Bridge is a powerful Model Context Protocol (MCP) server that seamlessly connects Unreal Engine 5.4 to AI tools and large language models, enabling natural‑language control and automation of engine tasks. With over 150 MCP tools, it transforms how developers, technical artists, and prototyping teams interact with Unreal Engine, allowing you to create, modify, and manage assets, blueprints, levels, and C++ code using simple text prompts. Whether you’re rapidly iterating on a scene, batch‑processing assets, or generating entire gameplay systems, GenAI Bridge accelerates your workflow and reduces manual effort—all from within your favorite AI client (Claude, Cline, Cursor, Copilot, etc.).
### 2. Core Features & Capabilities
#### Asset Management
- Create, import, delete, and query assets (Static Meshes, Textures, Materials, Blueprints) via natural‑language commands.
- List available assets of any type (StaticMesh, Material, SoundWave, ParticleSystem, etc.) with paginated results.
- Search assets by name pattern and asset type.
- Autofix misspelled asset references using fuzzy string matching.
- Dump full asset libraries to JSON for offline reference (summary‑only output to avoid token overflow).
#### Actor Manipulation
- Spawn actors of any class (StaticMeshActor, PointLight, PlayerStart, Camera, Trigger Volume, etc.) at specified locations.
- Move, rotate, scale, duplicate, and delete actors in the current level.
- Set actor properties (visibility, mobility, custom variables) and component properties.
- Select actors in the editor viewport and organize them into World Outliner folders.
#### Blueprint Interaction
- Create Blueprints from JSON – define nodes, connections, variables, and split pins in a single call.
- Add nodes to existing Blueprints without recreating the entire graph (prevents event duplication).
- Validate Blueprint JSON before execution – catches unknown node types, missing positions, broken connections, and isolated nodes.
- Export Blueprints as standalone HTML for documentation or sharing.
- Share graphs on BlueprintUE.com and obtain a public URL.
- Read raw Blueprint text for analysis and debugging.
#### Content Browser Integration
- Execute content searches and organize folders through prompts.
- Batch operations (rename, delete, move) on asset groups.
#### Level Editing
- Create new levels/maps (Empty, Default, TimeOfDay templates).
- Open, save, and query the currently loaded level.
- Build navigation meshes for AI pathfinding.
- Add sky/atmosphere actors (SkyAtmosphere, VolumetricCloud, SkyLight, DirectionalLight) with one command.
- Focus the editor viewport on any actor.
#### Real‑time Querying
- List all actors in the level with names, classes, positions, and component details.
- Get project‑wide asset counts and available types.
- Check compilation status and retrieve recent errors/warnings.
- Read the Unreal Engine Output Log in filtered chunks (errors, warnings, specific categories).
#### Sequencer Control
- Basic automation for Level Sequences – create sequences, add tracks, and modify keyframes (foundational support; expanded in future updates).
#### C++ Code Generation
- Generate fully‑boilerplated UE5 gameplay classes – Actor, Character, Pawn, PlayerController, GameMode, GameState, HUD, etc.
- Create UE5 subsystems (GameInstance, World, LocalPlayer, Engine, Editor).
- Scaffold plugins, modules, and interfaces with proper Build.cs and .uproject integration.
- Add UPROPERTY variables and UFUNCTION methods to existing classes via hot‑reload.
- Create USTRUCTs, UENUMs, DataTable structs, and UDataAsset classes.
- Add network replication (GetLifetimeReplicatedProps) and RPC functions (Server, Client, NetMulticast).
- Trigger Live Coding recompiles without closing the editor.
#### Widget / UMG Creation
- Create Widget Blueprints (UMG) for UI screens, HUDs, and menus.
- Add UI components (CanvasPanel, Button, TextBlock, Image, Slider, ListView, etc.) and set their properties.
- Bind widget events (OnClicked, OnValueChanged, etc.) to Blueprint functions.
- Set slot/layout properties – anchors, position, size, alignment.
#### Animation Blueprint Authoring
- Create Animation Blueprints bound to a skeleton or skeletal mesh.
- Add animation states (Idle, Run, Jump, Attack) with optional AnimSequence assets.
- Define transitions between states driven by bool/float variables.
- Add animation variables (Speed, bIsMoving, bIsInAir, etc.) for blend logic.
#### AI Controller & Behavior Trees
- Create AAIController subclasses with BehaviorTree + Blackboard integration.
- Generate custom BehaviorTree nodes – Task, Service, and Decorator classes.
- Set up navigation bounds and build NavMesh volumes.
#### Enhanced Component Management
- Add components to Blueprints (StaticMeshComponent, CameraComponent, LightComponent, etc.) with initial properties.
- Clone, reparent, and delete components.
- Set component properties in the ClassDefaults tab (StaticMesh, Material, transform values, visibility, etc.).
#### Autofixer & Validation Tools
- Intelligently fix naming/spelling issues in asset references using Levenshtein distance.
- Validate all asset references in a Blueprint JSON and automatically correct them.
- Suggest asset corrections with confidence scores.
### 3. Technical Specifications
| Item | Detail |
|------|--------|
| MCP Standard Compliance | MCP v1 |
| Unreal Engine Version | 5.4+ (compatible with later 5.x releases) |
| Supported Platforms | Windows 10/11, macOS 13+, Linux |
| Prerequisites | Node.js 18+ LTS, Unreal Engine 5.4 installed |
| Plugin Architecture | Integrates as an Unreal Engine plugin; no engine modifications required |
| Communication | TCP socket on port 5555, JSON‑RPC style messaging |
| Connection Model | Multi‑client capable; stale connections cleaned up after 5 seconds |
### 5. Competitive Advantage
| Advantage | Why It Matters |
|-----------|----------------|
| Native UE 5.4 Support | Built specifically for the latest Unreal Engine features, ensuring compatibility and performance. |
| 150+ Production‑Ready Tools | The most comprehensive MCP toolset for Unreal Engine, covering asset management, level editing, C++ generation, animation, AI, and more. |
| Multi‑Client Architecture | Switch between AI assistants (Claude, Cline, Cursor) without restarting the editor—stale connections are detected and cleaned up automatically. |
| Robust Error Handling & Validation | Every Blueprint JSON is validated before execution; asset references are auto‑corrected with fuzzy matching. |
| Pure HTML Dashboard & Documentation | Includes an offline‑capable Asset Nexus dashboard and full interactive documentation—no external server required. |
| Open‑Source MIT License | Free to use, modify, and distribute, with an active community and regular updates. |
| Runtime AI Support | Call AI models (Claude, OpenAI, Ollama) directly from Blueprints at runtime for dynamic AI‑driven gameplay. |
| Intelligent Autofixer | Reduces friction by automatically fixing common spelling mistakes in asset names. |
| Live C++ Hot‑Reload | Generate and compile C++ classes while the editor is running, seeing changes instantly. |