Rules Overview

Blueprint Health Analyzer currently ships with 13 built-in rules across Blueprint, Material, Asset, Niagara, and Rendering categories. Full visual write-ups are being added rule by rule; until then, each rule page still resolves and shows its current scope and documentation status.

Current Phase 2 status: navigation, placeholder routes, and shared rule components are wired. Full rule content is Phase 3 work.

Blueprint Rules

BP-TICK-001 Full guide

Event Tick Usage

Flags expensive work running on Event Tick or other per-frame execution paths.

BP-REF-001 Full guide

Hard Reference Cascade

Detects Blueprint references that load large dependency chains into memory.

BP-CMPLX-001 Full guide

Graph Complexity

Surfaces Blueprint graphs whose size and structure are becoming hard to maintain.

BP-CAST-001 Full guide

Blueprint Cast Chains

Highlights dynamic casts that create fragile dependencies or load-heavy Blueprint chains.

BP-GETALL-001 Full guide

World Query Detection

Detects GetAllActors queries in hot paths such as Tick, loops, and tight timers.

Material Rules

MAT-INST-001 Full guide

Shader Instruction Budget

Warns when material instruction counts exceed sustainable runtime budgets.

MAT-PERM-001 Full guide

Static Switch Permutations

Tracks static switch explosion and shader permutation growth in materials.

MAT-TEX-001 Full guide

Texture Sample Count

Reports materials whose texture sampling cost is likely to impact frame time.

Asset Rules

AST-UNUSED-001 Full guide

Unused Assets

Finds content that appears unreferenced and may be safe to remove or archive.

AST-TEX-001 Full guide

Texture Health

Checks texture size, mipmaps, compression, and other budget-affecting settings.

AST-MESH-001 Full guide

Mesh Optimization

Flags mesh assets with LOD, triangle budget, or Nanite configuration problems.

Niagara Rules

NIA-GPU-001 Full guide

Niagara GPU Budget

Highlights Niagara systems whose GPU, collision, or fixed-bounds settings need review.

Rendering Rules

RND-SET-001 Full guide

Rendering Settings Audit

Reviews project-wide rendering settings such as Lumen, VSM, and Nanite combinations.

Severity Levels

Configuration Status

Today, the plugin exposes threshold and scan-scope configuration. Per-rule enable/disable, severity overrides, and persistent allowlists are planned v1.1 work, not shipped behavior yet.