PXD Animation Tools
PXD Animation Tools
PXD Animations Tools (formerly known as "FrontiersAnimDecompress" and "Frontiers Animation Tools") is a Blender add-on for importing and exporting animation (*.anm.pxd) and skeleton (*.skl.pxd) files from various Hedgehog Engine 2 games. The tool officially supports most Hedgehog Engine 2 titles including Mario & Sonic at the Tokyo 2020 Olympic Games, Sonic Origins, Sonic Frontiers, and Shadow Generations.
The add-on can currently perform compressed/uncompressed batch animation imports, compressed batch animation exports, skeleton reorientation, and officially supports Blender versions from 3.6 to 4.5 (as a legacy add-on in 4.2+). The add-on is Windows-only as it uses a DLL for ACL compression and decompression.
Downloads
The latest version of the tool at any point can be found here. The add-on should be installed as a zip file without extraction.
Usage
Video:
A video tutorial for basic usage of the add-on can be found here.
Text Overview:
A skeleton needs to be imported into the scene, and this skeleton must be selected in the viewport in order to import or export an animation. The add-on currently only reads bone indices from the animation file, so an animation can only be imported over the skeleton that it was originally made for. Batch functions can be found in the right ribbon of the viewport's sidebar, in the "PXD Animation" category under the "Animation" tab.
As long as all the bones' scale inheritance mode in your skeleton is set to "Aligned", and any targets for scale-modifying constraints follow the same inheritance mode, the skeleton should generally export exactly as you see in the viewport.
Per-animation settings (such as FPS and frame range) can be found in the "Action Editor" under the Dope Sheet editor. PXD specific settings may currently not show up for any animation that wasn't imported, or duplicated off of an imported animation.
When exporting custom skeletons, ensure that all bone names only contain alphanumeric characters. With the exception of underscores "_", any special characters (such as "." commonly auto-added to many duplicated resources in Blender) in bone names may cause a crash in-game upon loading.
In order to have a default game skeleton support mirroring in Blender, a skeleton must be imported using YX orientation (a togglable option in all import/export dialogues). If the skeleton is imported with this setting, all subsequent import/export operations from this add-on must enable YX orientation as well. If it is not properly called out, results in-game will not turn out as expected.
During batch operations, Blender may freeze and become unresponsive. The external Blender console window can (and should) be open so you may view a readout of the import progress instead of assuming the program is crashing. It is not recommended to batch imports hundreds of animations at a time. Depending on your hardware, you may want to play with a group of about 50 at a time or maybe up to 200 if you have a higher end system.
History:
The PXD formats were first supported by Blender add-on scripts that allowed model importing and skeleton importing for the files first found in the 2020 Olympic game in Blender 2.82.[1]
From Origins onward, animation data was identified to be compressed by ACL. An application called "FrontiersAnimDecompress.exe" was later created, which was used to dump decompressed track data (labeled as *.outanim files) from these newly compressed formats.[2] Included with the app were supplemental Blender scripts for importing from the dumped track data (modified from Turk645's original scripts), as well as custom scripts for exporting custom skeletons and raw track data that could later be recompressed.
The application was eventually modified into a DLL, and supplemental scripts were rewritten as one packaged add-on, so standalone conversion was no longer necessary.[3] Notable additions included batch processing, corrected scaling, skeleton reorientation for mirror support, and root motion.
Handling of raw track data was recently found to be identical across all Hedgehog Engine titles. The method in this add-on to achieve correct scaling can be reused for other Hedgehog Engine games stored in Havok animation formats.
This page was last edited on 11 January