Blueprint Analyst Documentation

Blueprint Analyst Documentation

Thank you for your interest in Blueprint Analyst - The deep analysis and optimization tool for Unreal Engine Blueprints.

Blueprint Analyst helps you identify performance bottlenecks, unused nodes, and optimization opportunities in your Blueprint graphs. It’s an essential tool for any serious Unreal Engine developer looking to optimize their projects.

Video Overview

Key Features

Deep Blueprint Analysis

  • Scan entire projects or individual Blueprints
  • Identify performance bottlenecks
  • Find unused nodes and variables
  • Detect redundant logic and optimization opportunities

Visual Reports

  • Color-coded node highlighting
  • Interactive graph visualization
  • Exportable analysis reports
  • Before/after comparison

Optimization Suggestions

  • Automatic optimization recommendations
  • Performance impact estimates
  • Refactoring suggestions
  • Best practices enforcement

Getting Started

Installation

  1. Open the Epic Games Launcher
  2. Go to your Unreal Engine Library
  3. Find “Blueprint Analyst” and install it to your engine
  4. Open Unreal Engine and navigate to Edit > Plugins
  5. Enable “Blueprint Analyst” and restart the editor

Basic Usage

  1. Right-click on any Blueprint asset in the Content Browser
  2. Select “Analyze with Blueprint Analyst”
  3. Review the generated report
  4. Apply suggested optimizations

Features Overview

Project-Wide Analysis

Scan your entire project for Blueprint issues:

  • Performance Hotspots: Find Blueprints that consume the most resources
  • Unused Assets: Identify Blueprints that aren’t referenced
  • Complexity Analysis: Find overly complex graphs that need refactoring

Single Blueprint Analysis

Get detailed insights on individual Blueprints:

  • Node Count: Total nodes and execution path depth
  • Performance Score: Estimated performance impact
  • Unused Variables: Variables that are defined but never used
  • Redundant Logic: Nodes that do nothing or are bypassed

Custom Rules

Define your own analysis rules:

  • Enforce coding standards
  • Custom node restrictions
  • Project-specific patterns
  • Team-wide guidelines

Interpreting Results

Performance Scores

  • Green (90-100): Excellent performance
  • Yellow (70-89): Good, with minor optimization opportunities
  • Orange (50-69): Needs optimization
  • Red (0-49): Critical performance issues

Common Issues Found

  1. Excessive Casts: Too many type conversions
  2. Deep Nesting: Complex execution paths
  3. Event Chain: Cascading event dependencies
  4. Unused Variables: Dead code that adds no value

Tips & Best Practices

  1. Run analysis regularly: Catch issues early in development
  2. Focus on high-impact Blueprints: Prioritize frequently used assets
  3. Review before shipping: Always analyze before releasing
  4. Combine with profiling: Use alongside Unreal’s built-in profiler

Additional Resources

Thank you for using Blueprint Analyst!