FastFiles and Zone files (MW2) - Revision history

Jakes625: /* PS3 */

2026-06-22T18:38:15Z

PS3

← Older revision		Revision as of 18:38, 22 June 2026
Line 101:		Line 101:
	if ((DB_Header->languageMask & bit) == 0)		if ((DB_Header->languageMask & bit) == 0)
	continue;		continue;

			if (DB_Header->entryCount > MAX_DB_HEADER_ENTRIES)
			Com_Error("Too many DB header entries");

	uint32_t entryBytes = DB_Header->entryCount * 0x14;		uint32_t entryBytes = DB_Header->entryCount * 0x14;

Jakes625: /* Main FastFile Structure */

2026-06-22T18:35:19Z

Main FastFile Structure

@@ Line 4: / Line 4: @@
 == Main FastFile Structure ==
 <syntaxhighlight lang="cpp">
   //Note, on PS3 all values are << 1
   enum language_t
@@ Line 32: / Line 34: @@
     bool allowOnlineUpdate;
     unsigned __int64 fileCreationTime;
-    language_t region;
+    language_t languageMask;
     int entryCount;
     DbHeaderImageStreamEntry entries[]; //entryCount
@@ Line 83: / Line 85: @@
+  }
 ==== PS3 ====
- readBytes(entryCount * 0x14);
+The language selector comes from DB global/state storage:
 === File Sizes ===

Jakes625: /* Entries */

2026-06-22T18:19:18Z

Entries

← Older revision		Revision as of 18:19, 22 June 2026
Line 51:		Line 51:
	=== Entries ===		=== Entries ===
	On PS3 Entries are the serialized source ranges and logical decode positions for streamed GfxImage payloads.		On PS3 Entries are the serialized source ranges and logical decode positions for streamed GfxImage payloads.

			The serialized header row order is not the same as the runtime record order. The engine reads: DbHeaderImageStreamEntry, Then stores runtime records as: GfxImageStreamRecord.

	<syntaxhighlight lang="cpp">		<syntaxhighlight lang="cpp">
	public struct DbHeaderImageStreamEntry		public struct DbHeaderImageStreamEntry
	{		{
	~~public~~ uint FileIndex; // 0 = current fastfile, 1..4 = imagefile%d		uint FileIndex; // 0 = current fastfile, 1..4 = imagefile%d
	~~public~~ uint SourceStart; // compressed/source offset in selected file		uint SourceStart; // compressed/source offset in selected file
	~~public~~ uint SourceEnd; // compressed/source end offset, not size		uint SourceEnd; // compressed/source end offset, not size
	~~public~~ uint BlockOffset; // low 16-bit/intra-block logical stream offset		uint BlockOffset; // low 16-bit/intra-block logical stream offset
	~~public~~ uint StreamOffset; // full logical uncompressed stream offset		uint StreamOffset; // full logical uncompressed stream offset
			}

			public struct GfxImageStreamRecord
			{
			uint SourceStart;
			uint BlockOffset;
			uint StreamOffset;
			uint SourceEnd;
			void* File;
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Jakes625: /* Main FastFile Structure */

2026-06-22T18:13:49Z

Main FastFile Structure

← Older revision		Revision as of 18:13, 22 June 2026
Line 34:		Line 34:
	language_t region;		language_t region;
	int entryCount;		int entryCount;
	~~Entry~~ entries[];		DbHeaderImageStreamEntry entries[]; //entryCount
	int fileSize;		int fileSize;
	int maxFileSize;		int maxFileSize;

Jakes625: /* Entries */

2026-06-22T18:13:06Z

Entries

← Older revision		Revision as of 18:13, 22 June 2026
Line 50:		Line 50:
	Whether or not assets in this FF may be replaced by an FF loaded at a later time.		Whether or not assets in this FF may be replaced by an FF loaded at a later time.
	=== Entries ===		=== Entries ===
	~~These~~ are ~~still not entirely understood~~. ~~Most FF systems simply parse past them~~.		On PS3 Entries are the serialized source ranges and logical decode positions for streamed GfxImage payloads.

			<syntaxhighlight lang="cpp">
			public struct DbHeaderImageStreamEntry
			{
			public uint FileIndex; // 0 = current fastfile, 1..4 = imagefile%d
			public uint SourceStart; // compressed/source offset in selected file
			public uint SourceEnd; // compressed/source end offset, not size
			public uint BlockOffset; // low 16-bit/intra-block logical stream offset
			public uint StreamOffset; // full logical uncompressed stream offset
			}
			</syntaxhighlight>

	==== Xbox 360 ====		==== Xbox 360 ====
	for (int32 i = 0; i < 0x0f; i++)		for (int32 i = 0; i < 0x0f; i++)
Line 61:		Line 73:
	==== PS3 ====		==== PS3 ====
	readBytes(entryCount * 0x14);		readBytes(entryCount * 0x14);

	=== File Sizes ===		=== File Sizes ===
	The fileSize is the size of the FF, everything included. The maxFileSize is the highest number that fileSize can be, and in most FFs they are equal.		The fileSize is the size of the FF, everything included. The maxFileSize is the highest number that fileSize can be, and in most FFs they are equal.

Jakes625: /* Zone File */

2026-06-12T03:26:40Z

Zone File

@@ Line 150: / Line 150: @@
 };
 </syntaxhighlight>
 === Asset List ===

Red-EyeX32: /* Signed Files */

2015-11-09T22:56:23Z

Signed Files

← Older revision		Revision as of 22:56, 9 November 2015
Line 69:		Line 69:
	PS3 only supports unsigned fastfiles. For Xbox 360, only single player FastFiles are unsigned. Unsigned FastFiles are very simple. The only data remaining is compressed zlib data. Decompressing the data yields the [[#Zone File\|zone file]].		PS3 only supports unsigned fastfiles. For Xbox 360, only single player FastFiles are unsigned. Unsigned FastFiles are very simple. The only data remaining is compressed zlib data. Decompressing the data yields the [[#Zone File\|zone file]].
	=== Signed Files ===		=== Signed Files ===
			<syntaxhighlight lang="cpp">
	struct DB_AuthHash		struct DB_AuthHash
	{		{
Line 106:		Line 107:
	DB_AuthXBlock xBlocks[];		DB_AuthXBlock xBlocks[];
	};		};
			</syntaxhighlight>
	The signatures on the XBlocks are checked as the FastFile loads. Then the sub-header master block hashes are checked, followed by the signedSubheaderHash, and lastly the subheaderHash. If any fail, then the loading of the FF is aborted. Only Activision and the game developers can generate the RSA signatures.		The signatures on the XBlocks are checked as the FastFile loads. Then the sub-header master block hashes are checked, followed by the signedSubheaderHash, and lastly the subheaderHash. If any fail, then the loading of the FF is aborted. Only Activision and the game developers can generate the RSA signatures.
	==== Magic ====		==== Magic ====
Line 111:		Line 113:
	==== XBlocks ====		==== XBlocks ====
	XBlocks are used until they are no longer needed. If the compressed data can fit into 1, then only 1 will exist.		XBlocks are used until they are no longer needed. If the compressed data can fit into 1, then only 1 will exist.

	== Compression ==		== Compression ==
	=== PS3 ===		=== PS3 ===

Red-EyeX32: /* Main FastFile Structure */

2015-11-09T22:55:30Z

Main FastFile Structure

← Older revision		Revision as of 22:55, 9 November 2015
Line 3:		Line 3:

	== Main FastFile Structure ==		== Main FastFile Structure ==
			<syntaxhighlight lang="cpp">
	//Note, on PS3 all values are << 1		//Note, on PS3 all values are << 1
	enum language_t		enum language_t
Line 25:		Line 26:

	//Entry point for the FF.		//Entry point for the FF.
	struct ~~DB_AuthHeader~~		struct DB_Header
	{		{
	char magic[8];		char magic[8];
Line 37:		Line 38:
	int maxFileSize;		int maxFileSize;
	};		};
			</syntaxhighlight>
	=== Magic ===		=== Magic ===
	The magic is a string that is 8 characters long. It is either "IWff0100" or "IWffu100". It indicates what is read after maxFileSize. If it is "IWff0100" then this FF is signed. If it is "IWffu100", then this FF is unsigned.		The magic is a string that is 8 characters long. It is either "IWff0100" or "IWffu100". It indicates what is read after maxFileSize. If it is "IWff0100" then this FF is signed. If it is "IWffu100", then this FF is unsigned.
Line 61:		Line 63:
	=== File Sizes ===		=== File Sizes ===
	The fileSize is the size of the FF, everything included. The maxFileSize is the highest number that fileSize can be, and in most FFs they are equal.		The fileSize is the size of the FF, everything included. The maxFileSize is the highest number that fileSize can be, and in most FFs they are equal.

	== Subheader ==		== Subheader ==
	The rest of the FF is read depending on what the main FF magic was. If the magic was "IWff0100" then the FF is signed. If it was "IWffu100", the FF is unsigned.		The rest of the FF is read depending on what the main FF magic was. If the magic was "IWff0100" then the FF is signed. If it was "IWffu100", the FF is unsigned.

Aerosoul94: /* PS3 */

2015-10-06T12:15:40Z

PS3

← Older revision		Revision as of 12:15, 6 October 2015
Line 110:		Line 110:
	== Compression ==		== Compression ==
	=== PS3 ===		=== PS3 ===
	After the zone file is created, it is split into blocks each 0x10000 bytes. Each block is compressed using default zlib compression. The size of the compressed block is stored as an unsigned 16 bit integer over the zlib header (0x78DA). Compressed blocks are concatenated and appended to the fastfile.		After the zone file is created, it is split into blocks each 0x10000 bytes, the last block being padded with zeroes if not 0x10000 bytes long. Each block is compressed using default zlib compression. The size of the compressed block is stored as an unsigned 16 bit integer over the zlib header (0x78DA). Compressed blocks are concatenated and appended to the fastfile.

	=== Xbox 360 ===		=== Xbox 360 ===
	Once the zone file is created, the entire zone is compressed using default zlib compression. If the FastFile is unsigned (single player) then the data is simply concatenated to the header. Signed files split the data up into 0x200000 byte XBlocks, each with a 0x2000 byte hash block.		Once the zone file is created, the entire zone is compressed using default zlib compression. If the FastFile is unsigned (single player) then the data is simply concatenated to the header. Signed files split the data up into 0x200000 byte XBlocks, each with a 0x2000 byte hash block.

Therifboy at 14:44, 12 January 2015

2015-01-12T14:44:04Z

← Older revision		Revision as of 14:44, 12 January 2015
Line 127:		Line 127:
	XFILE_BLOCK_LARGE = 4,		XFILE_BLOCK_LARGE = 4,
	XFILE_BLOCK_CALLBACK = 5,		XFILE_BLOCK_CALLBACK = 5,
	#~~ifdef~~ PC \|\| PS3		#if defined(PC) \|\| defined(PS3)
	XFILE_BLOCK_VERTEX = 6,		XFILE_BLOCK_VERTEX = 6,
	#ifdef PC		#ifdef PC