Difference between revisions of "Cave unit generation"

From Pikmin Technical Knowledge Base
Jump to navigation Jump to search
m (Kai Vang moved page Cave unit definition file to Cave unit generation: Moving this page so that it flows well with how the game processes cave generation)
m (I added a link to the waterbox format and made some grammar and formatting fixes.)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
The caves you see in ''Pikmin 2'' are interesting that it takes individual models and stitches them together to create what you see. The information necessary for this is split between two folders.
 
The caves you see in ''Pikmin 2'' are interesting that it takes individual models and stitches them together to create what you see. The information necessary for this is split between two folders.
 
==Arc folder==
 
==Arc folder==
−
In <code>/user/Mukki/mapunits/arc/*</code> it contains two SZS archives which contain the bulk of the data. The <code>arc.szs</code> contains the model data in BMD format as well as its corresponding pause menu map texture as an IA BTI texture. The second archive labeled <code>texts.szs</code> contains it's collision, mapcode, route, and waterbox data. Extracting these archives puts them under the same folder called tmp.If you intend to recompile these folders with changes you've made make sure the split up the files according to which SZS archive contained them.
+
In <code>/user/Mukki/mapunits/arc/*</code> it contains two SZS archives which contain the bulk of the data. The <code>arc.szs</code> contains the model data in BMD format as well as its corresponding pause menu map texture as an IA BTI texture. The second archive labeled <code>texts.szs</code> contains it's collision, mapcode, route, and waterbox data. Extracting these archives puts them under the same folder called tmp. If you intend to recompile these folders with changes you've made make sure the split up the files according to which SZS archive contained them.
 
==arc.szs==
 
==arc.szs==
  
 
===BMD model===
 
===BMD model===
−
BMD models used for caves are particular given that the model typically must be created in chunks that are in 170x170 meters. This consistancy is necessary for the game to be able to correctly place each individual model seamlessly along one another. Some caves may only consist of a single large model. This gives a bit of creative freedom in the sense that the cave will always look the same without the RNG factor of cave generation. Consistant sizes aren't needed here since there is no concern for attaching two models. See [[Custom models|here]] for more information on creating a custom model.
+
BMD models used for caves are particular given that the model typically must be created in chunks that are in 170x170 meters. This consistency is necessary for the game to be able to correctly place each individual model seamlessly along one another. Some caves may only consist of a single large model. This gives a bit of creative freedom in the sense that the cave will always look the same without the RNG factor of cave generation. Consistent sizes aren't needed here since there is no concern for attaching two models. See [[Custom models|here]] for more information on creating a custom model.
 
===texture.bti===
 
===texture.bti===
 
{{todo|Create and link a page that details BTI texture formats.}}
 
{{todo|Create and link a page that details BTI texture formats.}}
 
A tiny texture that is used by the game to build the map you see on the pause menu. Each 8x8 pixels represents each 170x170 meters from its corresponding model. It is in an IA compressed BTI format. More information about GameCube's BTI texture formats can be found [http://wiki.tockdom.com/wiki/Image_Formats here].
 
A tiny texture that is used by the game to build the map you see on the pause menu. Each 8x8 pixels represents each 170x170 meters from its corresponding model. It is in an IA compressed BTI format. More information about GameCube's BTI texture formats can be found [http://wiki.tockdom.com/wiki/Image_Formats here].
 
==text.szs==
 
==text.szs==
−
===grid.bin===
+
===[[Pikmin 2 collision format|grid.bin]]===
−
This holds the [[Pikmin 2 collision format|collision data for area models]]. Yoshi2's tool obj2grid[https://github.com/RenolY2/obj2grid] converts any .OBJ to a working <code>grid.bin</code> and <code>mapcode.bin</code> that will work in-game.
+
This holds the collision data for area models. Yoshi2's tool obj2grid[https://github.com/RenolY2/obj2grid] converts any .OBJ to a working <code>grid.bin</code> and <code>mapcode.bin</code> that will work in-game.
  
−
===mapcode.bin===
+
===[[Pikmin 2 mapcode file|mapcode.bin]]===
−
Handles extra data assigned to the grid.bin to change the collison's "slipperyiess" and footstep sounds.
+
Handles extra data assigned to the grid.bin's mesh to change the collision's "slipperiness" and footstep sounds.
−
{{todo|Create and link a page that details mapcode.bin format.}}
 
−
===layout.txt===
 
−
{{todo|Create and link a page that details layout.txt format move specific information there.}}
 
−
This file controls the spawn coordinates for objects.The second line of the file, which follows the comment <code>BaseGen file</code>, specifies the number of spawn coordinate entries in the list. It is commented with <code>num gens</code> (number of generators).Each entry in the list is inside its own block. The first line in the block is the "type". Think of it as a group.  
 
  
−
Whenever the game wants to spawn an enemy, it picks a random coordinate from the same group as the enemy is. For instance, static Gatling Groinks should probably belong in a different group from the regular, free-roaming enemies. For a list of group IDs and what they're normally used for (although this is not a hard rule), see [[Cave definition file#Type|here]].
+
===[[Cave unit layout file|layout.txt]]===
 +
This file controls the spawn coordinates for objects.
  
−
The second line is the coordinates themselves, in the format <code>X Y Z</code>.
+
===[[Pikmin 2 route|route.txt]]===
−
 
 
−
{{todo|Document the third line.}}
 
−
 
 
−
The fourth line is the maximum radius in which the enemies can randomly spread out from the initial point.
 
−
 
 
−
The fifth and sixth lines are the lower and upper limits of the random amount. Every time the game picks a spawn coordinate to use, it generates a number between these two limits, inclusive. Then, it spawns that number of enemies in this spot (until it spawns more than it intended to, at least).
 
−
 
 
−
===route.txt===
 
 
Carrying paths plotted in coordinates based off the model.
 
Carrying paths plotted in coordinates based off the model.
−
{{todo|Create and link a page that details route.txt format.}}
 
  
−
===waterbox.txt===
+
===[[Pikmin 2 waterboxes|waterbox.txt]]===
−
Water boxes placed as two sets of coordinates to spawn a pool of water.
+
Water boxes placed as two sets of coordinates to spawn a pool of water. The format for waterbox generation in cave units is the same as in the overworld areas, and can be found at [[Pikmin 2 waterboxes| this page]].
−
{{todo|Create and link a page that details waterbox.txt format.}}
 
  
 
==Units folder==
 
==Units folder==
−
{{todo|Merge this page with [[Cave unit list file]] and rename this page to Cave unit generation?}}
+
This folder <code>/user/Mukki/mapunits/units/*</code> holds definitions that tells the game how to correctly position together a group cave units. More information can be found at [[Cave unit definition file| this page]].
−
This folder <code>/user/Mukki/mapunits/units/*</code> holds definitions that tells the game how to piece together cave models in a simple txt format.
 
  
  
 
[[Category:Pikmin 2]]
 
[[Category:Pikmin 2]]
 
[[Category:File formats]]
 
[[Category:File formats]]

Latest revision as of 21:43, 24 February 2024

The caves you see in Pikmin 2 are interesting that it takes individual models and stitches them together to create what you see. The information necessary for this is split between two folders.

Arc folder[edit]

In /user/Mukki/mapunits/arc/* it contains two SZS archives which contain the bulk of the data. The arc.szs contains the model data in BMD format as well as its corresponding pause menu map texture as an IA BTI texture. The second archive labeled texts.szs contains it's collision, mapcode, route, and waterbox data. Extracting these archives puts them under the same folder called tmp. If you intend to recompile these folders with changes you've made make sure the split up the files according to which SZS archive contained them.

arc.szs[edit]

BMD model[edit]

BMD models used for caves are particular given that the model typically must be created in chunks that are in 170x170 meters. This consistency is necessary for the game to be able to correctly place each individual model seamlessly along one another. Some caves may only consist of a single large model. This gives a bit of creative freedom in the sense that the cave will always look the same without the RNG factor of cave generation. Consistent sizes aren't needed here since there is no concern for attaching two models. See here for more information on creating a custom model.

texture.bti[edit]

To do: Create and link a page that details BTI texture formats.

A tiny texture that is used by the game to build the map you see on the pause menu. Each 8x8 pixels represents each 170x170 meters from its corresponding model. It is in an IA compressed BTI format. More information about GameCube's BTI texture formats can be found here.

text.szs[edit]

grid.bin[edit]

This holds the collision data for area models. Yoshi2's tool obj2grid[1] converts any .OBJ to a working grid.bin and mapcode.bin that will work in-game.

mapcode.bin[edit]

Handles extra data assigned to the grid.bin's mesh to change the collision's "slipperiness" and footstep sounds.

layout.txt[edit]

This file controls the spawn coordinates for objects.

route.txt[edit]

Carrying paths plotted in coordinates based off the model.

waterbox.txt[edit]

Water boxes placed as two sets of coordinates to spawn a pool of water. The format for waterbox generation in cave units is the same as in the overworld areas, and can be found at this page.

Units folder[edit]

This folder /user/Mukki/mapunits/units/* holds definitions that tells the game how to correctly position together a group cave units. More information can be found at this page.

Retrieved from "https://pikmintkb.com/w/index.php?title=Cave_unit_generation&oldid=4532"