RefCheck is a read-only editor utility for Unreal Engine that scans your selected assets, a folder, or the whole project and turns reference risk into a clear, actionable report. Instead of opening Unreal's Reference Viewer asset by asset, you get a health score, severity counts, a searchable issue table, plain-English explanations, dependency chains, and an exportable Markdown or HTML report.

RefCheck detects common reference-health risks where visible through Unreal editor and Asset Registry data: references that leave the scoped folder, plugin and engine content dependencies, soft references to unresolved assets, suspicious paths like `/Game/Test` or `/Game/Old`, bounded circular dependency chains, and redirector hygiene. Every issue includes a one-line explanation, a suggested next action, and one-click navigation to the source asset, the Content Browser, or Unreal's built-in Reference Viewer.

The plugin is editor-only and runs entirely locally. There is no runtime impact, no telemetry, no internet, no accounts, no credentials. RefCheck never modifies, moves, renames, or auto-fixes your project assets v1.0 is strictly read-only. It complements Unreal's Reference Viewer rather than replacing it: scan to triage, then click into Reference Viewer for the deep inspection cases.

Designed for solo developers preparing a project for packaging or migration, Fab sellers verifying that their content does not silently depend on local-only assets or hidden plugins, Blueprint system creators checking dependencies before export, tutorial creators preparing clean sample projects, and small teams who want a lightweight reference audit without writing custom pipeline scripts.

Features

- Scan selected assets, a folder, the whole project, or the open level.

- Reference health score (0–100) with severity counts and a confidence label.

- Severity dashboard: Critical, Warnings, Info, Passed.

- Detect common reference-health risks where visible through Unreal editor data:

- External references leaving the scoped folder

- Plugin content dependencies

- Engine content dependencies (toggleable)

- Soft references to unresolved assets

- Suspicious paths (`/Game/Test`, `/Game/Old`, `_OLD`, `NewBlueprint`, etc.)

- Bounded circular dependency chains

- Redirector hygiene

- Searchable, filterable issue table with severity / type / fix-status filters.

- Detail panel with severity badge, explanation, fix suggestions, reference chain, and one-click actions (Open Asset, Show in Content Browser, Open Reference Viewer, Copy Issue, Mark as Reviewed, Ignore).

- Dependency chain view for circular and chain-style issues.

- Markdown and HTML report export with inline-CSS single-file HTML (no external CDN).

- Content Browser right-click action under ECal Studios → Scan References with RefCheck for folders and asset multi-selects.

- Five built-in scan presets (Default, Fab Seller / Package Readiness, Blueprint System, Fast Scan, Deep Scan).

- Editor-per-project settings with recent scan history persisted across sessions.

- Onboarding screen on first launch, re-openable from the sidebar.

- Read-only and local-only.

Known Limitations

- Dynamic / runtime-only references may require manual inspection.

- Circular dependency detection is bounded for performance.

- Redirector-related risks depend on what Unreal exposes through the Asset Registry; redirectors that are auto-fixed during a save may not appear.

- v1.0 reports issues but does not automatically fix references.

Documentation: https://www.ecalstudios.com/refcheck/