Unity Unity3d UnityFS

Back to index | Edit this page

Unity3d

• Format Type : Archive
  
• Endian Order : Little Endian / Big Endian
  
• Signature : UnityFS
  

Format Specifications

// 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." - Punishing: Gray Raven
                                             //      "2018.4.24f1." - Shadowverse / Wings of Destiny M
                                             //      "2018.4.5f1.." - Blacksad: Under The Skin
                                             //      "2019.4.0f1.." - Life Is Strange: Before the Storm Remastered
                                             //      "2019.4.21f1." - Marvel Duel
                                             //      "2019.4.22f1." - Game of Nightmares
                                             //      "2019.4.23f1." - Argonavis
                                             //      "2020.3.18f1." - Blankos Block Party
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
}  

MultiEx BMS Script

Not written yet.

quickBMS Scripts

• unity3d_unityFS_script.bms
• Unity_UnityFS_double_header_script.bms

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 *.unity3d extension.

Games

List of games using this file format:

• Alternative girls 2 (Android) (no extension)
• Argonavis from BanG Dream! AAside (Android) (no extension) (encrypted with XOR, key is "CB 69 BF 09")
• Blacksad: Under The Skin (no extension?)
• Blankos Block Party (Unity 2020.3.18f1) (encrypted)
• Game of Nightmares (iOS) (no extension) (encrypted with XOR, key is "0x0B", more info here)
• Life Is Strange: Before the Storm Remastered (*.bytes) (not encrypted)
• Marvel Duel (Android) (no-extension) (extra 20-bytes header: "MARVEL DUAL PACKAGE ")
• NEO: The World Ends With You (PC) (*.unity3d) (Encrypted with AES-128-CBC, read more here)
• Punishing: Gray Raven (Android) (no extension) (Unity 2017.4.35f1) (Game version: 1.9.1 (global) ) (not encrypted, but "Kuro" word is added before "UnityFS" signature)
• Shadowverse (Android) (*.unity3d)
• Wings of Destiny M (Android) (*.unity3d) (encrypted?)

Compatible Programs

• AssetStudio
• AssetRipper
• UnityPack
• UnityEx
• Unity Assets Bundle Extractor (UABE)
• Unity Assets Bundle Extractor Avalonia (UABEA)
• Unity Assets Advanced Editor (UAAE)
• UtinyRipper

See Also

• Analysis of Asset Bundle Format
• Deep dive into UnityFS
• Unity Assets file format

Gallery

• 

  UABE

• 

  UnityEx

• 

  AssetStudio