This tool converts CLNG, DITL, DLGE, LOCR, and RTLV to JSON and vice-versa.
It is a CLI tool, meaning there is no GUI and you must use a terminal i.e. PowerShell.
ResourceLib is required for this tool. For more information, see the installation page.
Intricacies of the formats will not be discussed on this page, it will only go through usage of the tool. For more information on the formats, read the HMLanguages page.
Converting any type file to JSON:
HMLanguageTools convert <game> <type> <input file path> <output file path>
The above command assumes that the
.meta.JSON file is located at
<input file path>.meta.JSON, to specify it, add the
--metapath <meta file path> option.
If converting DLGE, and you want more accuracy for the random container weights, add the
--hexprecision option when converting. It is not required for rebuilding.
For early H2016 LOCR files it may fail to convert. This is due to a different cipher being used, you can add the
--symmetric flag to fix this.
Rebuilding any JSON to a raw file + .meta.JSON:
HMLanguageTools rebuild <game> <type> <input json path> <output file path>
The above command will output the
.meta.JSON file to
<output file path>.meta.JSON, to specify it, add the
--metapath <meta file out path> option.
When converting and rebuilding DLGE, you must ensure that the language maps being used are correct for the languages in the file. If there are more or less in the map, the tool will fail to convert/rebuild.
The same applies to RTLV, but only on rebuild.
If the default language maps are incorrect for the file you're converting/rebuilding, you must specify them using the
More information on language maps can be found on the HMLanguages page.
usage: HMLanguageTools [--metapath path] [--langmap map] [--defaultlocale locale] [--hexprecision] [--symmetric] mode game type input_path output_path positional arguments: mode the mode to use: convert or rebuild. game the version of the game to convert/rebuild from/to: H2016, H2, or H3 type the type of the file: CLNG, DITL, DLGE, LOCR, or RTLV input_path path to the input file output_path path to the output file optional arguments: --metapath input/output path for the .meta.JSON (RPKG Tool!) --langmap custom language map, overrides the one provided by version: e.g. xx,en,fr,it,de,es --defaultlocale the default audio locale, used for DLGE conversion and rebuilding. default: en --hexprecision use this option if random weights should be output as their hex variants allowing for greater precision, used for DLGE convert only --symmetric if a symmetric cipher should be used, early H2016 LOCR only.