ValidatorX is a modular plugin for Unreal Engine that automatically detects issues in Blueprints and helps maintain clean, performant, and error-free graphs.
- Detects unused nodes (e.g., disconnected variables, empty events/functions)
- Finds unused or dead functions and macros
- Identifies empty branches, empty functions, and default values that are never used
- Warns about local/global variable name conflicts
- Tracks unused event dispatchers
- Flags long or overly complex functions
- Highlights cyclical dependencies between Blueprints
| Validator | Description |
|---|---|
| UnusedNodeValidator | Flags blueprint nodes with no usage or connections |
| EmptyFunctionValidator | Detects functions that are completely empty |
| UnusedFunctionValidator | Finds functions that are never called |
| EmptyMacroValidator | Detects macros that contain no nodes |
| UnusedMacroValidator | Identifies unused macros |
| LocalVariableNeverUsedValidator | Finds local variables never read or written |
| GlobalVariableNeverUsedValidator | Detects unused Blueprint variables |
| DefaultAssignmentValidator | Flags variables with default values that are never read |
| EmptyBranchValidator | Warns on branches with unconnected outputs |
| CircularDependencyValidator | Detects circular Blueprint dependencies |
| LocalGlobalNameConflictValidator | Finds naming conflicts between local/global variables |
| UnboundEventDispatcherValidator | Detects dispatchers that are never bound or called |
| LongFunctionValidator | Flags functions that are too large or complex |
| DeadBranchValidator | Detects dead branch nodes |
- Create 'Plugins' folder in your project root directory
- Download appropriate version of .zip in releases
- Extract to Plugins folder
- Open your project, and you're done!
In Tools Menu open the Plugin
Enable the validator you need
Simply click Save or Validate Asset.
Open the Message Log window to view any reported issues.
Double-click the messages to jump directly to the problem nodes.
Problematic nodes will display tooltips or optional bubble comments like ⚠ Unused Node.
- All validators are modular C++ classes
- Can be toggled individually
- Easy to extend with custom validators
- Integrated into
FDataValidationContextsystem
To create your own validator:
- Inherit from
UBlueprintValidatorBase - Override
ValidateLoadedAsset_Implementation - Register using the plugin module
This project is not final and is under active development.
More validators and improvements will be added over time. Stay tuned for updates!
MIT License (you can change this if needed)
Pull requests are welcome. If you want to add your own validator — feel free to fork and contribute!