Tools for working with files from Zone of the Enders

Building should only require a reasonably recent C compiler (e.g. GCC) and make, any required libraries are currently bundled and may be exchanged for submodules in the future (if possible).

The following libraries are currently bundled with the project and will be exchanged for git submodules in the future:

• lodepng

As long as the code is still included in this repository, see the individual libraries folder for licensing of it

For building on windows, slight changes to the Makefile may be required (like changing the extensions from .elf to .exe), the code of all tools should already be compatible

Useful things for debugging are:

• gdb
• valgrind

Additionally for comparison with actual game output:

• recordings of gameplay
• working emulator setup to play the game on your system

Note: Code quality and style may vary wildly between different code files. Feel free to propose a style to be used (but do not count on it). Minimal error checking is in place, but assume that any unexpected input will result in your system eating your cat.

Unpacks the ZOE.DAT file found in the root of the disc to allow easy access to its individual files. This also supports the TGS2000 demo, simply run with dat-extract [DAT] [any additional argument] to enable compatibility for it (note that mixing archives and modes will break things).
For unpacking STAGE.DAT from ZoE2, check ArmsDepot.

Dumps the sections found in efx files produced by sdx-extract and splits up the sequence block into individual sequences.

Walks through a mdx file produced by sdx-extract and prints the encountered events. Does not produce any output besides this.

Dumps the individual tracks found in mdx files produced by sdx-extract.

Unpacks various pak files found inside the unpacked ZOE.DAT.

Demuxes the pss files found inside the unpacked ZOE.DAT, outputs m2v video, vag audio, dmx polygon demo data and subtitles if found (see subtitle-convert to produce readable output).

Dumps the various kinds of data found in sdx files found in the unpacked ZOE.DAT, outputs wvx wave archives, efx and mdx sequences.

Converts the subtitles from pss-demux into ready-to-use srt files. Japanese subtitles are converted to UTF-8 (from EUC-JP) while any other language uses Windows CP-1252 (as this code was originally written on a Windows based system).

Converts the tex files found inside the unpacked ZOE.DAT into either PNG or raw RGBA images (see below for limitations).

Splits the wvx files produced by sdx-extract into ready to play vag files. Note that some files will throw errors or lock up players due to only containing the EOF marker.

All events are currently interpreted in the same way as MGS1, resulting in possible inaccuracies and leaving a lot of unknown events

The tex files contain bitmaps which can contain multiple subtextures, each with their own palette. Currently, for each subtexture the containing bitmap is output completely while applying the subtextures palette.

Unless noted otherwise in a source file, see LICENSE for details. For bundled libraries, see above.