RefCheck Changelog¶

All notable changes to RefCheck are recorded here.

1.0.0 - Initial release¶

Added¶

Reference scanning for four scopes: selected assets, selected folder, whole project, and open level.
Content Browser right-click action: ECal Studios → Scan References with RefCheck for assets and folders.
Reference Health Score from 0-100, with status and confidence labels.
Detection for common reference-health risks where visible through Unreal editor data:
- Missing references
- Soft-missing references
- External references outside the selected scope
- Suspicious test/dev/temp/old references
- Plugin content dependencies
- Engine content dependencies when enabled
- Bounded circular dependency chains
- Redirector-related risks
- Large dependency sets
- Skipped or unresolved packages
Severity model with Critical, Warning, Info, and Passed states.
Built-in presets:
- Default (Recommended)
- Fab Seller / Package Readiness
- Blueprint System
- Fast Scan
- Deep Scan
Preset Manager for creating, duplicating, renaming, and deleting custom scan presets.
Scan options for soft references, plugin content, engine content, circular references, external references, redirector validation, and maximum dependency depth.
Dashboard with health-score ring, issue-category cards, recent scan history, and quick actions.
Searchable and filterable Results table.
Issue detail panel with explanation, fix suggestions, dependency chain, and navigation actions.
Dependency Chains page for readable chain review.
Welcome / onboarding screen, available again from the sidebar.
Project settings for default preset, auto-open behavior, remembered scope, cached Asset Registry usage, and report defaults.

Reports¶

Markdown export for readable cleanup notes.
HTML export as a self-contained offline report with inline styling.
CSV export with one row per issue, UTF-8 BOM, and standard CSV escaping for spreadsheet compatibility.
Export options for dependency-chain details, full issue details, and passed items.
Overwrite confirmation before replacing existing report files.
Clear success and error feedback after export.

Safety and privacy¶

Editor-only plugin with no runtime module.
Read-only behavior in version 1.0.0.
No asset deletion, movement, rename, reimport, or automatic fixing.
No telemetry, internet calls, accounts, API keys, or external services.
Local reports and local editor settings only.

Known limitations¶

RefCheck detects common reference-health risks where visible through Unreal editor data; it does not find every possible reference.
Dynamic or runtime-only references may require manual inspection.
Circular dependency detection is bounded for editor responsiveness.
Redirector-related findings depend on what Unreal exposes through the Asset Registry.
Version 1.0.0 does not automatically fix references.
The Dependencies page shows readable chains, not a custom interactive graph.
The full editor workflow was validated in Unreal Engine 5.7; Unreal Engine 5.5 and 5.6 are compile- and package-verified.