Extract files from Jazz Jackrabbit 2 installers.

CYBERDEV b4f55c4453 Add tests against shareware 6 days ago
dev ed48465c6c DEV:Info about installed files with Wine 6 days ago
src 5e6441997c Fix pre 1998 installer 6 days ago
tests b4f55c4453 Add tests against shareware 6 days ago
.editorconfig ccb11369e2 Initial 8 months ago
.gitignore ccb11369e2 Initial 8 months ago
COPYING ccb11369e2 Initial 8 months ago
Makefile 5e6441997c Fix pre 1998 installer 6 days ago
README.md 5e6441997c Fix pre 1998 installer 6 days ago

README.md

DiDi Extract

Extract files from Jazz Jackrabbit 2 installers.

NOTE: This is in alpha state.

==============================================================
            Welcome to DiDi Extract version 0.1.0
==============================================================

 Usage: didiextract [OPERATION] [OPTIONS] INPUT_FILE

  OPERATIONS
   -x --extract        OUTPUT_PATH  Extract files.
   -y --extract-doofus OUTPUT_PATH  Extract doofus.bin, which contains
                                    installer-strings, installer-icons/images
                                    and probably some instructions for the
                                    installer.
   -l --list                        List files.
   -V --verify                      Run extract without actually outputting
                                    files, crc32s will be checked.
   -v --version                     Print version and exit.
   -h --help                        Display this HELP.

  OPTIONS
   -g --group          GROUP_NO   List, verify or extract files inside this
                                  group-number. Use -l --list to see all
                                  files with their group numbers.
   -d --debug                     Print debug info.
   -s --silent                    Be silent, don't print anything.

  NOTES
    - Path to directory OUTPUT_PATH should exist and be writable.
    - All files DiDi Extract does output will be overwritten when they exist!

Name

The company that developed the installers was called Digital Dimensions, they used the magic DiDi as start of their header (at the overlay-offset of the PE32 installer file). That's where the name comes from.

State

Known working retail installers

INSTALLER PE BUILD MD5 REDUMP
Jazz Jackrabbit 2 1.0.0 1997-10-08 18:06:59 UTC dc3e89b7c7c4ebc7385c1be1d3f6f524 http://redump.org/disc/29874/
Jazz Jackrabbit 2 1.2.0 1998-04-07 18:33:37 UTC dd5e17e7770d33f01b942af112de9f29 http://redump.org/disc/10255/
Holiday Hare 1998-08-17 08:55:38 UTC 7a0d7c2470cddc8a5903d29dc58211c8 http://redump.org/disc/54717/
The Christmas Chronicles 1999-11-11 10:50:56 UTC 239f5a349d673cdcda13de88936f5860 http://redump.org/disc/36218/

Known working shareware

These have been validated by installing with Wine, and the output has been checked against DiDi Extract.

TITLE PE BUILD MD5 DL
Jazz Jackrabbit 2 Shareware 1998-04-07 18:33:37 UTC 189a5b2fc46191f613795a7d8140af6c Jazz2swc.exe
Jazz Jackrabbit 2 Shareware 1998-04-07 18:33:37 UTC 1ccbe6bbc634d28d81f0679507ab6e2a jazz2swf.exe
Battery Check 1998-04-16 11:38:15 UTC c7d87fd760f819ad6a8e518bbae7b632 SETUP.EXE
Jazz Jackrabbit 2 Shareware 1998-04-20 08:59:42 UTC 204ca36395e036bb54a43c8a24586e1b JAZZ2SWF.EXE
Jazz Jackrabbit 2 Shareware 1998-07-20 20:21:34 UTC 371833ac8dbabb37ca8e824dc4a0984b J2swc123.exe
Jazz Jackrabbit 2 Secret Files Demo 1999-02-15 13:59:17 UTC bf7327c8a25e1518688820b5526548db JazzJackrabbit2.exe
Jumbo Puzzel (Dutch) 1999-11-11 10:50:56 UTC 72f94f492872e2f3fe12e27274d00b53 Setup.exe
Jumbo Puzzel (Dutch) 1999-11-11 10:50:56 UTC 2910233aee425480ec341bc14c1665cf Setup2000.exe
Melk (Dutch) 2001-05-04 16:06:50 UTC ecd067077c455d80ecaaf767645b879c gamefull.exe
MelkPatch (Dutch) 2001-05-04 16:06:50 UTC 0b035e30486aac38c3754f047cc0bd4b patch.exe
MelkUpgrade (Dutch) 2001-05-04 16:06:50 UTC fbade558ce00f125f6c6469bc378f076 upgrade.exe
Melk (Dutch) 2001-05-04 16:07:05 UTC dc83ca3e30ddd0a88da2911093e5c18d gamelight.exe

Known corrupt shareware installers

TITLE PE BUILD MD5 DL
Jazz Jackrabbit 2 Shareware 1998-04-20 08:59:42 UTC 801a943bbf50cd8c4ee27d144bec49ab Jazz2swf.exe

Known issues

  • The CRC32 will mismatch for doofus.bin.
  • File datetime format is still unknown and thus not set.

Things that might be a problem

DiDi Extract is only tested on Little Endian systems.

Dependencies

NAME LICENSE URL
zlib Zlib https://www.zlib.net/