New in this version (0.6.0):

• Fixed audio problems in Monkey Island 2 in the SFX archives. Thanks to 'MadKraut' on Twitter for letting me know about the problem.

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

• Lets you browse through the game's files and dump individual files/all files.
• Lets you play and dump the audio (music, speech and sfx).
• Displays the images as you browse and lets you save them as PNG's or DDS files (for editing)
• Displays the txt, fx and csv text as you browse through the files.
• Together with my Monkey Island Image Converter it forms part of a toolset that enables you to edit the images and put them back into the games (eg to create the much talked about 'hair patch').

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:

• Click Open and either click on open folder or choose one of the games and the game folder will automatically be found. Choose a .pak file to browse the data or go to the audio folder and choose a .xwb file to browse the audio.


• Click Save File to save a file. Different options will appear here depending on the type of file you've selected.


• Click Save All Files to save all files. Different options will be available here depending on the type of files available in the currently open resource file.

Filtering the files:

• Click on the View button to show a list of all the different file types, selecting one of these changes the view so that only these file types are visible.


• To reset the view and show all files, click the button again and click View All Files.

Searching the files:

• To search just type in the search box. Searching ignores any filter that you've used. I.e. the view will be reset to 'All Files'. The search looks in file names and is an 'instant search' - the search happens as you type.


• To reset the view either delete the text in the search box or click the View button and select View all 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
  UniqueFile1=29
  UniqueFile2=30
  NoFiles=31

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:

  [61]
  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:

• The forward slash character "/".
  If this is used then it becomes "-" in filenames. Eg "Annotation=c/o LeChuck's Island Getaway & Spa" would become "c-o LeChuck's Island Getaway & Spa"
  
• The colon character ":".
  If this is used then it becomes " -" in filenames. Eg "Annotation=I should warn you: I'm heavily armed." would become "I should warn you - I'm heavily armed."
  

Limitations:
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.

Source:
All source code is on my GitHub.

Thanks:
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.

Support:
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