View source for Unity Unity3d UnityFS

{{GRAFPageHeader}}
== Unity3d == 

* ''' Format Type ''':    Archive <br> 
* ''' [http://en.wikipedia.org/wiki/Endianness Endian Order] ''': Little Endian / Big Endian <br>
* ''' Signature ''':    UnityFS <br> 


=== Format Specifications === 

<div class="toccolours mw-collapsible" id="mw-customcollapsible-myDivision" style="width:1100px; overflow:auto;">
<pre>
// Unity3d file format

// header
8 bytes (char) - signature + null // "UnityFS"
4 bytes (uint32) - version  // 6 or 7
6 bytes (char) - minimum player version + null  // e.g. "5.x.x."
12 bytes (char) - file engine version + null // e.g. "2017.4.35f1."
8 bytes (uint64) - archive size
4 bytes (uint32) - compressed "info block" data size
4 bytes (uint32) - uncompressed "info block" data size
4 bytes (uint32) - flags


// info block
// Note: this section may be compressed with LZ4
{
   // blocks info
   16 bytes - hash
   4 bytes (uint32) - number of blocks  
   num_of_blocks *
   {
      4 bytes (uint32) - uncompressed block size
      4 bytes (uint32) - compressed block size
      2 bytes (uint16) - flags
   }

   // paths info
   4 bytes (uint32) - number of paths
   num_of_paths *
   {
      8 bytes (uint64) - path location
      8 bytes (uint64) - size of the uncompressed data
      4 bytes (uint32) - flags  // 0x04 - serialized file
      37 bytes (char) - filepath  // e.g. "CAB-c0f952eacf35e09957047188fc534360"
   }
}

   
// data
num_of_files *
{
   x bytes - file data  // may be compressed with LZ4
}  
</pre>
</div>

=== Notes and Comments === 

* UnityFS is a new '''asset bundle format''' introduced in '''Unity 5 Engine'''.
* Files inside archive may be compressed with '''LZ4 compression''' method.
* Archive may be partially or fully encrypted with '''XOR''' or with '''AES'''.
* In some games filenames of unity3d archives may be hashed, for example "06477b71ac17b5740482e85abc24da14" and they don't have any extension.

=== Games === 
Games using this file format:
{| class="wikitable sortable"
|- 
!     Game Title                               !! Platform    !! Unity version         !! Extension       !!  Is encrypted?     
|-


|     A Short Hike                             || PC          || 2019.4.28f1           || *.BUNDLE               ||  <font color="green">Not encrypted</font>
|-


|     Alternative girls 2                      || Android          || 2019.4.9f1           || no extension          ||  <font color="green">Not encrypted</font>
|-


|     Arena of Valor                      || unknown          || 2019.4.15f1           || *.ASSETBUNDLE          ||  unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=21&t=25483 here]
|-


|     Ares Chronicles                      || Android / PC          || 2018.4.18f1           || *.UNITY3D          ||  '''XOR''' encryption + custom format, more info [https://forum.xentax.com/viewtopic.php?f=10&t=25304 here]
|-


|     Argonavis from BanG Dream! AAside        || Android          || 2019.4.23f1           || no extension          ||  encrypted with '''XOR''', key is "CB 69 BF 09"
|-


|     Atlantis        || Android          || unknown           || *.BUNDLE          ||  TMSK / TMSK_FS signature. Unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=21&t=24763 here]
|-


|     Blacksad: Under The Skin        || PC          || 2018.4.5f1           || no extension          ||  unknown
|-


|     Blankos Block Party        || unknown          || 2020.3.18f1           || no-extension          ||  unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=10&t=25022 here].
|-


|     Brave's Rage       || PC          || 2020.3.22f1c1          || no-extension          ||  encrypted with '''AES''', "OOKAMI" signature, script available [https://zenhax.com/download/file.php?id=12418 here]
|-


|     Cardinal Chains        || PC          || 2018.4.36f1           || *.UNITY3D          ||  <font color="green">Not encrypted</font>
|-



|     Cloud Gardens        || PC          || 2020.3.26f1           || unknown          ||  <font color="green">Not encrypted</font>
|-


|     Cookie Run: Kingdom        || Android          || 2019.4.15f1           || no extension          ||  Old version: <font color="green">Not encrypted</font> <br>New version: XOR encryption?
|-


|     Deadly Dozen Reloaded        || unknown          || 2019.4.9f1           || *.BUNDLE          ||  <font color="green">Not encrypted</font>
|-


|     Dragon Drop                  || PC               || 2021.3.0f1           || *.BUNDLE          ||  <font color="green">Not encrypted</font>
|-

|     Double Cross                 || PC          || 2018.2.20f1           || no extension          ||  <font color="green">Not encrypted</font>
|-


|     Doula Continent: Soul Master Duel        || Android          || 2019.4.13f1           || *.ASSETBUNDLE          ||  unknown encryption
|-


|     Ensemble Stars        || Android          || unknown           || *.Z          ||  unknown encryption
|-


|     Figment        || PC          || 2018.2.6f1           || no extension          ||  <font color="green">Not encrypted</font>
|-


|     Fostering Apocalypse        || PC          || 2021.1.15f1           || *.UNITY3D          ||  <font color="green">Not encrypted</font>
|-


|     FunDoll        || PC          || unknown           || *.BYTES          ||  unknown encryption
|-


|     Game of Nightmares        || iOS          || 2019.4.22f1           || no extension          ||  encrypted with '''XOR''', key is "0x0B", more info [https://forum.xentax.com/viewtopic.php?f=21&t=24632 here]
|-


|     Girl Cafe Gun        || PC         || unknown           || *.U          ||  unknown encryption
|-


|     Hatsune Miku: Colorful Stage        || Android          || unknown          || unknown          ||  unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=10&t=24854 here]
|-

|     Heaven and Earth Tribulation        || unknown          || 2017.4.41c1          || *.B          ||  unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=18&t=25320 here]
|-


|     Hypnagogia                         || PC         || 2020.1.10f1           || *.UNITY3D          ||  <font color="green">Not encrypted</font>
|-


|     Hypnagogia Boundless Dreams        || PC         || 2020.1.10f1           || *.UNITY3D          ||  <font color="green">Not encrypted</font>
|-


|     Idolish7        || Android          || unknown          || no extension          ||  unknown encryption
|-


|     KartRider Rush        || unknown          || unknown          || *.UNITY3D          ||  unknown encryption, different signature "FBAU"
|-


|     Lapis Re:Lights        || Android          || unknown          || *.BDL          ||  unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=10&t=24929 here]. Possibly first byte of every 7 bytes is XORed with 0xEE.
|-


|     League of Stickman 3        || unknown          || 2019.4.32f1c1          || *.ASSETBUNDLE          ||  encrypted using extra 9-byte header (06 1B 0D 1B 1E 17 01 04 02)
|-


|     Life Is Strange: Before the Storm Remastered        || PC          || 2019.4.0f1           || *.BYTES          ||  <font color="green">Not encrypted</font>
|-


|     Mafia Crime War!        || Android          || 2019.4.23f1           || *.ASSETBUNDLE          ||  encrypted using extra 7-bytes header (3D BF 69 6E 07 A3 68)
|-


|     Marvel Duel        || Android          || 2019.4.21f1           || no extension          ||  encrypted using extra 20-bytes header: "MARVEL DUAL PACKAGE " and multiple UnityFS files joined together in one big file. Archives may be splitted with [https://github.com/bartlomiejduda/Tools/blob/master/NEW%20Tools/UNITY_TOOLS/Multiple_UnityFS_files_in_one_archive_script.bms this script].
|-


|     NEO: The World Ends With You        || PC          || unknown           || *.UNITY3D          ||  encrypted with '''AES-128-CBC''', read more [https://forum.xentax.com/viewtopic.php?p=178437#p178437 here]
|-


|     Old Man's Journey    || PC          || 2017.4.2f2           || *.UNITY3D              ||  <font color="green">Not encrypted</font>
|-


|     Oxenfree        || PC          || 2018.4.34f1           || no extension          ||  <font color="green">Not encrypted</font>
|-


|     Pokemon Home        || Nintendo Switch/Android          || unknown           || *.ABAP / *.ABA          ||  Encrypted with '''AES-256-CBC''', read more [https://forum.xentax.com/viewtopic.php?f=10&t=25326 here]
|-


|     Promesa        || PC          || 2018.4.29f1           || *.BUNDLE          ||  <font color="green">Not encrypted</font>
|-


|     Punishing: Gray Raven (version 1.9.1 and older)       || Android          || 2017.4.35f1           || no extension          ||  encrypted using extra 4-bytes header "Kuro" added before "UnityFS" signature
|-


|     Ragnarok Origin        || Android          || 2018.4.15f1           || *.BLOCK          ||  unknown encryption
|-


|     Rainbow Six Mobile        || Android          || 2020.3.32f1           || *.BUNDLE          ||  <font color="green">Not encrypted</font>
|-


|     Return to Empire (Age of Empires Mobile)        || Android          || 2019.4.0f1.2           || *.K          ||  unknown encryption (missing header?)
|-


|     Shadowverse      || Android          || 2018.4.24f1           || *.UNITY3D          ||  unknown
|-


|     Tenkafuma (18+)      || Android          || 2019.4.9f1           || *.BUNDLE          ||  encrypted by 1 additional byte '''0x03''' before UnityFS signature
|-


|     The Land of Douluo: Soul Master Showdown      || Android          || 2019.4.13f1           || *.ASSETBUNDLE          ||  unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=10&t=24921 here].
|-


|     Toree 3D            || PC               || 2019.2.16f1            || *.UNITY3D          ||  <font color="green">Not encrypted</font>
|-


|     Wings of Destiny M      || Android          || 2018.4.24f1           || *.UNITY3D          ||  unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=21&t=24809 here]
|-


|     Xproject (18+)      || Android          || unknown           || no extension          ||  unknown encryption, more info [https://forum.xentax.com/viewtopic.php?f=10&t=25029 here]
|-






|}

=== quickBMS Scripts === 

See [[List of Unity Tools]] article on this wiki.

=== Compatible Programs === 

See [[List of Unity Tools]] article on this wiki.

=== See Also === 

* [https://www.programmersought.com/article/61574758150/ Analysis of Asset Bundle Format]
* [https://www.imbushuo.net/blog/archives/505 Deep dive into UnityFS]
* [[Unity_Assets|Unity Assets file format]]

==Gallery==
<gallery bordercolor="transparent" spacing="small" orientation="landscape">
UABE_1.png|UABE
UnityEx_1.png|UnityEx
AssetStudio_1.png|AssetStudio
</gallery>
<br/><br>


[[Category:Complete Complete|Unity Unity3d UnityFS]]
[[Category:Platform PC|Unity Unity3d UnityFS]]
[[Category:Platform Android|Unity Unity3d UnityFS]]
[[Category:CE Both|Unity Unity3d UnityFS]]
[[Category:Format_Archive | Type: Archive]]
[[Category:Extension_unity3d | Extension: unity3d]]
[[Category:Extension_bundle | Extension: bundle]]
[[Category:Extension_assetbundle | Extension: assetbundle]]
[[Category:Extension_bytes | Extension: bytes]]
[[Category:Extension_bdl | Extension: bdl]]
[[Category:LZ4 compression]]
[[Category:AES encryption]]
[[Category:XOR encryption]]
[[Category:File Format]]