الوصف
Project Structure Guard is an editor-only Unreal Engine plugin built to help solo developers and teams keep projects clean, consistent, and production-ready.
Instead of relying on manual reviews, inconsistent naming habits, or late cleanup passes, you can define your project structure rules once and validate your content against them across the entire project.
Whether you are maintaining a small indie game or a large production pipeline, Project Structure Guard helps you enforce standards, catch violations early, and reduce project clutter before it turns into long-term technical debt.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
VALIDATION & AUTO-FIX
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Scan the entire project, a selected folder, or selected assets
• Detect naming violations for prefixes, suffixes, and casing
• Detect folder violations when assets are stored in the wrong location
• Fix All — rename all auto-fixable assets with pre-apply preview
• Move All — relocate misplaced assets with a pre-apply preview and reference-safe Unreal asset movement
• Fix Selected — apply fixes only to manually selected results
• Filter validation results by Errors, Warnings, or Auto-fixable only
• Filter results by type — show only Naming or Folder violations independently
• Bulk Fix Preview — review and confirm every planned rename or move before applying
• Clear blocked-operation feedback — see why a rename or move could not be completed directly in the plugin and Output Log
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ON-SAVE VALIDATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Validate assets automatically on save
• Show toast notifications immediately when violations are detected
• Display the suggested fix directly in the notification
• Can be enabled or disabled per project
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UNUSED ASSET SCANNER
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Detect assets that are not referenced by any map or other asset
• Respects direct, indirect, and soft references
• Show asset class and file size for easier cleanup prioritization
• Review, quarantine, and permanently delete unused assets
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
BUILT-IN PRESETS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Epic Official
• Allar Style Guide
• Lyra Sample Project
• Start with proven rule sets instead of building every convention from scratch
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
RULE MANAGEMENT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Enable or disable individual naming and folder rules without touching Project Settings
• Changes take effect on the next scan immediately
• Rule state is persisted per project
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
RULE EXPORT & IMPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Export rule sets as JSON for team sharing
• Import rule sets from file for studio-wide standards
• Human-readable format suitable for review and version control
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CI / CD COMMANDLET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Run validation headlessly from the command line
• Supports -failonerror and -failonwarning
• Export validation results as CSV or JSON reports
• Supports custom scan paths via -scanpath=
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
QUALITY OF LIFE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Built for repetitive cleanup workflows, not one-off manual review
• Helps teams enforce consistent structure across shared projects
• Supports source-control-friendly cleanup and validation workflows
• Tested with 3,000+ violations processed in a single Fix All operation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TECHNICAL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Unreal Engine 5.7 and 5.8
• Supported platforms: Windows, Mac, and Linux
• Editor-only plugin with zero runtime overhead
• Pure C++ editor plugin
• Does not modify Blueprints
• Code modules:
– ProjectStructureGuard (Editor)
– ProjectStructureGuardEditor (Editor)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUPPORT & COMMUNITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
For support, bug reports, feature requests, and updates:
• Discord: https://discord.gg/vgpmnN6nCR
• Product overview video: https://youtu.be/yy7JcQfoHyo