Difference between revisions of "Cave unit definition file"

From Pikmin Technical Knowledge Base
Jump to navigation Jump to search
Line 10: Line 10:
 
! Line || Example || Description || Comment
 
! Line || Example || Description || Comment
 
|-
 
|-
| 1 || <code>{</code> || Open unit entry || No comment
+
| 1 || <code>1</code> || Version || <code>version</code>
 
|-
 
|-
| 2 || <code>1</code> || Version || <code>version</code>
+
| 2 || <code>room_ike1_2_tsuchi</code> || Folder name of the unit to spawn || <code>foldername</code>
 
|-
 
|-
| 3 || <code>room_ike1_2_tsuchi</code> || Folder name of the unit to spawn || <code>foldername</code>
+
| 3 || <code>7 6</code> || Width (7) and height (6) of the unit that's spawning (line 3); defines how many cave grid cells this unit || <code>dX/dZ ; cell size</code>
 
|-
 
|-
| 4 || <code>7 6</code> || Width (7) and height (6) of the unit that's spawning (line 3); defines how many cave grid cells this unit || <code>dX/dZ ; cell size</code>
+
| 4 || <code>1</code> || Room type: 0=dead end, 1=room, 2=hallway || <code>room type</code>
 
|-
 
|-
| 5 || <code>1</code> || Room type: 0=dead end, 1=room, 2=hallway || <code>room type</code>
+
| 5 || <code>0 1</code> || The unit's flags; {{unknown}} || <code>room Flags</code>
 
|-
 
|-
| 6 || <code>0 1</code> || The unit's flags; {{unknown}} || <code>room Flags</code>
+
| 6 || <code>2</code> || The number of doors (exits) the unit has || <code>num doors</code>
|-
 
| 7 || <code>2</code> || The number of doors (exits) the unit has || <code>num doors</code>
 
 
|}
 
|}
  
Line 47: Line 45:
 
{{todo|Offs and wp index need to be documented}}
 
{{todo|Offs and wp index need to be documented}}
  
[[File:Dir3.png|200px|thumb|right|An example of <code>dirs</code> set on <code>3</code> while all other room <code>dirs</code> are set on <code>2</code>.]]
+
{{Credits|Jimble, Kai}}
 
 
'''Line 3:''' The number of door links. For example, <code>2 # door links</code>.
 
 
 
'''Line 4(+):''' Ddst/door-id/tekiflag; there are as many lines for these three numbers as there are door links (specified in line 3). For example, <code>849.951904 1 1 # dist/door-id/tekiflag</code>.
 
 
 
{{Credits|Jimble, Kai-Kai}}
 
 
[[Category:Pikmin 2]]
 
[[Category:Pikmin 2]]
 
[[Category:File formats]]
 
[[Category:File formats]]

Revision as of 12:10, 15 April 2019

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 height (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 flags; Unknown[unsure] 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, and wpindex Unknown[unsure] 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, door ID, and tekiflag dist/door-id/tekiflag


To do: Offs and wp index need to be documented

Credits: Jimble, Kai