Jump to content

KwasTools (Hedgehog Engine)

From HedgeDocs
Revision as of 19:25, 10 May 2025 by Kwasior (talk | contribs) (Wrote more so that the page isn't a stub. Also added informations related to recent development of KwasTools.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
KwasTools
Author(s) Kwasior

KwasTools is a set of utilities for several games. Notably it contains tools to view and edit Hedgehog Engine *-anim family of formats and CRIWARE formats. A Blender addon called io_kwastools also exists for real-time preview and editing .cam-anim and .uv-anim files.

Entire suite of tools supports Windows and GNU/Linux operating systems.

Software

he_anim_tool

he_anim_tool running without any arguments given to the program. By default, it prints supported file formats and how to use the software.
Usage of he_anim_tool

he_anim_tool is a tool for modifying animation files native to the Hedgehog Engine 1 and 2.

Any given *-anim will be converted to its XML representation. Same goes for XML files - tool will know the output format thanks to root element's name (XML identifier).

Supported formats
Format Description XML identifier
.uv-anim Translation (v2), rotation and scaling (v3) of a texture in the material UVAnimation
.cam-anim Full control of in-game camera during events CAMAnimation
.vis-anim Visibility of the mesh VISAnimation
.morph-anim Animation of shape keys (Sonic's mouth in Unleashed/Generations uses this to speak) MORPHAnimation
.pt-anim Texture swapping (Tokyo DLC in Shadow Generations uses this for the billboard) PTAnimation
.mat-anim Transformation of a material (like swapping Sonic's mouth left-to-right) MATAnimation
.lit-anim Companion to .light files. Can animate its fields. LITAnimation

cri_awb_tool

Unpacker and packer for AWB audio archives. Does not support decrypting data (will extract contents as-is).

Extracts an AWB to a folder and writes an XML file with its metadata.

Creates an AWB from a folder of files (with default values) or from an XML descriptor.

cri_utf_tool

Converted bgm_miller.acb displayed in Notepad++ as an XML
bgm_miller.acb converted to XML

Multi-purpose tool for editing CRIWARE @UTF tables. Created for modification of .acb files, but will work fine with tables from other formats, such as .acf, .cpk, .aax, .usm or .csb.

In addition to @UTF, program will also parse ACB commands (used for example for looping of Sonic Frontiers' Titan songs) and embedded AWB files (which allows for modding music and sounds without shipping entire corresponding AWB file).

Cookies help us deliver our services. By using our services, you agree to our use of cookies.