Skip to content

Latest commit

 

History

History
59 lines (43 loc) · 4.16 KB

README.md

File metadata and controls

59 lines (43 loc) · 4.16 KB
Raw

KuroTools

Tools for working with Kuro no Kiseki .dat, .mdl and .tbl files. Also works on games released post-Kuro that use the same engine.

Compatibility

KuroTools is currently compatible with:

  • CLE's Steam release of Kuro no Kiseki
  • NISA/PH3's Steam release of Trails through Daybreak
  • CLE's Steam release of Kuro no Kiseki 2 -CRIMSON SiN-

Requirements

  • Python 3.10 and +

If the file is encrypted (CLE encryption):

  • zstandard package is required

Rundown of Main files

  • dat2py.py: Extracts scena files (.dat) intto .py for editing and can be used to recompile back into .dat post editing.
  • tbl2json.py: Extracts table files (.tbl) into .json for editing.
  • json2tbl.py: Compiles .json files into .tbl which can be loaded by Kuro no Kiseki.
  • kuro2compresses.py: Compresses files to be loaded into Kuro no Kiseki 2 -CRIMSON SiN-
  • kuro2encrypter.py: Encrypts files to be loaded into Kuro no Kiseki 2 -CRIMSON SiN-
  • mdl folder: source code of the MDL exporter/importer

Guide

Please see the following documents, which include a tutorial to make a simple mod using TBL and scripts editing, as well as a guide to Kuro model injection.

Guide for TBL & Scena editing
Guide for model injection

It's advised you use the disassemble mode for scena editing, as it will round trip perfectly (Decompilation might not round trip perfectly for some files, resulting in unreachable code. If that happens it may or may not cause issue after recompilation). To use the diassembler, just add --decompile False to the command.

With the advent of Ys X, some .dat files are known to throw a 'cannot convert float to int' error, resulting in an incomplete .py file being rendered. In the case of such an error being encountered while modding, please switch to disassemble mode as outlined in the previous paragraph and run dat2py again on the .dat file.

See this to learn how to add your own schemas to the tool.
And this guide can help you script the AIs (to create your custom battles).

For Kuro 2, The textures and models will require compression, and the dat and tbl files will require compression+encryption (Remember: Its always compression first, encryption second)

MDL extraction/import

From version 1.2.0, we introduce a new tool for asset extraction for Kuro 1 ONLY.

To use the tool, either drag and drop a mdl on ED9AssetExporter.exe, or put the base mdl (ex: chr0000.mdl) together with their animations (ex : chr0000_mot_ev_ride_bike_wait.mdl) in the same folder, then drop that folder on ED9AssetExporter.exe (it will hopefully add the animations to the base model).

The tool outputs a single fbx file. Textures are not included in the mdl so you have to retrieve them from the game files and put them in the same folder than the output fbx before opening it in blender or whichever 3D tool you are using.

As of version 1.3, the tool also supports model injection (MDL creation from FBX file) for Kuro 1 ONLY. See the guide above on how to do it. Showcase

Alternative tools

Scena editing

The script disassembler is very rough and not very userfriendly, more like a prototype type of thing made from the study of PS4 eboot. If you find it too difficult, please have a look at other alternatives to decompile the script files:

MDL export