DDR Tools

Tools for extracting and modifying files from Dance Dance Revolution CS games.

TCB Tools

Tools for extracting and converting TCB image files.

Building

mkdir build
cd build
cmake ..
make

Usage

tcb-extract

Search for and extract compressed and uncompressed TCB files within a file.

./tcb-extract <mode> <file containing TCBs>

Modes:

• 1 - Bruteforce search for compressed and uncompressed TCBs.
• 2 - Extract TCBs from file beginning with table (compressed entries).
• 3 - Extract TCBs from file beginning with table (uncompressed entries).

In most cases 1 works best as many table variations exist that 2 and 3 won't work with.

tcb-convert

Convert TCB files to PNG images or inject PNG images back into TCB files. The extracted image will be a standard RGBA PNG image converted from either a 16 or 256 color palletized source. When injecting a PNG back into a TCB, the image data will be updated and a new pallete will be generated to match the TCB's original format. The PNG you inject must be the same resolution as the TCB.

Convert TCB to PNG:

./tcb-convert e <TCB file>

Inject PNG into TCB:

./tcb-convert i <PNG file>

filedata-tool.py

Extract and create filedata.bin files.

python3 filedata-tool.py <mode> <elf file> <filedata.bin> <directory>

Modes:

• extract - Extract the contents of filedata.bin to directory. All files referenced in the file table located in the game's elf file will be extracted in addition to "hidden" data missing from the file table. A CSV file will be created named directory\fieldata.csv containing IDs, offsets, and lengths found in the game's ELF, hidden file offsets and lengths, the exported filename, and a guessed description of the file contents to aid in modification.
• create - Create filedata.bin using files in directory. The CSV created by the extraction mode is used to assemble a new file in the correct order and to update the file table in elf file.

Tips

• Don't modify the ids, offsets, or lengths in the CSV file created by the extraction mode. The filenames can be changed if desired.
• Don't change the order of the rows in the CSV file. It matches the order of the file table found in the game's ELF.
• New entries can't be added to the filetable, although this wouldn't be useful anyway. Instead, existing entries can be modified.