RefSafe Pro scans scenes, prefabs, and ScriptableObjects for missing scripts, broken references, and duplicates—with auto-fix, CI/CD support, and a studio-grade editor UI.RefSafe Pro – Project Validator for UnityRefSafe 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 DoesRefSafe Pro scans:Open scenesAll scenes in Build SettingsEntire project scenesPrefabsScriptableObjectsMaterials, shaders, layers, and project settingsOnly changed assets (incremental mode)It detects:Missing MonoBehaviour scriptsBroken serialized object referencesDuplicate componentsBroken UnityEvent persistent listenersInvalid or undefined layersInvalid materials and shader errorsMissing prefab instancesBroken Addressable AssetReferencesSuspicious transform positionsDeleted scenes still in Build Settings and moreAll results are structured, categorized, and easy to navigate.Built for Production WorkflowsRefSafe 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 scanningScene validation without manually opening scenesPrefab, ScriptableObject, and project-settings validationAsync frame-based scanning — editor stays responsiveCancel support, scan duration metrics, and severity classification (Critical / Warning / Info)Incremental "Changed Only" mode for fast iterationAuto-scan on asset changes with toast notificationsAuto-fix and triage:One-click fixers for missing scripts, duplicate components, broken prefab instances, and deleted build scenesMulti-select with batch "Fix Selected" and "Ignore Selected."Stable hash-based ignore list that survives sessionsScan diff — see new vs. resolved issues across runsReferences Finder:Bidirectional dependency search — "Used By" and "Depends On" for any assetInteractive dependency graph with pan, zoom, and chain navigationPublic ReferenceSearchAPI for scriptingHealth Trends:Project health score (0–100) with historical trackingCritical/Warning/Info trend chart with hover tooltipsPersistent scan history (last 50 scans)Reporting and CI/CD:Export reports as CSV, JSON, HTML, TXT, or MarkdownHeadless CLI runner: Unity -batchmode -executeMethod RefSafe.Pro.CliRunner.RunScanConfigurable fail thresholds and exit codes for CI gatesPre-build hook that can block builds on critical issuesStudio-grade editor UI:Tabbed workflow: Issues, References, Cleaner, TrendsDense Odin-inspired layout with full dark/light theme supportKeyboard shortcuts (Ctrl+Shift+S scan, F5 re-scan, Ctrl+1–4 tabs, and more)Drag-and-drop scanning — drop any asset onto the windowTwo-level grouped tree view with multi-select and per-issue helpInline Unity documentation links for every issue typeExtensibility (Public SDK):[ValidationRule] — author custom rules in your own assembly[IssueFixer] — register custom auto-fixers with ordering[ReportExporter] — plug in custom report formatsHand-rolled DI container with zero external runtime dependenciesRefSafe.Pro.Core assembly is runtime-safe (noEngineReferences)Part of the RefSafe EcosystemRefSafe is structured as a two-tier validation system:RefSafe Lite — Free scene-level reference validationRefSafe Pro — Full project-wide validation, auto-fix, references finder, cleaner, trends, and CI/CD integrationStart 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 driftFix issues in place — no manual hierarchy huntingGate builds in CI with deterministic exit codesTrack project health over time with historical trendsFind every reference to any asset, in both directionsReclaim disk space by cleaning unused assets and empty foldersExtend with your own rules, fixers, and exporters via a stable public SDKMaintain reference integrity in large Unity productions and shipped titlesSupportNeed help, found a bug, or want to request a feature?Github: https://github.com/a-p-bhatt/ref-safe-lite/issuesDocumentation: Included in the packageResponse time: Within 1–2 business daysRefSafe 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.Unity CompatibilityUnity 2021 LTSUnity 2022 LTSUnity 2023 LTSUnity 6Editor-only tool (does not affect runtime builds).Validation ScopeRefSafe Pro supports:Active scene scanningMulti-scene scanningBuild Settings scene scanningProject-wide scene scanningPrefab asset scanningScriptableObject asset scanningMaterial, shader, and project settings scanningIncremental "Changed Only" scanning (since last scan)Path-based exclusions (per-folder)Unloaded assets are processed safely via editor asset enumeration. Scenes are opened, scanned, and the original scene setup is restored.Detection CoverageRefSafe Pro detects:Missing MonoBehaviour scripts on GameObjectsMissing serialized object references in componentsDuplicate components on the same GameObjectBroken UnityEvent persistent listenersInvalid or undefined layer assignmentsInvalid materials and shader compilation errorsMissing prefab instance rootsBroken Addressable AssetReference GUIDs (no hard dependency on the Addressables package)Suspicious transform positions (NaN / extreme values)Deleted scenes still referenced in Build SettingsEach issue includes:Asset pathScene or prefab nameGameObject reference (ping-able)Component type and serialized fieldSeverity classification (Critical / Warning / Info)Stable hash for cross-session identity (diff, ignore, history)Inline explanation and Unity documentation linkAuto-Fix SystemBuilt-in fixers for common issues:Missing scripts → remove null MonoBehavioursDuplicate components → remove duplicatesMissing prefab instances → unpackDeleted build scenes → remove from Build SettingsFixers run per-issue, in batch ("Fix Selected"), or bulk ("Fix All"). Custom fixers can be registered via [IssueFixer].References FinderBidirectional asset dependency graph (Used By / Depends On)Async incremental cache persisted to Library/RefSafePro/AssetMap.jsonInteractive dependency graph view with pan, zoom, and chain navigationPublic ReferenceSearchAPI for scripting and tooling integrationProject CleanerUnused-asset detection via reverse dependency mapSmart exclusions for entry points (Resources, Editor, Plugins, StreamingAssets, build scenes, scripts, asmdefs)Empty-folder detectionSafe deletion via AssetDatabase.MoveAssetToTrash() with confirmationHealth TrendsProject health score (0–100) computed per scanPersistent history (last 50 scans) at Library/RefSafePro/ScanHistory.jsonCritical / Warning / Info trend chart with hover tooltipsAverage / Best / Worst summary metricsPerformance & ControlAsync frame-based scanning via EditorApplication.update (non-blocking editor)Synchronous mode for batch-mode / CI runsNon-blocking progress bar UICancellation support for long scans (Escape key)Scan duration and per-scope metricsAuto-scan on asset changes with 3-second cooldownOptimized traversal and zero-allocation IMGUI rendering for large projectsPerformance budgets (p95) on the hot path: hashing, diffing, detection, path filteringReporting & ExportSupported export formats:CSVJSONHTMLTXTMarkdown (GitHub / GitLab ready)Reports include structured issue metadata suitable for:Team reviewQA validationBuild verification workflowsCI documentationPull-request comments (Markdown)Custom export formats can be registered via [ReportExporter].CI/CD & Build IntegrationHeadless CLI entry point: Unity -batchmode -executeMethod RefSafe.Pro.CliRunner.RunScanArguments: --scope, --format, --output, --fail-thresholdDeterministic exit codes (0 = clean, 1 = issues above threshold, 2 = error)Pre-build hook (IPreprocessBuildWithReport) with configurable severity threshold; can block builds on violationsArchitecture NotesEditor-only assembly (RefSafe.Pro.Editor) plus runtime-safe data assembly (RefSafe.Pro.Core, noEngineReferences: true)Hand-rolled dependency injection — zero external runtime dependencies (no VContainer, Zenject, or UniTask)Service-oriented composition root via RefSafeApp ([InitializeOnLoad])Typed event bus replaces ad-hoc static eventsPublic SDK with stable extension points: [ValidationRule], [IssueFixer], [ReportExporter]Manual resolution workflow by default — fixers are explicit, never automaticSafe for version-controlled projects (no destructive changes without user action)Cache and history stored under Library/ (not committed)Compatible with Unity 2021 LTS through Unity 6This asset was developed with the assistance of AI tools for tasks such as documentation drafting and UI ideation. All code, functionality, and final implementation have been reviewed, modified, and validated by the publisher.No AI-generated content is included as a primary functional component of this asset.
