blueskythlikesclouds / tagtools

Tools for editing Havok 2015/2016 binary tag files (See Havoc branch for reference)

Tag Tools

Tools for editing Havok 2016 1.0 binary tag files.

Releases

EXE Release

Tools

Tag Tools

This tool can be used to convert Havok files (version <= 2012 2.0) to Havok 2016 1.0 binary tag files, and vice versa.

Usage

TagTools [source] [destination]
Destination is optional, meaning you can do a drag and drop, saving changes to the source file.

Example

TagTools chr_Sonic_HD.skl.hkx chr_sonic.skl.hkx

Collision Converter

This tool converts rigid bodies within a Havok file to static compound shapes.
For example, this can be used to convert Sonic Generations collision to Sonic Lost World / Sonic Forces collision.

Every collision mesh has a "type" as well as various "flags".
To specify these, simply append "tags" at the end of the names of your collision meshes, like so:

MyCollisionMesh -> MyCollisionMesh@Grass
MyOtherCollisionMesh -> MyOtherCollisionMesh@WallJump@Not_Ground@Stone

Any of the following can be used as valid tags:
(NOTE: Not all of these are functional in-game; the "@PARKOUR" flag doesn't seem to do anything in Forces, for example.)

Types

@STONE
@EARTH
@WOOD
@GRASS
@IRON
@SAND
@PHANTOMCUBE
@FORD
@GLASS
@SNOW
@SANDFALL
@ICE
@WATER
@SEA
@WATERFALL
@DEAD
@WATERDEAD
@DAMAGE
@POOL
@AIR
@INVISIBLE
@WIREMESH
@DEAD_ANYDIR
@DAMAGE_THROUGH
@DRY_GRASS
@WETROAD
@SNAKE

Flags

@NOT_STAND
@SLIDE
@BREAKABLE
@STAIRS
@PARKOUR
@WALLJUMP
@NOT_GROUND
@PRESS_DEAD
@MOVABLE
@RAYBLOCK
@SLIP

NOTE: This tool saves files in 2012 2.0 packfile format. If you wish to get 2016 1.0 binary tag file, use TagTools after converting your collision.

Usage

CollisionConverter [source]
Since the tool accepts only one argument, you can do a drag and drop, saving changes to the source file.

Example

CollisionConverter ghz200_col.phy.hkx

This tool was originally made by NeKit, TwilightZoney and N69 for Sonic Lost World.
Modified by me to work with Tag Tools.

License

Tag Tools uses the MIT License.
For details, see LICENSE.