Docs
Tools

tidy_assets

The Asset Janitor — audit your project for unused assets, redirectors, naming violations, and LOD problems.

The Asset Janitor audits an asset inventory of your project and returns a prioritized report: unused assets with reclaimable sizes, redirectors to fix up, naming-convention violations, and LOD problems. It's read-only — it reports, it never modifies your project.

Cost

Paid — a fixed credit cost per audit session, billed only when a report is produced. If the inventory is empty or can't be parsed, the run is free. Retrying the same session never bills twice. Current price: pricing page.

Using it

The tool works from an asset inventory — a JSONL export of your project's asset registry. Two ways to get one:

  • With the UE connector: your client calls the connector's export_asset_inventory tool in the editor, which writes Saved/spaghetti_inventory.jsonl.
  • Without it: your client gives you a short script to run in the editor's Python console that produces the same file.

Then ask your client:

Audit my project assets using the inventory at Saved/spaghetti_inventory.jsonl

Known limitation — inventory file upload to object storage is pending deployment in production. Until it goes live, the inline path (passing the inventory content directly) works today.

InputRequiredWhat it is
inventoryPathPhase ALocal path to the inventory JSONL
inventoryUri + sessionIdPhase BThe upload location and session from Phase A
inventoryTextfallbackThe inventory content passed inline

What you get back

  • stats — totals for the audited project.
  • unused — assets with no referencers, with counts and reclaimable disk space.
  • redirectors — redirectors left in the project, ready for a fix-up pass.
  • namingViolations — assets that break the naming convention.
  • lod — oversized assets and meshes missing LODs.
  • findings — everything above, prioritized.
  • report — a downloadable CSV, linked from the result (link valid 24 hours).

Fixing what it finds is a separate step — for cleanup scripts, see make_tool.

Limits and notes

ItemValue
Session validity24 hours from Phase A
Upload link validity15 minutes
Accepted inventoryJSONL, up to 50 MB
BillingOnce per session, however many Phase B retries

Was this page helpful?