Monkey Island Explorer
By Bennyboy
Version 0.6.0

New in this version (0.6.0):

What is Monkey Island Explorer?:
An explorer tool for Monkey Island 1 Special Edition and Monkey Island 2 Special Edition.
It does the following:

What do I need to use this?:
Some of the music in Monkey Island 1 and the sfx in Monkey Island 2 needs an extra program 'xWMAEncode.exe' to decode the music. See the limitations section below for more information.

How to use it:

Filtering the files:

Searching the files:

The XBox 360 versions:

Both MI1 and MI2 Special Editions were released for XBox - and both should work with this program. However you will need to decompress the .pak file with the XBDecompress tool first (google for it).
I have not tested the XBox games myself but others have, and have said that they work.

Annotation support:
The program supports 'annotations'. These contain alternative filenames for audio that are more descriptive than those present in the original audio files. Eg the MI2 speech annotation file means that instead of a filename of "5840" you will instead see "Stan's Kozy Krypts-- A Place to Spend Eternity, Not a Fortune."

Annotation files are included for MI2 speech and commentary files. If you create an annotation file for any of the other files please send it me so I can include it in a future release of the program.

Creating annotation files:
Annotation support is activated by creating an .annot file and putting it in the 'Annotations' folder. The format is fairly straighforward and you can get an idea from looking at the included annotations but the following is a brief guide to the structure of an annotation ini file.

Annotations are ini files. Each ini must have an [Info Header] section that will look something like this:

  Title=Monkey Island 2 - Special Edition - Commentary

Some audio files have proper filenames for each track while others just have numbers, the program uses UniqueFile1, UniqueFile2 and NoFiles to automatically identify the audio file that the ini corresponds to
UniqueFile1 and UniqueFile2 should be filenames that are unique and only appear together in that audio file. If the audio file just has numbers for names then these should be the name of the last two tracks
NoFiles is the number of tracks inside the audio file. Its important that this is correct or the audio file wont be detected.

The rest of the entries will look something like this:

  Annotation=I just have this nagging feeling I left the gas on in my restaurant.

The text between [] should be the original filename of the track.
The "Annotation=" text is the new filename

Certain characters arent allowed in Windows filenames (/\:*?"|) so these are removed from filenames when dumping.
There are two exceptions to this:

Some of the music for Monkey Island 1 is in xWMA format - xWMAEncode.exe needs to be in the same folder as the program so that music in this format can be played and dumped. I cant include this file as its part of the DirectX SDK but you can get it yourself.

You could download and install the DirectX SDK it'll be in the 'Utilities/Bin/x86' folder. Alternatively you may be able to get it from this page.

All source code is on my GitHub.

Jimmi Thogersen (Serge`) for infomation on the DXT file format and the MI1 pak format.
Jott for his work on the MI1 pak format.
Scott Talley for his mappings for the MI2 speech and commentary.

Contact me.

All my software is completely free. If you find this program useful please consider making a donation. This can be done on my website.

bennyboy 02/04/18