RefSafe Pro – Project Validator & Cleaner

Why RefSafe Pro – Project Validator & Cleaner for Unity?
RefSafe Pro is a production-ready Unity Editor validation suite designed to detect missing scripts, broken references, and project integrity issues across your entire Unity project — before they ship.
Unity projects grow. Prefabs change. Scripts get renamed. Materials lose shaders. Addressables drift. References disappear silently. The problems often surface only at runtime — or worse, after shipping.
RefSafe Pro catches them early, fixes them in place, and integrates directly into your team's CI/CD pipeline.
What RefSafe Pro Does
RefSafe Pro scans:
Open scenes
All scenes in Build Settings
Entire project scenes
Prefabs
ScriptableObjects
Materials, shaders, layers, and project settings
Only changed assets (incremental mode)
It detects:
Missing MonoBehaviour scripts
Broken serialized object references
Duplicate components
Broken UnityEvent persistent listeners
Invalid or undefined layers
Invalid materials and shader errors
Missing prefab instances
Broken Addressable Asset References
Suspicious transform positions
Deleted scenes still in Build Settings and more
Orphan entries in Addressables groups
Prefab variant component overrides (opt-in)
All results are structured, categorized, and easy to navigate.
Built for Production Workflows
RefSafe Pro is designed for developers and studios who need deterministic validation across the full release pipeline — from authoring to CI to shipping.
Core scanning:
Project-wide and scope-targeted scanning
Scene validation without manually opening scenes
Prefab, ScriptableObject, and project-settings validation
Async frame-based scanning — editor stays responsive
Cancel support, scan duration metrics, and severity classification (Critical / Warning / Info)
Incremental "Changed Only" mode for fast iteration
Auto-scan on asset changes with toast notifications
Auto-fix and triage:
One-click fixers for missing scripts, duplicate components, broken prefab instances, and deleted build scenes
Multi-select with batch "Fix Selected" and "Ignore Selected."
Stable hash-based ignore list that survives sessions
Scan diff — see new vs. resolved issues across runs
One-click fixers for missing scripts, missing references, duplicate components, broken prefab instances, and deleted build scenes
Smart "Replace with..." suggestions for missing references
Snooze issues for 1/7/30 days, attach per-issue notes, pin issues to the top
Group by Scene/Asset, Issue Type, or Severity
Saved filter presets
Project Cleaner — safe by default:
Dry-run preview before every batch delete — counts, disk recovered, type breakdown, and the 10 largest items
Automatic .unitypackage backup written before the delete, one-click Restore
"Why was this flagged?" expander on every unused-asset row
Protected Assets list — sprite atlases, Input System actions, Localization and more excluded out of the box, extensible with your own patterns
Five analyzers: unused assets, empty folders, duplicate-by-hash (MD5), import-settings audit with one-click Fix, build-weight report
In-editor visibility:
Per-severity issue pills on every Hierarchy and Project window row
Optional SceneView beacons above affected GameObjects
Welcome dashboard with health score, sparkline, and trend delta
First-run onboarding tour across all four tabs
References Finder:
Bidirectional dependency search — "Used By" and "Depends On" for any asset
Interactive dependency graph with pan, zoom, and chain navigation
Public ReferenceSearchAPI for scripting
Project-wide or Open-Scenes scope, with component-level hits inside live scenes
Health Trends:
Project health score (0–100) with historical tracking
Critical/Warning/Info trend chart with hover tooltips
Persistent scan history (last 50 scans)
Compare any two recorded scans with a delta summary
Line / stacked-area / grouped-bar chart variants
Configurable health-score weights per team
Reporting and CI/CD:
Export reports as CSV, JSON, HTML, TXT, or Markdown
Headless CLI runner: Unity -batchmode -executeMethod RefSafe.Pro.CliRunner.RunScan
Configurable fail thresholds and exit codes for CI gates
Pre-build hook that can block builds on critical issues
Export as CSV, JSON, HTML, TXT, Markdown, GitHub Actions annotations, or GitLab Code Quality — PRs get inline issue comments.
Studio-grade editor UI:
Tabbed workflow: Issues, References, Cleaner, Trends
Dense Odin-inspired layout with full dark/light theme support
Keyboard shortcuts (Ctrl+Shift+S scan, F5 re-scan, Ctrl+1–4 tabs, and more)
Drag-and-drop scanning — drop any asset onto the window
Two-level grouped tree view with multi-select and per-issue help
Inline Unity documentation links for every issue type
Extensibility (Public SDK):
[ValidationRule] — author custom rules in your own assembly
[IssueFixer] — register custom auto-fixers with ordering
[ReportExporter] — plug in custom report formats
Hand-rolled DI container with zero external runtime dependencies
RefSafe.Pro.Core assembly is runtime-safe (noEngineReferences)
Why Use RefSafe Pro?
Prevent runtime errors caused by broken references, missing scripts, and silent asset drift
Fix issues in place — no manual hierarchy hunting
Gate builds in CI with deterministic exit codes
Track project health over time with historical trends
Find every reference to any asset, in both directions
Reclaim disk space by cleaning unused assets and empty folders
Extend with your own rules, fixers, and exporters via a stable public SDK
Maintain reference integrity in large Unity productions and shipped titles
RefSafe Pro does one thing clearly and reliably:
It keeps your Unity project's references honest — from your editor to your CI server to your final build.