Blueprint Health Analyzer
Blueprint Health Analyzer is an Unreal Engine editor plugin that scans your Blueprints and assets for performance issues, memory problems, and maintainability anti-patterns.
What It Does
- Scans Blueprints for expensive Tick operations, cast chains, hard reference cascades, and complexity issues
- Scans Materials for shader instruction budgets, texture sample counts, and permutation risks
- Scans Assets for unused content, texture settings, and mesh optimization issues
- Exports Reports in JSON/CSV format for CI integration and team workflows
Quick Start
- Install the plugin from the Fab Marketplace
- Open Window → Blueprint Health Analyzer
- Click Scan to analyze your project
- Click any finding to see the explanation and fix steps
Core Concepts
Findings
Each scan produces a list of findings - specific issues detected in your project. Every finding includes:
- Severity: Critical, Warning, Info, or Suggestion
- Location: The asset and node/property where the issue exists
- Explanation: Why this is a problem
- Recommendation: The current fix direction generated by the rule
Rules
Findings are generated by rules. Each rule detects a specific anti-pattern or issue. You can:
- Configure thresholds
- Configure scan scope with include and exclude roots
- Review rule-by-rule documentation as it is published
See the Rules Overview for the complete list.
Scopes
By default, scans analyze your entire project. You can scope scans to:
- Specific folders (e.g.,
/Game/Characters/) - Specific plugins (e.g.,
/MyPlugin/) - Include or exclude paths
Next Steps
- Getting Started - Installation and first scan
- Configuration - Customizing rules and thresholds
- Rules Overview - Browse all 13 rules
Current v1.1 documentation status: the site structure and rule routes are live, one full rule guide is published, and the remaining rule pages are placeholder references until the Phase 3 content pass.