UnityAsset.NET

---

A .NET library undergoing active refactoring, currently focused on high-performance parsing and reading of Unity Engine asset files.

Only support Unity 2017.x or later.

Features

---

BundleFile

• [x] Parsing and Reading
• [x] Serialization
• [ ] ~~Patching~~ (Will be re-introduced in a future version)
• [x] Calculate/Patch crc32

SerializedFile

• [x] Parsing and Reading
• [x] Serialization
• [ ] ~~Patching~~ (Temporarily removed)

Asset

• [x] Parsing based on TypeTree
• [ ] ~~Serialization~~ (Temporarily removed)
• [ ] ~~Patching~~ (Temporarily removed)

Examples

---

Unity CN Decryption

To load BundleFile with Unity CN Encryption, there are two ways.

// Hex string format (32 characters)
Setting.DefaultUnityCNKey = "587865636f6472506547616b61326536";  // Represents "XxecodrPeGaka2e6" in hex
BundleFile bf = new BundleFile( @"path to your bundlefile");

or

// Plain string format (16 characters)
BundleFile bf = new BundleFile( @"path to your bundlefile", "XxecodrPeGaka2e6");

~~To remove Unity CN Encryption form File, you can simply save BundleFile without key~~

// Temporarily removed
bf.Serialize(@"path to save file", CompressionType.Lz4HC, CompressionType.Lz4HC);

Stripped Version

Some BundleFile's version may be stripped, to load those file you can set a specific version

Setting.DefaultUnityVerion = "2020.3.48f1"

Roadmap

• [ ] v0.4: Re-architect and re-implement a robust and flexible serialization API.
• [ ] v0.5: Re-introduce patching capabilities based on the new object model.

Credits

---

This project stands on the shoulders of these amazing open-source projects:

• Studio by Razmoth
• AssetStudio by aelurum
• AssetsTools.NET by nesrak1
• UnityPy by K0lb3
• RustyAssetBundleEXtractor by UniversalGameExtraction