Unused Resource Finder

A full asset audit dock, not just an orphan finder: unused files, oversized images, dead folders and missing license files, all in the same scan.

Four checks, one pass

Unused. A file counts as referenced if its res:// path shows up as text anywhere in your .tscn, .tres, .gd, .cs, .cfg or .import files — and, just as importantly, if its uid does too. Godot scenes can reference a resource purely by uid://..., with the path= next to it going stale the moment something gets moved. A plain path search would call that resource unused and risk you deleting something that's very much in use; this plugin resolves each asset's uid first and checks for that as well. Each unused result is also marked High or Low confidence: a file named like part of a numbered set (frame_07.png) whose shared prefix (frame_) still shows up in your code gets marked Low, because that's a strong sign it's built from a loop or format string at runtime rather than genuinely orphaned — so the noisy cases don't bury the real ones.

Oversized. Independent of whether an image is used anywhere, the scan flags any .png, .jpg, .webp or .bmp wider or taller than 2048px. A 4096×4096 background that only ever gets drawn at 400×300 is one of the most common, least visible causes of a bloated export — this surfaces it without you having to open every texture by hand.

Dead folders. When every asset file placed directly inside a folder is unused, that folder is reported as a single line instead of making you piece it together from a dozen separate "unused" rows — usually a leftover from a cut feature or an old art pass.

No license nearby. Flags any folder holding asset files (art, audio, fonts, models) with no LICENSE, CREDITS, ATTRIBUTION or NOTICE file anywhere from that folder up to the project root. Shipping bundled third-party content without keeping its license text next to it is one of the most common reasons a store listing gets held up at review — this is a correctness check, not a tidiness one.

What you get back

• One list, grouped visibly into [Unused, confidence], [Oversized], [Dead folder] and [No license nearby] rows, each showing file size (or asset count for folders) and, for oversized images, the real pixel dimensions.
• Double-click any row to reveal that file or folder in your system file manager.
• "Export Markdown" writes a single asset_audit.md with all four sections, so you (or a teammate) can review and tick things off outside the editor.

All four checks are heuristics, not guarantees: the unused check can't see every possible way a path gets assembled at runtime, "oversized" is a size judgement, not a defect, and the license check only looks for a file by name — it can't read what's inside it. Always look before you delete or resize anything.

Setup

Copy addons/unused_resource_finder into your project's addons/ folder, then switch it on under Project > Project Settings > Plugins. The dock tab shows up on the left; click Scan Project whenever you want a fresh pass — after an art import, before cutting a release build, or just to see where the project stands.

Works with

Godot 4.2 and later (tested on 4.7). Uid-based matching uses the uid Godot already assigned your asset on import; if a particular resource has none, it still gets the full path-based check.

License

MIT — see LICENSE.