ArTchie Studios

GUID Find-Usages

Given a GUID or an asset, lists every path under Assets/ that references it.

Editor-only. Unity 2021.3+. Lives in Anvil.Editor (includePlatforms: Editor). No extra packages.

Editor window

ArTchie / Anvil / GUID Find-Usages

Object field + GUID text field (they stay in sync) and:

Button What it does
Find Searches text assets / .meta files for the guid and walks AssetDatabase.GetDependencies.
Copy JSON Puts the report JSON on the clipboard.
Write report Writes <project>/AnvilReports/guid-usages.json (creates the folder if needed).

The target asset and its own .meta are omitted. Skips Packages/ and Library/.

Batchmode (CI)

Unity -batchmode -nographics -quit -projectPath <proj> -executeMethod Anvil.GuidFindUsages.RunBatch -anvil-guid <guid> -anvil-out <file.json>

or

Unity -batchmode -nographics -quit -projectPath <proj> -executeMethod Anvil.GuidFindUsages.RunBatch -anvil-asset Assets/Art/Hero.png
Arg Meaning
-anvil-guid <guid> 32 hex chars (dashes / braces optional). Required unless -anvil-asset is set.
-anvil-asset <path> Project asset path used to resolve the guid.
-anvil-out <file.json> Output path. Default: <project>/AnvilReports/guid-usages.json
-anvil-fail Exit code 1 if any usages were found; otherwise 0

If neither -anvil-guid nor -anvil-asset is passed (or the guid/path cannot be resolved), batch exits 1 and logs an error.

RunBatch only calls EditorApplication.Exit when Application.isBatchMode is true. It logs guid=, count=, and the output path.

Also accepts -anvil-guid=… / -anvil-asset=… / -anvil-out=file.json.

JSON

{
  "tool": "GuidFindUsages",
  "generatedUtc": "2026-08-18T02:00:00Z",
  "guid": "deadbeefdeadbeefdeadbeefdeadbeef",
  "assetPath": "Assets/Art/Hero.png",
  "count": 1,
  "items": [
    {
      "assetPath": "Assets/Art/Hero.mat",
      "kind": "text"
    }
  ]
}

kind values: text (file contents contain the guid), meta (a .meta other than the target’s), dependency (AssetDatabase.GetDependencies direct hit, no text match).

assetPath at the root is "" when the guid does not map to a current project asset (orphaned guid search still runs the text pass).

Notes

  • Text search covers the same YAML/text set as Unused Asset Finder, plus unknown files that look like text. Binary files are not grepped; the dependency pass covers those.
  • One row per referencing path (text/meta wins over dependency).
  • Empty projects, a missing guid, and a missing AnvilReports folder are fine (count 0).
  • Does not modify assets. Does not touch runtime player code.

Source in the box: Assets/ArTchie Studios/ArTchie-Suite/com.artchie.anvil/Documentation/GuidFindUsages.md