scene-audit: missing script and broken reference report for Unity

scene-audit is a release check for Unity projects. It reads your project's text-serialized scenes, prefabs, assets and .meta files directly, with no Unity editor, import or editor licence involved, and reports what is broken, where it is, and what changed since your last audit.

What it finds

• Missing scripts: components whose script GUID no longer resolves (the "referenced script (Unknown)" problem), with the GameObject they sit on. One missing script is one finding.
• Broken references: fields pointing at deleted objects or at assets that aren't in the project, including references inside lists such as m_Materials.
• GUID collisions: two assets whose .meta files claim the same GUID.

Unity's built-in resources, package assets (from Library/PackageCache), texture and model sub-objects and nested prefabs are recognised, so they aren't flagged.

Reports you can compare

Each scan writes a JSON report you can commit. Before a release, compare it with last week's to see which findings are new and which were fixed. Exit codes suit CI: 0 clean, 1 findings, 3 scan error. A scan that couldn't read a file is never reported as clean.

In the download

• Full C#/.NET 8 source. Build it once with the free .NET 8 SDK (one command in the README).
• A small Unity 2022.3 sample project with 6 seeded defects, so you see every check fire on the first run.
• The 64-check test suite (bash run-tests.sh).
• docs/VERIFY.md, listing what was tested and what wasn't.

Limits: a command-line tool, not an editor window. It needs Force Text serialization (Unity's default); binary scenes and prefabs are reported as scan errors. Three checks only, so a clean scan means those passed, not that the project is healthy. Tested on Linux x64 against Unity 2022.3.62f1 files and hand-written fixtures in the same format; Windows, macOS, other Unity versions and large third-party projects haven't been tested.

Made with AI assistance: the code, tests and this description were written with AI tools, then built and run as described in VERIFY.md.

Licence: use and modify it for unlimited personal, commercial and client projects. No public redistribution or resale of the tool or source. Full terms are in the download. No future updates or custom integration are promised.

Support: post in the comments below. Best effort, for bugs in the tool itself.