Editing Paired ARC+DIR file

'''ARC''' files (likely short for '''Archive''') and '''DIR''' files (technically short for '''Bundle''', though '''Directory''' makes more sense and avoids conflict with [[Pikmin BUN Files|'''BUN''' Files]]) are two peas in a pod, together representing one of the many Binary Large Object (BLOB) archive formats used in Pikmin 1.  Together, they will henceforth be referred to as the ''Paired ARC+DIR Files'' archive.

With minimal metadata, {{unsure|the Paired ARC+DIR Files archive was likely used to reduce load time by packing several files into one}}.  The purpose it serves is different from the [[Pikmin BUN Files|Bundle]] archive, however, {{unsure|as standalone files within the archive can be unpacked independent of the files before it}}.  This makes the Paired ARC+DIR Files useful for archiving large directories with varied purposes.


__TOC__


==File Structure==
As mentioned before, the Paired ARC+DIR Files archive consists of two files: the mock-directory (DIR) and the BLOB archive (ARC).  Think of the mock-directory as a map to navigate through the BLOB archive.

===DIR===
DIR files consist of a header followed by a repeating struct for each mock-filepath.

Here is <code>root\dataDir\archives\pelletsbin.dir</code> annotated for reference.

[[File:DIR_file_documentation.png]][[File:Minty_Meeo_Documentation_Legend.png]]

{| class="wikitable" 
|+ Header
! Offset	|| Size		|| Purpose
|-
| 0x00		|| 4 		|| Size of DIR file	
|-
| 0x04		|| 4 		|| Number of structs	
|-
|}

{| class="wikitable" 
|+ Mock-Directory Struct
! Offset	|| Size		|| Purpose
|-
| 0x00		|| 4 		|| Offset of file in ARC	
|-
| 0x04		|| 4 		|| Size of file in ARC		
|-
| 0x08		|| 4	 	|| Mock-Directory String Length	
|-
| 0x0C		|| 0x08 value 	|| Mock-Directory Path		
|-
|}

====Mock-Directory====
The DIR file emulates filepaths.  When a file is unpacked in-game, it is assumed that whatever code is responsible treats the entry in the DIR file as a legitimate filepath on the disc, starting from the root.

===ARC===
Here is <code>root\dataDir\archives\pelletsbin.arc</code> annotated to demonstrate searching the BLOB archive.  Without the DIR file as a guide, the only way you could possibly differentiate between files would be with the <code>0xCC</code> padding between files.

[[File:ARC_file_documentation.png]][[File:Minty_Meeo_Documentation_Legend.png]]

====<code>0xCC</code> Padding====
For whatever reason, files in the ARC are always padded out to have an amount of bytes that is a multiple of 32.  These bytes are not included in the file size recorded in the DIR for each file, so the exact purpose of this is unknown.  {{unsure|It could be an absolute necessity, or it could be completely unnecessary.}}


==Extra Information==
Every Paired ARC+DIR Files archive has an uncompressed copy elsewhere on the disc.
* In <code>root\dataDir\tekis</code> and <code>root\dataDir\bosses</code>, a file named <code>arc_all.ini</code> can be found.  These INI files holds nothing, but give us a hint at how the developer's archiving tool functioned.
* It is unknown if the every file in the archives is identical to its uncompressed sister file.
In the [[OpenGL / Dolphin System]], many files are not read from the Paired ARC+DIR Files archives like they are in the final game, and are instead read from the un-archived versions.  

Paired ARC+DIR Files archives that have "bin" in their filename curiously only contain the '''BIN''' files from their respective directory.

The <code>log.txt</code> files left in the root of Pikmin 1 [[Pikmin|versions USA Demo, USA v1.00, and JPN v1.02]] detail the plugin "[[OpenGL / Dolphin System|plugTexConv]]" creating a Paired ARC+DIR Files archive.


[[Category:Pikmin]]
[[Category:File formaats]]
{{Credits|[[User:Minty_Meeo|Minty_Meeo]]}}