Ultimate Blueprint Generator Documentation

Ultimate Blueprint Generator: MCP Integration Guide

Thank you for your interest in Ultimate Blueprint Generator - The AI-Copilot for Unreal Engine.

Welcome to the next evolution of the Ultimate Blueprint Generator. This guide will walk you through setting up the new Model Control Protocol (MCP) integration, which connects the powerful “Headless Engine” of the plugin directly to your AI assistant client (like Claude Desktop or Cursor) or directly using the WEB version of almost any AI provider.

There are 3 ways of using the plugin for now. This is the most flexible Co-Pilot for Unreal Engine.

I have fundamentally reimagined what a development assistant can be. This is no longer just a generator. It has transcended its original purpose to become a true, Engine-Wide AI Co-Pilot. It’s a conversational partner with a deep, contextual understanding of your entire project, from the Content Browser to the level viewport to the deepest corners of your Blueprint graphs.

This is not an iteration. This is the next evolution.

!! This is the best value for money you’ll get when it comes to AI Co-Pilots in Unreal !! These other off-FAB plugins can’t compete with the stuff I packaged in this Co-Pilot.

For questions/support I encourage you to join the Discord Server.

Documentation Sections

Key Features at a Glance

This is a high-level summary of the plugin’s core capabilities. For a complete detailed list of all available features, see the Extended Features List.

Feature Summary

  • Universal Asset Architecture & Analysis: Generate, modify, refactor, and get detailed explanations for Blueprints, Materials, Behavior Trees, Animation Blueprints, and Widget Blueprints. Export any summary to disk for documentation.
  • Project & Asset Management: Create new assets on the fly, including Structs, Enums, Blueprints, and folders, directly from a prompt.
  • Real-Time Scene Direction: Spawn, select, and manipulate actors directly in the level viewport with conversational commands.
  • Conversational UI Design: Design and prototype entire UMG layouts, create individual widgets, and modify their properties using natural language.
  • Project-Wide Intelligence: Scan your entire project (Blueprints, Materials, etc.) to find performance hotspots and ask contextual questions about your codebase.
  • External C++ Analysis: Read and write to external C++ source files (.cpp/.h) to analyze or modify external codebases.

Getting Started

Installation

Once you acquired the plugin you simply need to open up the Epic Games Launcher, access your Unreal Engine Library, look up for this plugin and install it to the engine.

Open up Unreal Engine and access the Plugins tab (Edit > Plugins).

Enable the BP Generator and make sure these other plugins are enabled:

  • Enhanced Input
  • Editor Scripting Utilities
  • Python Editor Script Plugin

Then restart the editor.

Step 1: Configure Your AI Client

The plugin’s capabilities have been massively improved with the help of Claude Desktop and Cursor.

You can use either of these to get all the new features that have been added.

First-Time Python Setup (Required)

The new MCP integration uses a small Python server to communicate between the AI client and Unreal Engine. This requires a one-time setup on your machine to ensure Python is installed and has the necessary library.

Install Python

You must have Python installed on your system. Recommended: Python 3.13 (Do not install 3.14).

To check if it’s already installed, run in a terminal:

python --version

Download the official installer: https://www.python.org/downloads/release/python-31311/

CRITICAL: During installation, make sure to check “Add python.exe to PATH”. This is essential for the command line to find Python.

Install and restart your PC.

Install Required Library

After restarting, open a command prompt (Windows) or terminal (Mac) and run:

pip install mcp

Step 2: Running the MCP Bridge

The MCP Bridge is a small Python script that acts as the communication layer between your AI client and Unreal Engine.

Start the Bridge

  1. Open a terminal/command prompt
  2. Navigate to where you want to run the bridge (or use the plugin’s provided scripts)
  3. Run the bridge server (specific command depends on your setup)

The bridge will start listening for connections from your AI client.

Step 3: Configure Claude Desktop

Option A: Claude Desktop App

  1. Open Claude Desktop
  2. Go to Settings
  3. Navigate to the MCP section
  4. Add the MCP server configuration pointing to your bridge

Example configuration (adjust paths as needed):

{
  "mcpServers": {
    "bpgenerator": {
      "command": "python",
      "args": ["path/to/mcp_bridge.py"]
    }
  }
}

Option B: Cursor IDE

  1. Open Cursor Settings
  2. Find the MCP configuration section
  3. Add the BP Generator server

Option C: Web-based AI Clients

Many AI providers now support MCP connections through their web interfaces. Check your provider’s documentation for MCP setup instructions.

Using the Plugin

Basic Blueprint Generation

Once connected, you can ask the AI to generate Blueprints using natural language:

Example prompts:

  • “Create a Blueprint for a player character with health and stamina”
  • “Generate a damage system with armor calculation”
  • “Make a UI widget that displays inventory items”

Asset Analysis

Ask questions about your existing assets:

  • “Analyze my PlayerCharacter Blueprint and suggest optimizations”
  • “Explain how this health system works”
  • “Find all Blueprints that reference this Material”

Scene Manipulation

Control your level through conversation:

  • “Spawn 5 cubes in a circle pattern”
  • “Select all actors with ‘Enemy’ in the name”
  • “Move the selected actors 100 units up”

UMG Widget Design

Create and modify UI:

  • “Design a main menu with Start, Settings, and Quit buttons”
  • “Add a health bar to the game HUD”
  • “Create an inventory grid with 20 slots”

Advanced Features

Project-Wide Scanning

The plugin can scan your entire project to understand its structure:

  • “Scan my project and find all Materials that are not used”
  • “Analyze performance bottlenecks in my Blueprint graphs”
  • “Create a documentation report for all my gameplay Blueprints”

C++ Integration

For projects with C++ code:

  • “Analyze my Character.cpp file”
  • “Add a new function to my GameMode class”
  • “Generate header documentation for this .h file”

Troubleshooting

Common Issues

Q: The AI can’t connect to Unreal Engine

A: Make sure:

  • The MCP bridge is running
  • Unreal Engine is open
  • The BP Generator plugin is enabled
  • Your firewall isn’t blocking the connection

Q: Python command not found

A: Make sure Python is installed and added to PATH. Restart your terminal/PC after installation.

Q: Generated Blueprints have errors

A: Check that all required plugins are enabled. Some features may need specific Unreal Engine versions.

Additional Resources

Version History

  • v0.2.5 (Jan 9) - Latest features and improvements
  • v0.2.0 (Dec 15) - Major MCP integration update
  • v0.1.x - Initial releases

Thank you for using Ultimate Blueprint Generator!