HKXPack is a tool to 'pack' and 'unpack' to and from hkx files, which is the Havok compressed file format.

It was made to be used with the hk_2014.1.0-r1 file format, commonly used in Fallout 4. Given the opportunity, support for hk_2010.2.0-r1 or other hkx formats may be added.

The output format is intended to be TagXML, outputted by hkxcmd (https://github.com/figment/hkxcmd). Some other output formats may be added in the future (e.g. XAF/XMM for animations), but these format aren't the focus of the tool.

To use this tool, you will need the Java Runtime Environement (jre) at least version 1.8.0_66.

Use the command java -jar hkxpack.jar <filename>.hkx to extract the file into .xml

The tool was written for Java 8 (jdk1.8.0_66), and was intended to be a proof of concept.

You may find all available information under /doc. It contains mostly analysis and comparison of the hkx files as well as some software architecture concepts of the hkxpack software.

You might find out that some of the data required to run the tool is missing. That's because the 'classXML' files are obtained from the Fallout 4 game. You'll need the game to retrieve the files and, to prevent possible legal issues, they're not included in the sources. The way to obtain these files is currently built specifically for one machine, and its distribution isn't a priority.

Thanks to Figment for his help to obtain information about the hkx classes. Without him, none of this would be possible.
Thanks to CPU for his overall help with making this project.
Thanks to Orvid for his advices about how to make both working and clean code.
Thanks to Fore for his FNIS tool that allowed slight modifications of old files, and for sharing his knowledge of behaviors with me.
Thanks to the people from the NifTools IRC for helping with making this project and their overall support.