RefSafe Pro – Project Validator 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 AssetReferences
- Suspicious transform positions
- Deleted scenes still in Build Settings and more
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
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
Health Trends:
- Project health score (0–100) with historical tracking
- Critical/Warning/Info trend chart with hover tooltips
- Persistent scan history (last 50 scans)
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
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)
Part of the RefSafe Ecosystem
RefSafe is structured as a two-tier validation system:
- RefSafe Lite — Free scene-level reference validation
- RefSafe Pro — Full project-wide validation, auto-fix, references finder, cleaner, trends, and CI/CD integration
Start with scene validation. Scale to a full studio pipeline when you need it.
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
Support
Need help, found a bug, or want to request a feature?
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.
