Sentinel - Project Health, Issue Scanner & Asset Cleaner
Ragendom
$21.99
$43.99
50%OFF
(no ratings)
Jump AssetStore
Scan scenes, catch broken refs, delete unused assets, track project health over time, and block bad builds - all with CI/CD pipeline support built in.Sentinel is a Unity Editor extension for project auditing, build validation, and asset cleanup. It scans your scenes and prefabs for missing scripts, broken references, and unused assets - then helps you fix, clean, and track them over time.Unlike simple missing script finders, Sentinel combines four specialized tools in one window to cover every aspect of Unity project health - from scene validation to CI/CD pipeline integration.Online Documentation🔍 Issues FinderA full scene validator and prefab auditor that scans both open and closed scenes (without opening them) for 10 built-in issue types: missing scripts, broken references, null materials, shader errors, invalid layers, invalid tags, empty UnityEvents, unused components, and more. Severity is configurable per issue type. One-click auto-fixes with full Undo support.🗑️ Project CleanerA dead file remover and unused asset cleaner powered by a root-tracing dependency scanner. Flags assets that are truly unreferenced - not just "not in a scene," but unreachable from every build scene, Resources folder, Addressables group, and asset bundle. Deletions go to a reversible Trash folder by default, with an automatic backup ZIP for permanent deletions.🔗 References FinderA full-project dependency tracker that instantly answers "where is this asset used?" across scenes, prefabs, and ScriptableObjects, with YAML-level fallback search for complete accuracy.📈 Trends & Health ScoreEvery scan produces a 0-100 Health Score. A built-in trends chart tracks errors, warnings, and totals across up to 60 historical scans. Lock a Baseline to separate intentional technical debt from new regressions - critical for team workflows and code reviews.🚀 CI/CD ReadyRun headless project audits from the command line. Outputs both a machine-readable JSON report and a JUnit XML report compatible with GitHub Actions, Jenkins, and GitLab CI. A ready-to-use GitHub Actions workflow is included. Install a git post-merge hook to auto-scan after every pull.🛡️ Build ValidationEnable "Fail Build on Errors" to automatically block player builds if critical issues exist. A fast pre-build check (missing scripts + broken references only) runs before every build to catch problems before they reach your players.🔔 NotificationsSend scan results to a Slack or Discord channel via webhook with one URL paste.🔧 ExtensibleAdd your own project-specific detectors by extending SentinelExtensionBase. Auto-discovered via TypeCache - no registration needed. Suppress false positives with the [SentinelIgnore] attribute directly in code, or exclude entire folders from the dependency scanner.📧 Support & QuestionsFor any questions, bug reports, or feature requests, reach out at ragendom@gmail.comWe typically respond within 24-48 hours.Zero runtime footprint. Editor-only assembly. Nothing added to your player builds. Compatible with Unity 2021.3 LTS through Unity 6. No external dependencies.CORE MODULESIssues Finder - scans open and closed scenes (YAML-based, 50+ scenes/sec, no scene loading)Project Cleaner - root-tracing dependency algorithm with reversible Trash + backup ZIPReferences Finder - full project reference map with YAML supplementary searchTrends & Health Score - 0-100 score, delta indicator, line chart, up to 60 scan snapshotsBUILT-IN ISSUE DETECTORS (10)Missing Script (Error) - deleted/renamed MonoBehaviour componentsMissing Reference (Error) - serialized fields pointing to missing assetsMissing Material (Error) - null material slots on renderersShader Error (Error) - shaders that fail to compileEmpty UnityEvent (Warning) - UnityEvent fields with zero persistent listenersInvalid Layer (Warning) - GameObjects on undefined layer indicesInvalid Tag (Warning) - GameObjects with tags not in the Tag ManagerUnused Component (Warning) - lone MonoBehaviours on leaf GameObjectsEmpty GameObject (Info) - GameObjects with only a Transform and no childrenDuplicate Name (Info) - multiple assets sharing the same filenameCI/CD & AUTOMATIONHeadless CLI mode via -executeMethod SentinelCLI.RunScanJSON report (scan date, version, issue summary, full issues array)JUnit XML report with inline PR annotations (GitHub Actions, Jenkins, GitLab CI)Ready-to-use GitHub Actions workflow included (Assets/Sentinel/GitHubActions/sentinel.yml)CLI Baseline locking: SentinelCLI.LockBaselineGit post-merge hook installer: auto-scan after every git pull / mergeExit codes: 0 = pass, 1 = issues found, 2 = scan errorBUILD GUARDOptional "Fail Build on Errors" blocks player builds if Error-severity issues existFast pre-build scan (missing scripts + missing refs) before every buildBASELINE & REGRESSION TRACKINGLock any scan state as a Baseline (stored in version-controlled sentinel.baseline.json)All future scans report "X new issues since baseline" - blocks new regressions, allows known debtSUPPRESSION & OVERRIDE[SentinelIgnore] attribute for code-level suppression with optional reason stringPer-issue-type severity overrides in Project SettingsTeam-shared suppressions file (Assets/SentinelData/SentinelSuppressions.json, version-controlled)Right-click context menu: exclude folders or suppress all issues in an assetNOTIFICATIONSSlack and Discord webhook support with "Test Webhook" buttonEXTENSIBILITYCustom detectors via SentinelExtensionBase - auto-discovered, no registration requiredOverride DetectorName + On*Scanned methods, call AddIssue()REQUIREMENTS & COMPATIBILITYUnity 2021.3 LTS or newer (including Unity 6)All render pipelines: Built-in, URP, HDRPEditor-only - zero impact on player build sizeNo external dependenciesKeyboard shortcut: Ctrl+Shift+Alt+SClaude (Claude Code) was used extensively throughout the development of this package to assist with writing, refactoring, and debugging C# editor scripts.
