profile_blueprint_execution
Statically analyze a Blueprint's structure and heuristic complexity, not runtime execution; use compile_for_timing=false for a read-only check that avoids recompiling or dirtying the asset.
Instructions
STATIC complexity analysis of a blueprint (node/function/variable counts + heuristic score). It does NOT profile any runtime execution. WARNING, SIDE EFFECT: by default it RECOMPILES the Blueprint purely to time the compile, which marks the asset dirty and can surface new compile errors on an asset you only meant to READ -- pass compile_for_timing=false for a genuinely read-only analysis. Three response fields are misnamed and each is flagged as such in the payload: execution_time is the COMPILE time in ms, cpu_usage is the heuristic complexity score (not CPU), and memory_usage is the .uasset size on disk (not memory).
Returns: { blueprint_path: string, resolved_object_path: string, blueprint_class: string, execution_time: number, memory_usage: int, cpu_usage: number, performance_rating: string, profile_status: string, total_nodes: int, function_count: int, event_count: int, variable_count: int, component_count: int, complexity_score: number, memory_score_mb: number, compilation_score_ms: number, blueprint_compiled: bool, is_static_analysis: bool, runtime_profiled: bool, recompiled_blueprint: bool, execution_time_is_compile_time_ms: bool, cpu_usage_is_complexity_score: bool, memory_usage_is_disk_file_size_bytes: bool, under_readonly_root: bool, side_effects: [string], recommendations?: [string] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Optional. This command is REFUSED while a Play-in-Editor session is running: it either compiles a Blueprint (the reinstancer can retain a world, and CheckForWorldGCLeaks is Fatal -- it KILLS the editor) or writes to disk (Editor.AllowSavingAssetsDuringPIE=0 makes the engine refuse the write, so it would report success without writing a byte). Stop PIE and retry instead; force=true runs it anyway, at your own risk. | |
| blueprint_name | No | Alias of `blueprint_path` (same value, same meaning). Accepted because sibling tools spell this parameter differently; prefer `blueprint_path`. | |
| blueprint_path | No | Object path, package path, or bare short name of the blueprint (resolved via mcp_common::ResolveAssetFlexible; ambiguity errors out listing candidates) | |
| compile_for_timing | No | Optional (default true): recompile the Blueprint to measure compile time. Pass false for a pure read-only analysis (execution_time/compilation_score_ms then report 0). |