From 7ad140b5a1f7f404f9079d8cab3fc5845f5fcd3a Mon Sep 17 00:00:00 2001 From: morluto <76467478+morluto@users.noreply.github.com> Date: Thu, 19 Nov 2026 15:17:12 -0500 Subject: [PATCH] docs(desktop): clarify Unity Mono evidence scope (#12509) --- docs/desktop-applications.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/desktop-applications.md b/docs/desktop-applications.md index 64f4bf9e2c..46ab201a11 100644 --- a/docs/desktop-applications.md +++ b/docs/desktop-applications.md @@ -94,7 +94,7 @@ same bundle. Export writes only the caller-selected output file. | Family | Evidence used | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | .NET | A PE optional header declares a nonempty CLI directory. | -| Unity Mono | A managed assembly below `*_Data/Managed` or `Contents/Resources/Data/Managed` has an exact UnityEngine assembly reference. | +| Unity Mono | A PE file below `*_Data/Managed` or `Contents/Resources/Data/Managed` has an exact UnityEngine assembly reference in the probed metadata. | | Unity IL2CPP | A recognized IL2CPP metadata magic (with the raw version when complete) coexists with a conventionally named native `GameAssembly.dll`, `GameAssembly.so`, `GameAssembly.dylib` or `libil2cpp.so` image. Build correspondence remains unknown. | | Godot | A `GDPC` header at file start or a validated executable trailer offset. | | GameMaker | A bounded `FORM` container starts with a `GEN8` chunk. The scan probes conventional `data.win`, `game.unx`, and `game.ios` data files for that header. | @@ -110,6 +110,12 @@ not establish full metadata validity or correspondence to a native binary; version 24 inspection still applies only to supported header layouts. See [IL2CPP metadata](il2cpp-metadata.md). +The Unity Mono probe reads the mapped CLI header prefix and follows its metadata +directory to look for an `AssemblyRef` witness. A readable prefix and reference +can support this candidate while the rest of the declared CLI header extent +remains unverified. Use `inspect_managed_artifact` to check the complete CLI +header and managed metadata for that file. + In a managed directory with a Unity Mono witness, `Assembly-CSharp.dll` and `Assembly-CSharp-firstpass.dll` get an `inspect_managed_members` probe listed first; project-named asmdef assemblies keep only the ordinary managed probes.