Difference between revisions of "PikBinGen"

From Pikmin Technical Knowledge Base
Jump to navigation Jump to search
(Translated readme.md from Github to Media Wiki style, added link to the tool.)
 
(There is absolutely no point in duplicating the information.)
 
Line 1: Line 1:
PikBinGen was created by Renol/Yoshi2 and can be found on his [https://github.com/RenolY2/PikBinGen Github Repository].
+
PikBinGen was created by Renol/Yoshi2. It converts between ''Pikmin'' binary gen files and (JSON formatted) text files.
  
__TOC__
+
== Download ==
 +
* [https://github.com/RenolY2/PikBinGen GitHub repository]
  
==PikBinGen==
+
[[Category:Tools]]
Tool for convertsion between Pikmin 1 binary gen files and (JSON formatted) text files.
+
[[Category:Pikmin]]
 
 
==Requirements==
 
* newest version of Python 3
 
 
 
Recommended: Python 3.6.6 https://www.python.org/downloads/
 
 
 
When installing it on Windows, make sure you check "Add Python to PATH" so that the included .bat files will work properly.
 
 
 
==Usage==
 
===Drag & Drop===
 
if you are on Windows, the provided gen_to_txt.bat and txt_to_gen.bat files allow simply dropping a file on them to convert it. Drop a .gen file on gen_to_txt.bat to convert it to .json, drop the converted .json file on txt_to_gen.bat to convert it back to .gen. As an example, "default.gen" will be converted to "default.json" by gen_to_txt and "default.json" will be converted to "default.gen" by txt_to_gen. Make backups of the original gen files if you want to keep them.
 
 
 
===Command line usage===
 
<pre>
 
python pikminBinaryGen.py [-h] [--gen2txt] [--txt2gen] input [output]
 
 
 
positional arguments:
 
  input      Filepath to the file that should be converted
 
  output      Filepath to which the result of the conversion will be written
 
 
 
optional arguments:
 
  -h, --help  show this help message and exit
 
  --gen2txt  If set, converts a .gen file to a json text file.
 
  --txt2gen  If set, converts a json text file to .gen
 
</pre>
 
 
 
===About the JSON Structure===
 
A lot about the gen format is unknown so the json text file contains some placeholder/unclear field names. Do you know the purpose of some fields? Open an issue about that and if I can confirm it then I will add better names to the tool.
 
 
 
Keep an eye out for this page [[Pikmin_gen_codes]] (and add your own discoveries if you have any)
 
 
 
==FAQ==
 
* Q: How can I see where I put my objects without starting the game?
 
* A: I uploaded all the models of Pikmin 1 courses as texture-less OBJs here, ripped straight from the mod files: https://mega.nz/#!edJ2yLLB!HGOsQh47yW--TtZg-bw_W90HKUC2_c6tmm3Ht7PjKO4 You can load them into my Pikmin 2 Routes editor which renders obj files top-down, or load it into any 3D modelling program you prefer, to figure out coordinates for objects. The routes editor can be found here: https://github.com/RenolY2/pikmin-tools/releases
 
 
 
==How to update==
 
The field names are subject to change in future versions of the tool. When they change, text files created with older versions of the tool might not work with newer versions of the tool. If that happens, convert your text file to gen with the last version of the tool that still worked, then convert it back to text with the newest version.
 

Latest revision as of 17:51, 12 January 2019

PikBinGen was created by Renol/Yoshi2. It converts between Pikmin binary gen files and (JSON formatted) text files.

Download[edit]