Cave unit definition file

In Pikmin 2, each sublevel points to a cave unit definition file. These files can be found in /user/Mukki/mapunits/units, and contain a list of units that the game is allowed to use to create the cave with. This file just tells the generator how each cave unit attaches with one another. In other words, this file specifies all the rooms to spawn in a sublevel, depending on that sublevel's room count ({f005}).

Header

After a decorated set of comments that say units definition file comes a line containing the number of units defined in this file. This line is commented with number of units. Each unit's data is defined inside its own block, and conveniently has a comment before it that mentions its name.

Unit

Line	Example	Description	Comment
1	1	Version	version
2	room_ike1_2_tsuchi	Folder name of the unit to spawn	foldername
3	7 6	Width (7) and length (6) of the unit that's spawning (line 3); defines how many cave grid cells this unit	dX/dZ ; cell size
4	1	Room type: 0=dead end, 1=room, 2=hallway	room type
5	0 1	The unit's "room" flags. Judging by the name, and how most of the "room" type units have it set to 1, it's presumed to help count the room units as... well, rooms and not hallways or dead ends. Changing it to anything other than 1, or 0 for the non-room units, doesn't seem to do anything though.	room Flags
6	2	The number of doors (exits) the unit has	num doors

From this point onwards, before ending the unit entry, there are four lines for each door sub-entry.

Line	Example	Description	Comment
1	0	Door index	index
2	0 0 0	Direction, offset (starting from the left, determines how many cells to the right the door is), and wpindex (The index of the route waypoint for that door)	dir/offs/wpindex
3	1	The number of doors this can link to	door links

From this point onwards, before ending the door sub-entry, there is one line for each door link.

Line	Example	Description	Comment
1	1258.716064 0 1	Distance (used within score calculation), Door-id (Maps to another door index), and tekiflag Unknown[unsure]	dist/door-id/tekiflag

File list

This is a list of unit definition files, their theme and what units they contain.

File	Theme	Units (text)	Units (images)
1_ABE_ari_metal.txt	Metal	cap_metal, item_cap_metal, way3_metal, way4_metal, wayl_metal, way2_metal, way2x2_metal, room_ari1_3_metal
1_ABE_king_tsuchi.txt	Soil	item_cap_tsuchi, way3_tsuchi, way4_tsuchi, wayl_tsuchi, way2_tsuchi, way2x2_tsuchi, room_kingchp_tsuchi
1_ABE_manp_boss_conc.txt	Concrete	item_cap_conc, way3_conc, way4_conc, wayl_conc, way2_conc, way2x2_conc, room_manh7x7p_boss_conc
1_ABE_mid1_boss_tsuchi.txt	Soil	item_cap_tsuchi, way3_tsuchi, way4_tsuchi, wayl_tsuchi, way2_tsuchi, way2x2_tsuchi, room_mid1_6_boss_tsuchi
1_ABE_mid1_metal.txt	Metal	cap_metal, item_cap_metal, way3_metal, way4_metal, wayl_metal, way2_metal, way2x2_metal, room_mid2_3_metal
1_ABE_mid1_tsuchi.txt	Soil	item_cap_tsuchi, way3_tsuchi, way4_tsuchi, wayl_tsuchi, way2_tsuchi, way2x2_tsuchi, room_mid1_6_tsuchi
1_ABE_vshit67_toy.txt	Toybox	item_cap_toy, way3_toy, way4_toy, wayl_toy, way2_toy, way2x2_toy, room_vs_hitode6x7_4_toy
TBA	TBA	TBA	TBA

Credits: Jimble, Kai