View difference between Paste ID: qFarfjk2 and gw11cGFA

 /*
  * Filename: RARCTemplate.bt
  * Last Modified: 2014-06-12
  * Author: Phillip "Antidote" Michael Thomas Stephens
  * Purpose: J3D Engine Archives (RARC)
  * License: GPLv2
  * 010 Version: >= 5.0
  */
 BigEndian();
 
 struct FileDescriptor
 {
-	ushort ID;
+    // All "files" have an ID, it can be used to create a find by ID function
-	ushort Unknown1 <format = hex>;
+    // rather than searching by name, iirc it corresponds with the file number used in
-	ushort Unknown2 <format = hex>;
+    // STB files, I think I confirmed this a while back but I'm not entirely sure
-	ushort FilenameOffset;
+    ushort ID;
-	uint   DataStart <format = hex>;
+    // The next value appears to be a sort of hash, if it's a directory node and NOT "." or "..",
-	uint   DataSize <format = hex>;
+    // it matches it's corresponding node in the node table, not sure of it's purpose,
-	uint   Zero;
+    // changing it's value does nothing of merit
     ushort Unknown1 <format = hex>;
     // Not sure what this one is
     ushort Unknown2 <format = hex>;
     ushort FilenameOffset;
-	char Type[4];
+    uint   DataStart <format = hex>;
-	uint   FilenameOffset;
+    uint   DataSize <format = hex>;
-	ushort Unknown <format = hex>;
+    uint   Zero;
-	ushort FileEntryCount;
+
-	uint   FirstFileStart;
+
 struct Node
 {
     // Kind of misleading, it's not really a Type descriptor,
     // it's more of a 4 letter uppercase version of the directories name.
-	FileDescriptor Descriptor;
+    char   Type[4];
-	local int tmp = FTell();
+    uint   FilenameOffset;
-	FSeek((file.StringTableStart + file.HeaderSize) + Descriptor.FilenameOffset);
+    // Read the above notation for Unknown1 in FileDescriptor
-	string Filename;
+    ushort Unknown <format = hex>;
-	FSeek(tmp);
+    ushort FileEntryCount;
-	if (Descriptor.ID == 0xFFFF && Filename != "." && Filename != "..")
+    uint   FirstFileStart;
-	{
+
-		FSeek(file.FileEntriesStart + (file.Nodes[Descriptor.DataStart].FirstFileStart * sizeof(FileDescriptor)) + 0x20);
+
-		FileEntry FileEntries[file.Nodes[Descriptor.DataStart].FileEntryCount] <optimize = false>;
+
-		FSeek(tmp);
+
-	}
+
-	else if (Filename != "." && Filename != "..")
+    FileDescriptor Descriptor;
-	{
+    local int tmp = FTell();
-		FSeek(file.DataStart + Descriptor.DataStart + 0x20);
+    FSeek((file.StringTableStart + file.HeaderSize) + Descriptor.FilenameOffset);
-		ubyte Data[Descriptor.DataSize];
+    string Filename;
-		FSeek(tmp);
+    FSeek(tmp);
-	}
+    // If the descriptor's ID is 0xFFFF it's a directory, otherwise it's a file
     if (Descriptor.ID == 0xFFFF && Filename != "." && Filename != "..")
     {
         // If we're a directory AND we're not "." or ".." we read in our children
         FSeek(file.FileEntriesStart + (file.Nodes[Descriptor.DataStart].FirstFileStart * sizeof(FileDescriptor)) + 0x20);
-	uint Magic <format = hex>;
+        FileEntry FileEntries[file.Nodes[Descriptor.DataStart].FileEntryCount] <optimize = false>;
-	if (Magic != 0x52415243)
+        FSeek(tmp);
-	{
+        // The reason we don't want to handle "." and ".." is because of a known quirk in computers,
-		Warning("Not a valid RARC File");
+        // I won't elaborate but here is a link on the issue:
-		return;
+        // http://stackoverflow.com/questions/2630054/does-c-limit-recursion-depth
-	}
+        // I.E, blame the stack implementation :P
-	uint FileSize <format = hex>;
+    }
-	if (FileSize != FileSize())
+    else if (Filename != "." && Filename != "..")
-	{
+    {
-		Warning("Malformed file, stored size does not match actual size");
+        FSeek(file.DataStart + Descriptor.DataStart + 0x20);
-		return;
+        ubyte Data[Descriptor.DataSize];
-	}
+        FSeek(tmp);
-	uint HeaderSize;
+    }
-	uint DataStart <format = hex>;
+
-	uint Unknown[4] <format = hex>;
+
-	uint NodeCount;
+
-	uint Unknown2[2] <format = hex>;
+
-	uint FileEntriesStart <format = hex>;
+    // The archive's Magic, must always be "RARC", if it's "Yaz0" it's "compressed"
-	uint StringTableSize <format = hex>;
+    uint Magic <format = hex>;
-	uint StringTableStart <format = hex>;
+    if (Magic != 0x52415243)
-	uint Unknown4[2] <format = hex>;
+    {
         Warning("Not a valid RARC File");
-	Node Nodes[NodeCount] <optimize = false>;
+        return;
-	local int tmp = FTell();
+    }
-	FSeek(FileEntriesStart + Nodes[0].FirstFileStart + 0x20);
+    // This value MUST equal the total size of the file, if it doesn't the game will reject it
-	FileEntry FileEntries[Nodes[0].FileEntryCount] <optimize = false>;
+    // if it's a vital archive the game will hang, otherwise the data simply won't be loaded
-	FSeek(tmp);
+    uint FileSize <format = hex>;
     if (FileSize != FileSize())
     {
         Warning("Malformed file, stored size does not match actual size");
         return;
     }
     uint HeaderSize;
     uint DataStart <format = hex>;
     // Appears to be a series of offsets, they do nothing of merit
     uint Unknown[4] <format = hex>;
     uint NodeCount;
     // These appear to be counts of some sort, again they do nothing of merit.
     uint Unknown2[2] <format = hex>;
     uint FileEntriesStart <format = hex>;
     uint StringTableSize <format = hex>;
     uint StringTableStart <format = hex>;
     uint Unknown4[2] <format = hex>;
 
     Node Nodes[NodeCount] <optimize = false>;
     local int tmp = FTell();
     FSeek(FileEntriesStart + Nodes[0].FirstFileStart + 0x20);
     FileEntry FileEntries[Nodes[0].FileEntryCount] <optimize = false>;
     FSeek(tmp);
 }file;