didiextract

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/