Tool for modifying TMD model files of
Hyperdimension Neptunia U: Action Unleashed and
Megagmension Blanc + Neptune VS Zombies for PC.


These are CLI programs for the command prompt, there is no GUI.


----------
HOW TO USE
----------

- Modify model data using a modification config file

	- modify_tmd  TMD-FILE  -c  MODIFICATION-CONFIG-FILE  -o  OUT-TMD-FILE

		A modification config file is a text file that describes how to change model data.

		The file can be created using the add-on script io_export_mesh_for_modify_tmd.py
		for Blender.

		See modification_config_english.txt for the format of the modification config file.



	- modify_tmd  TMD-FILE  -c  MODIFICATION-CONFIG-FILE  -m  MATERIAL-CONFIG-FILE  -o  OUT-TMD-FILE  -d  OUT-DAT-FILE

		It also uses the material config file to make modifications and outputs a DAT file as well.

		The material config file is a text file that describes which texture to use for the part
		and which part to display depending on the damaged state of the costume.

		modify_tmd will also read the DAT file if it is in the same location as the TMD file.
		If the names of the TMD file and the DAT file are different from the names extracted by extract_cat,
		the DAT file cannot be read.

		See materrial_config_english.txt for the format of the material config file.



	- modify_tmd  TMD-FILE  DAT-FILE  -c  MODIFICATION-CONFIG-FILE  -m  MATERIAL-CONFIG-FILE  -o  OUT-TMD-FILE  -d  OUT-DAT-FILE

		Reads the specified DAT file.
		If the DAT file is not read automatically, specify the DAT file after the TMD file.



- Output model data parts in the form of modification config file

	- modify_tmd  TMD-FILE  -E  PART_ID[,...]  OUT-MODIFICATION-CONFIG-FILE

		Exports the vertex and face data of the specified part to the output file.



	- modify_tmd  TMD-FILE  -E  all  OUT-MODIFICATION-CONFIG-FILE

		Export the vertex and face data of all parts to the output file.



- Output material settings in the form of a material config file

	- modify_tmd  TMD-FILE  -M  OUT-MATERIAL-CONFIG-FILE

		Exports the material settings to the specified file.

		modify_tmd will also read the DAT file if it is in the same location as the TMD file.
		If the names of the TMD file and the DAT file are different from the names extracted by extract_cat,
		the DAT file cannot be read.



	- modify_tmd  TMD-FILE  DAT-FILE  -M  OUT-MATERIAL-CONFIG-FILE

		Reads the specified DAT file.
		If the DAT file is not read automatically, specify the DAT file after the TMD file.

		The Neptunia U DAT file contains information such as which texture files to use for the parts
		and which parts to display depending on the damaged state of the costume.
		Therefore, if the DAT file cannot be read correctly, the contents of the output material config file
		may be insufficient or incorrect.



-----------
Precautions
-----------

	There seems to be a limit to the number of texture files that can be used in the game.
	If you use a lot of texture files, the game may not work properly.
	Even if there is no problem when you challenge the quest by one character, it may not be possible for two characters.

	There may be a limit to the amount of data on vertices and faces, so it may be better not to increase them too much.



-------------
RELATED TOOLS
-------------

	Add-on script for Blender for TMD format files
	https://www.mediafire.com/file/u77upy3zhuhpwtm/io_import_tamsoft_tmd_20210228.7z/file

	Add-on script for Blender to export mesh to text file for modify_tmd
	https://www.mediafire.com/file/pv9mkjt4lmbct6p/io_export_mesh_for_modify_tmd_20210228.7z/file

	Extraction and Replacement Tool for CAT Files
	https://www.mediafire.com/file/telkcnsoubzemnc/cat_tool_20200828.7z/file

	Extraction, replacement, and creation tools for GXT files
	https://www.mediafire.com/file/1goptw6pom9c1jj/gxt_tool_20210228.7z/file



EOF
