Ultimate Blueprint Exporter (UBX)

Overview

Ultimate Blueprint Exporter (UBX) is an editor-only C++ plugin for Unreal Engine 5.5+ that exports Blueprint graphs to AI-readable text format. It's designed for feeding Blueprint logic to LLMs (Claude, GPT, etc.) for code review, documentation, or AI-assisted development.

Installation

Manual Installation

1. 1

   Download the Plugin

   Download the plugin zip file from your purchase location.

2. 2

   Extract to Plugins Folder

   Extract the UltimateBlueprintExporter folder to your project's Plugins/ directory:

   YourProject/
   ├── Content/
   ├── Plugins/
   │   └── UltimateBlueprintExporter/
   │       ├── UltimateBlueprintExporter.uplugin
   │       └── Source/
   └── YourProject.uproject

3. 3

   Regenerate Project Files

   Right-click your .uproject file and select "Generate Visual Studio project files"

4. 4

   Build and Launch

   Open in your IDE and build, or launch directly from the Epic Games Launcher.

Verify Installation

After launching the editor:

1. Go to Edit → Plugins
2. Search for "Ultimate Blueprint Exporter"
3. Confirm the plugin is enabled
4. Open any Blueprint—you should see the "UBX" button in the toolbar

Quick Start

Your First Export

1. 1

   Open a Blueprint

   Double-click any Blueprint asset to open it in the Blueprint Editor.

2. 2

   Select Nodes (Optional)

   Select any number of nodes to export just those, or don't select anything to export the entire Blueprint.

3. 3

   Click UBX

   Find the "UBX" button in the toolbar and click it.

4. 4

   Paste

   The export is copied to your clipboard. Paste it into Claude, ChatGPT, or any LLM.

A toast notification will confirm the export with the estimated token count:

Toolbar Button

The "UBX" button appears in the toolbar of supported editors:

Export Modes

Different click modifiers trigger different export behaviors:

Blueprint Editor

AnimBP / WidgetBP / Material Editors

These editors support the same node selection and export behavior as standard Blueprints.

Preview Window

The preview window (Ctrl+Click or Ctrl+Alt+Click) provides advanced export options:

Window Layout

View Tabs

Advanced Options

Click "Advanced Options..." in the preview window to configure export settings:

Project Information

A multi-line text field for persistent project context. When "Add Project Information" is checked in the preview window, this text is prepended to exports.

Use cases:

• Describe your project's architecture
• List naming conventions
• Provide context about custom systems
• Include relevant constraints or requirements

Export Options

Settings Persistence

Settings are saved to your project's config file:

Saved/Config/*/EditorPerProjectUserSettings.ini

[/Script/UltimateBlueprintExporterEditor.ExportSettings]
ProjectInformation="..."
bAddProjectInformation=true
...

Blueprints

Full export support for all Blueprint types:

Supported Features

• Event Graphs
• Functions (with inline expansion)
• Macros (with inline expansion)
• Collapsed Graphs
• Variables and their default values
• Components
• Interfaces
• Comment boxes (attached to relevant nodes)

Same-BP Expansion

Functions and macros defined within the active Blueprint are expanded inline and marked with (Self):

[Call] InitializeBoard (Self)
  in CellCount: int = 9
  -> SetupCells.execute

External Call Marking

Calls to functions in other Blueprints are marked but not expanded:

[External Call] BP_ScoreManager -> UpdateScore
  in Points: int = 10

Engine Macro Descriptions

Common engine macros include helpful descriptions:

[Macro] ForEachLoop (Engine)
  // Iterates over array elements
  in Array: Array
  out Element: Wildcard
  out Index: int

Animation Blueprints

Full export support for Animation Blueprints including AnimGraphs and State Machines.

Supported Features

• AnimGraph nodes (70+ types)
• State Machines with entry states
• State nodes with reset flags
• Transitions with duration, priority, bidirectional info
• Blend Spaces and Aim Offsets
• Animation Sequences
• Linked Animation Graphs
• EventGraph logic

State Machine Format

[StateMachine] Locomotion
  Entry: Idle
  ### States ###
    [State] Idle
      -> State: [Locomotion] Idle
    [State] Walk / Run
      -> State: [Locomotion] Walk / Run
  ### Transitions ###
    [Transition] Idle -> Walk / Run (0.20s, priority 1)
    [Transition] Walk / Run -> Idle (0.30s, priority 1)

Header Information

Animation Blueprints include skeleton info:

# Blueprint: ABP_Character
# Type: Animation Blueprint
# Skeleton: SK_Mannequin
# Parent: AnimInstance

Widget Blueprints

Full export support for UMG Widget Blueprints.

Supported Features

• Widget hierarchy with parent/child relationships
• Widget types (36+ labeled)
• Variable widgets marked with (var)
• Text content extraction
• Property bindings
• Event bindings (ComponentBoundEvent nodes)
• EventGraph logic

Hierarchy Format

## Widget Hierarchy

[Canvas] RootCanvas
  [VBox] MainContainer
    [Image] LogoImage (var)
    [Text] TitleText "Tic-Tac-Terror"
    [Button] PlayButton (var)
      <- OnClicked: HandlePlayClicked
      [Text] PlayText "Play Game"

Property Bindings

Widgets with property bindings show the bound function:

[Text] ScoreText (var)
  <- Text: GetScoreDisplayText

Materials

Full export support for Materials, Material Functions, and Material Instances.

Supported Features

• Material expressions (60+ types)
• Parameters (Scalar, Vector, Texture, Static Switch)
• Material Functions
• Material Instances (parent + overrides)
• Per-output graph organization
• Stable node IDs for cross-referencing
• Shared node markers

Output Organization

Material graphs are organized by material output:

## Graph (by Output)

### BaseColor
[TextureParam]{n001} DiffuseMap
  out RGBA -> Lerp{n003}.A

[Lerp]{n003}
  out Result -> Material.BaseColor

### Roughness
[ScalarParam]{n004} Roughness
  out R -> Material.Roughness

Material Instance Export

Material Instances show only the parent and overridden parameters:

# Material Instance: MI_Character_Skin_Tan
# Parent: M_Character_Skin

## Overridden Parameters
- SkinTint = (0.95, 0.8, 0.7, 1.0)
- Roughness = 0.35

State Trees

Full export support for UE5 State Trees used in AI and game logic.

Supported Features

• Full state hierarchy with nesting
• Tasks with complete property extraction
• Transitions with trigger types
• Conditions expanded inline
• GameplayTag event triggers
• Delay and priority settings
• Schema information

State Format

[State] Root
  [Task] DebugTextTask
    in Text: String = "Entering Root"
    in TextColor: Color = (255, 255, 255, 255)
    in FontScale: float = 1.0
  [Transition] OnTick -> "Waiting for Turn" (delay: 4.0s)

  [State] Waiting for Turn
    [Task] DebugTextTask
      in Text: String = "Waiting..."
    [Transition] OnEvent(TTT.AI.State.StartTurn) -> "Thinking" (delay: 1.0s)

Transition Types

Header Information

State Tree exports include schema info:

# State Tree: ST_Entity_AI_Base
# Path: /Game/AI/StateTrees/ST_Entity_AI_Base
# Schema: StateTreeComponentSchema
# ~260 tokens (estimated)

Output Format

Header Block

Every export begins with metadata:

# Blueprint: BP_GameBoard
# Path: /Game/Blueprints/BP_GameBoard
# Parent: Actor
# ~360 tokens (estimated)

Graph Sections

Graphs are separated with headers:

## EventGraph: EventGraph

[Event] ReceiveBeginPlay
  -> InitializeBoard.execute

## Function: ValidateMove

[Entry] ValidateMove
  out CellIndex: int

Node Format

[Label] NodeTitle
  in PinName: Type = DefaultValue <- SourceNode.SourcePin
  out PinName: Type -> TargetNode.TargetPin

Connection Syntax

Node Labels

Nodes are prefixed with descriptive labels. The plugin maps 50+ Blueprint node types. Here's a sample:

Common Labels

Settings

Config Location

Settings are stored in your project's per-user config:

Saved/Config/*/EditorPerProjectUserSettings.ini

Config Section

[/Script/UltimateBlueprintExporterEditor.ExportSettings]
ProjectInformation="Your project context here..."
bAddProjectInformation=false
bIncludeHeader=true
bIncludeDefinitions=true
bRecursiveExpansion=true
MaxDepth=5
bDeepExpansion=false

Logging

The plugin uses a custom log category for diagnostics:

// Filter in Output Log
LogUBX

// Example log output
LogUBX: Exported BP_GameBoard to clipboard (~360 tokens)
LogUBX: Warning - Blueprint has compile errors

Troubleshooting

FAQ

Changelog