Skip to content

Commit 9f29721

Browse files
Bump version to 1.3.2, doc fix
1 parent dbb5802 commit 9f29721

2 files changed

Lines changed: 33 additions & 4 deletions

File tree

Documentation/command-dump.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,35 @@ BuildPlayer-Scene2.txt
6060

6161
---
6262

63+
## TypeTree Requirement
64+
65+
Unity's binary SerializedFile format stores objects as raw binary blobs. TypeTrees are schema metadata embedded in the file that describe the layout of each type — field names, data sizes, and alignment. The `dump` command requires TypeTrees to interpret those blobs and produce readable output.
66+
67+
**When are TypeTrees absent?**
68+
69+
TypeTrees are included by default. They are stripped in two common situations:
70+
71+
- **Player builds** with *Strip Engine Code* or similar size-reduction options enabled.
72+
- **AssetBundles** built with the *Disable Write TypeTree* build option.
73+
74+
**Error when TypeTrees are missing:**
75+
76+
Various errors can be caused by missing TypeTrees, including:
77+
78+
```
79+
ArgumentException: Invalid object id
80+
```
81+
82+
**Tip:** Use `serialized-file metadata` to confirm whether a file has TypeTrees:
83+
84+
```bash
85+
UnityDataTool serialized-file metadata /path/to/file
86+
```
87+
88+
The `TypeTree Definitions` field will show `No` when TypeTrees are absent.
89+
90+
---
91+
6392
## Output Format
6493

6594
The output is similar to Unity's `binary2text` tool. Each file begins with external references:

UnityDataTool/UnityDataTool.csproj

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@
44
<OutputType>Exe</OutputType>
55
<TargetFramework>net9.0</TargetFramework>
66
<LangVersion>latest</LangVersion>
7-
<Version>1.3.1</Version>
8-
<AssemblyVersion>1.3.1.0</AssemblyVersion>
9-
<FileVersion>1.3.1.0</FileVersion>
10-
<InformationalVersion>1.3.1</InformationalVersion>
7+
<Version>1.3.2</Version>
8+
<AssemblyVersion>1.3.2.0</AssemblyVersion>
9+
<FileVersion>1.3.2.0</FileVersion>
10+
<InformationalVersion>1.3.2</InformationalVersion>
1111
</PropertyGroup>
1212

1313
<PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">

0 commit comments

Comments
 (0)