audit_asset_references
Audit a project folder to detect orphaned assets and broken references without loading them, returning a summary and report path.
Instructions
Project-wide reference audit under folder_path: assets with zero referencers ("orphans") and dependencies pointing at a package no longer on disk ("broken"). Metadata-only through the AssetRegistry -- it never LOADS the assets, so it scales to a large project without spiking memory. It returns only a summary plus a report path; read the detail back with read_mcp_audit_file. For one asset rather than a sweep, use get_asset_referencers / get_asset_dependencies; for unused assets only, find_unused_assets.
Returns: { path: string, summary: { asset_count: int, orphan_count: int, broken_reference_count: int, dependency_type: string } }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| recursive | No | Recurse into subfolders. Defaults to true. | |
| folder_path | No | Content-relative folder to scan. Defaults to "/Game". | |
| max_results | No | Cap on assets processed (1-100000). Defaults to 5000. | |
| dependency_type | No | "hard"|"soft"|"all" (case-insensitive), default "all". Scopes BOTH the referencer check (orphan detection) and the dependency check (broken-reference detection) to that dependency kind. Use "hard" to find only the broken references that actually break loading -- a broken SOFT reference (TSoftObjectPtr/FSoftObjectPath) does not. "all" applies no Hard/Soft requirement at all. |