ExtractorsDecoders

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

ExtractorsDecoders

★ 20 Open GitHub ↗

various tools that extract archives of old games

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Extractors and Decoders

This repository contains Various tools to extract and decompress game archives I wrote over the years.
In most cases the goal was to extract game music.

A CMake project file is included that allows you to quickly build all tools.
The general compilation process is:

- `mkdir build`
- `cd build`
- compiling with GCC:
  - `cmake .. -DCMAKE_BUILD_TYPE=Release`
  - `cmake --build .`
- compiling with MS Visual C++:
  - `cmake ..`
  - `cmake --build . --config Release`

## adv98\_dec

This is a tool for decrypting executables from games by Ides. (`ADV98.OVL`, `ADVBIOS.OVL`, possibly other files)

The encryption is easily identifyable by the string `TC0` within the last 80 bytes of an EXE file.
It uses an XOR encryption with a pseudo-random key.

Most executables are encrypted 3 (!) times. The tool will remove all encryption iterations with one call.

The source code contains comments about the file structure of encrypted executables.

## CompileMLKTool

This tool extracts and creates `MLK` music archives used by various games developed by the Japanese game developer "Compile".

I developed it to extract the music from "Comet Summoner", which is part of Compile's "DiscStation Vol. 20". It is confirmed to work with all games from that disk.

Notes about the MIDI files:

- Looping has to be enabled using a flag in the MLK archive.
- Custom loop markers are supported. "Control Change 31" is the Loop Start marker. Channel and value do not matter.
- For some reason, "Time Signature" and "Key Signature" meta events are treated as Loop Start markers as well.
- SysEx messages don't seem to work.

## CompileWLKTool

This tool extracts and creates `WLK` sound archives used by various games developed by the Japanese game developer "Compile".

While writing the music tool for "Comet Summoner", I had a look at the `WLK` files as well and they looked simple, so I wrote a tool for them as well.

The tool is confirmed to work with all games from Compile's "DiscStation Vol. 20".  
Sounds are extracted to WAV files (format is PCM, 8-bit/16-bit, mono), as well as an accompanying text file that includes the internal flags field, as well as original file names where present.

There are two known variants of the `WLK` format:

- v1 has no magic bytes at the beginning
- v2 begins with "WLKF0200" and can optionally store the original file names and paths. "Comet Summoner" is one of the games that includes original file paths.

## dafa\_dec

This tool removes the encryption of `DUNGEON.EXE` from the PC-98 game "Dragoon Armor For Adult".

I wrote this tool to help BabaJeanmel with a translation of the game.

The encryption is done by XORing each byte in the original EXE file with a pseudo-random key.

## danbidec

This tool decrypts music files used by the Korean game developer "Danbi System".

The files are encrypted by XORing each byte with the low 8 bits of the file position.

It is confirmed to work with the `.D` and `.I` files from "GoGo!! Our Star" / "GoGo Uribyeol".

## DiamondRushExtract

This tool extracts the `.f` archives from the J2ME game "Diamond Rush" developed by Gameloft.

I just wanted to get the MIDIs.

## DIMUnpack

This tool unpacks certain `.DIM` disk image files that I was unable to open with DiskExplorer.

## FoxRangerExtract

This tool extracts music from the archives used by the Korean game developer Soft Action, which was responsible for the "Fox Ranger" series.

The archives themselves are unencrypted, but the unpacked files may need an XOR decryption.

## gensqu\_dec

This tool decompresses files from "Genocide Square" (FM Towns).

Supported are:

- `.ARD` files (archives with compressed files, use `-a` parameter)
- `.CAR` files (single compressed files, use `-f` parameter)

The game uses a custom variant of LZSS.

TODO: support extracting archives with uncompressed files

## kenji\_dec

This is a tool to extract and decompress archives used by the PC-98 adventure/VN engine that has the copyright notice "Programed by KENJI".

The adventure engine was commonly used by games published by Birdy Soft, Discovery and Orange House.

Files whose extension ends with a `1` usually contain only a single file.
Files whose extension ends with a `2` usually are archives and contain multiple files.

It was originally called "twinkle\_dec", because it was written to extract music from "Bunretsu Shugo Shin Twinkle Star".

The compression is standard LZSS with a non-standard initialization for the dictionary, which is the same that Wolf Team uses.

## LBXUnpack

This tool unpacks the `.LBX` files used by the DOS version of "Princess Maker 2".

## lzss-lib / lzss-tool

This library and tool allow you to decompress and recompress LZSS-compressed data.

Tool and libary allow to specify various compression parameters like:
- the initial values of the LZSS dictionary
- the bit order of the control characters
- the format of the backward reference word

The tool also allows you to specify a file header format using the additional parameters. This way simple LZSS-compressed containers can be supported as well.

## mrndec

This tool decompresses archives used by the Korean game developer "Mirinae Software".

It was confirmed to work with the .MUE files from their "The Day" series.

## piyo\_dec

This is a tool for decrypting the PC-98 executables (both `COM` and `EXE`) from games by PANDA HOUSE.

The encryption is easily identifyable by the string `PIYO`, which can be found offset 06h in COM files or within the last 120 bytes of an EXE file.
It uses an XOR encryption with a key that changes based on the unencrypted data.

I initially wrote it as "mfd\_dec" with the goal of decrypting the `MFD.COM` sound driver executable.

The source code contains comments about the file structure of encrypted executables.

## rekiai\_dec

This tool unpacks song archives used by the PC-98 game "Rekiai".

The `.MF` files contain

- the song title
- SSG and OPN instruments 
- MsDrv v4 files for OPN, OPNA and SC-55 MIDI

## sierra-restool

This tool extracts and creates Sierra resource/volume archives. It can also regenerate the archive index (hashmap) file.

The format is documented here: [TIM Resource Format (ModdingWiki)](https://moddingwiki.shikadi.net/wiki/TIM_Resource_Format)
The tool was made based on my own research though.

So far, the tool was confirmed to work with the following games:

- The Adventures of Willy Beamish (archives: `VOLUME.00#`, index: `VOLUME.RMF`)
- The Incredible Machine (archives: `RESOURCE.00#`, index: `RESOURCE.MAP`)

Example for extracting "The Incredible Machine" archives:

```bash
sierra-restool -x "RESOURCE.001" "unpack_001"
sierra-restool -x "RESOURCE.002" "unpack_002"
sierra-restool -x "RESOURCE.003" "unpack_003"
sierra-restool -x "RESOURCE.004" "unpack_004"
```

Example for repacking "The Incredible Machine" archives:

```bash
sierra-restool -c "RESOURCE.001" "unpack_001/_fileLst.txt"
sierra-restool -c "RESOURCE.002" "unpack_002/_fileLst.txt"
sierra-restool -c "RESOURCE.003" "unpack_003/_fileLst.txt"
sierra-restool -c "RESOURCE.004" "unpack_004/_fileLst.txt"
sierra-restool -m "RESOURCE.MAP" "RESOURCE.001" "RESOURCE.002" "RESOURCE.003" "RESOURCE.004"
```

## wolfteam\_dec

This tool decompresses archives used in games developed by Wolf Team.

The compression is standard LZSS with a non-standard initialization for the dictionary.

## x86k\_sps\_dec

X68000 S.P.S. Archive Unpacker

Confirmed to work with:

- Ajax (`MUSICS.AJX`)
- Daimakaimura (`TEXTDAT2.SLD`, `TEXTDAT4.SLD`)
- Final Fight (`BGM.SLD`, `BGM_MIDI.SLD`, `*.BLK`)
- Street Fighter II: Champion Edition (`FM.BLK`, `GM.BLK`)
- Super Street Fighter II: The New Challengers (`FM.BLK`, `GM.BLK`)
- M2SEQ executables (`SEQMM.X` from Märchen Maze, `SEQWS.X` from Pro Yakyuu World Stadium)

Notes about SF2/SSF2 BLK files:

- The tool can extract all BLK files from those games, but the auto-detection of the compression format will likely be wrong.
- Some BLK files contain uncompressed data (e.g. BLK files containing ADPCM sounds).
  For others you will need to explicitly specify the game's compression type using the `-c` parameter.

Notes about S.P.S compression formats:

- Final Fight uses standard LZSS, with BigEndian reference words and a 4 KB dictionary. (`lzss_tool -n 0 -C 1 -R 0x05`)
- Daimakaimura and SF2CE use mostly standard LZSS, but modified to use a BigEndian reference word and not requiring a 4 KB dictionary. Only the extracted data is referenced.
- Super Street Fighter II uses LZSS with modifications to how the reference word works. `SSF2_Compr.txt` contains a disassembly of its decompression code.

The source code of the tool contains detailed notes about how the respective archive formats works. (Most of them are just simple lists of file offsets or sizes.)
It is really annoying that almost every game uses a unique archive format.

## xordec

A simple tool that XORs the whole file with a user-specified key.

Some Korean game developers (e.g. Soft Action) use a simple XOR to encrypt their files.

ExtractorsDecoders

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README