View Full Version : Monkey Island Explorer

04-20-2010, 06:43 PM
Its an explorer tool for Monkey Island 1 and 2: Special Editions. It does the following:

Lets you browse through the files and dump individual files/all files.
Lets you play and dump the audio (music, speech and sfx).
Lets you use 'annotations' to add more descriptive filenames for the audio so that you aren't just dumping files named 1.wav etc.
Displays the images as you browse and lets you save them as png's or DDS files (for editing).
Displays the txt/fx/csv files as you browse through the files.
As its based on the same code as my other explorer programs (mainly the unreleased Telltale Explorer) it lets you filter the files by typing in the search box and lets you filter the display by filetype.
There's an MI-themed animation when dumping files (I'd completely forgotten about this).

http://quick.mixnmojo.com/temp/MI_Explorer/MIExplorer1Small.jpg (http://quick.mixnmojo.com/temp/MI_Explorer/MIExplorer1.jpg)http://quick.mixnmojo.com/temp/MI_Explorer/MIExplorer2Small.jpg (http://quick.mixnmojo.com/temp/MI_Explorer/MIExplorer2.jpg)http://quick.mixnmojo.com/temp/MI_Explorer/MIExplorer3Small.jpg (http://quick.mixnmojo.com/temp/MI_Explorer/MIExplorer3.jpg)

[Edit] Updated - now supports MI2-SE and the Xbox/iPhone versions of the games.

[Edit 2] Updated - now plays and dumps audio and includes annotation support. See my site (http://quick.mixnmojo.com/software#miexplorer) and the readme for more information.

Download it here. (http://quick.mixnmojo.com/downloads?download=MISE_Explorer_0.4.zip)

04-20-2010, 10:13 PM
Cool, I'll have to play with it a bit.

04-21-2010, 04:24 AM
I'm sorry Ben, I'm afraid this name is already copyrighted (http://lucasforums.com/showthread.php?t=29369).

But I won't press charges ;)

04-21-2010, 01:27 PM
Hee, a real blast from the past. I await my c+d letter from you ;)

04-21-2010, 02:07 PM
Are there plans to allow you to dump the music with this someday?

04-21-2010, 05:20 PM
No, unfortunately that was never intended to be a feature of -- oh... did you mean Ben? :(

04-22-2010, 04:39 AM
Looks cool. I forgot, but that other extracter didn't support voice files did it?

Cause we need to fix the narrator's voice and replace it with blank files.

04-22-2010, 08:25 PM
Hey, this looks great! Any chance for a mac version?
Or has anybody had the chance to test it with the mac version yet?
I already own the iPhone version, but I'd like to do some visual mods to the desktop version.

06-20-2010, 07:57 AM
Updated with support for the Xbox360 version of the game.
Here. (http://quick.mixnmojo.com/files/MISE_Explorer_0.2.zip)

07-07-2010, 08:35 AM
Very useful, and it would be nice if you made it possible to sort the list by name.

07-07-2010, 11:04 AM
Any chance for an update to support MI2 as well?

And while we're at it, the XWA-extractor doesn't work with the music files from MI2. Any chance for an update of that as well? ;)

07-07-2010, 11:26 AM
When it unlocks, yes :)

The xwa extractor wont work with the music files yet as they (together with all the other resource files) are still encrypted by steam. Hopefully they'll be ok once it unlocks.

07-07-2010, 12:09 PM
Ah, I see. I wasn't sure what Steam did to those files prior to unlocking.

07-07-2010, 07:54 PM
Thanks to Serge I've updated Monkey Island Explorer to support MI2-SE. Its not fully optimised or anything yet - but it'll work for browsing the pak and extracting images and files.

It'll also work with the Xbox (if you use the XBDecompress tool) and iPhone versions should you feel the need to delve into them.

Get it here. (http://quick.mixnmojo.com/downloads?download=MISE_Explorer_0.3.zip)

07-13-2010, 05:49 PM
Awesome work as always, Ben! The image dumping is especially useful for Mi2 SE >:D

@elTee: were YOU the guy who made that? I am now slowly remembering it... but what was the point of it all?

07-20-2010, 06:48 PM
I've updated the program again.

This version adds support for playing and dumping the audio from both games (music, voice and sfx) and introduces annotation support.

Annotations 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. If you make any annotation files please send them to me so I can include them in the next release.

Get it here. (http://quick.mixnmojo.com/software#miexplorer)

07-21-2010, 05:55 AM
So does that mean it's possible to rip out the narrator's voice and replace it with blank audio files?

07-21-2010, 06:12 AM
Its certainly possible yes. However you'd need to build another wavebank, which is a little fiddly but I've successfully done.

08-07-2010, 04:02 AM
Could you add command line support?

I'd like to use it automated by the patching tool, which I'm writing for the classic talkie CD project.
It should support individual files, ie. we need just those two classic resource files of the pak.
And it should support extracting entire wavebanks, since we use most of the samples anyways.
The tool should terminate automatically and return an error code when command line extracting is done.

Is it okay to re-distribute the tool with the patch? I would keep "Monkey Island Explorer.html" intact, of course.

EDIT: I don't need it that badly anymore. I noticed the source is available in extractpak and changed it to only extract what I need.

11-11-2010, 07:22 AM
Dear Bgbennyboy,

Could you add pvr support to Monkey island explorer.
MISE2 for iPhone use pvr and crushed apple PNG files.
(MISE 1 used normal png)

I could save pvr files with your tool, but I did not find any application to edit them.
Imagination texture tool can not handle them, because this files created with apple texturetool.
I saw pvr from games and created with imagination texture tool with hex editor, and 2 files header are different.

11-22-2010, 07:14 AM
I found an OSX app (atPeek (http://www.atpurpose.com/atPeek/)), that can explore iPhone apps ipa files (ipa files are actually zip archives).
And atPeek can extracts and converts from crushed Apple png and pvr (power VR texture files) to normal (editable) PNG files.

I checked Monkey.Island.2.Special.Edition-v1.1-most_uniQue.ipa with atPeek.
( I checked free version also, but the result is same)
I was able to extract crushed PNG files from game's main directory ( BKG_iPad_bonusFeatures.png etc) and I was able to edit them.

I was able to extract and convert some pvr files with atPeek an other game file. (SW_ Hoth 1.0.ipa, light version is free)

But I'm trouble with MISE 2 , because pvr files are in pak archive. atPeek can not handle pak files.
So I extract pak files with Monkey explorer and put files to ipa file.
But atPeek can not recognize them. I think pvr files are corrupt.
(I compared mise2 PVR and Hoth pvr with hex editor and I did not see PVR! characters in the first line in MISE2's PVR files)

I can open The pvr texture files, which extracted from SW_Hoth.ipa with Imagination PVRTexToolGUI utility.
But it can not open pvr texrures from MISE 2.

May be Monkey explorer produce wrong/corrupt pvr files.
Is there any decryption process during extraction?

Dear Bgbennyboy,
Help me, if have you got any idea....

11-22-2010, 01:22 PM
I saw Monkey Island Explorer extracted PVR files.
First line:
4 ‹ í˝`I–%&/mĘ{JőJ×ŕtˇ

Corret PVR files first line:
4 � ŞŞ đ đ PVR!

PVR! is missing frm extracted files

11-22-2010, 02:45 PM
As far as I know there are no problems with the tool. I've tested it with the iphone/ipad lite version of MI2 and it works fine. All other file types work and dump correctly.

The problem isn't with the tool - its with the pvr files. I know nothing about that particular file but it sounds like they've changed the header slightly.

11-22-2010, 02:53 PM
I extracted pvr texture files from other iPhone games. And I can open them with imagination PVR texture tool.
But I extracted pak files of MISE 2 full and light version with Monkey explorer and I can not open them.

It's great shame, but I can not edit game files.

11-22-2010, 02:55 PM
Yes, because the pvr files are probably in a slightly different format. Just as the dds images are in the other versions.

11-22-2010, 03:05 PM
If I have a fortunate UI elements are in PNG, that I could translate them.

11-22-2010, 03:36 PM
I've had a quick look - it looks to me like a pvr texture with a truncated or modified header (there's the 4 byte header size and then width/height dwords - possibly more?)

A bit of googling reveals that iphone developers sometimes just have the raw PVRTC texture with a minimal header. Handy for saving space when you've got lots of images and dont want to have the full 52 byte header tagged on each image.

11-23-2010, 03:42 AM
Is it possible to repair header ?

11-27-2010, 03:53 PM
I dont have the time to look into it, sorry.

11-28-2010, 06:16 AM
Not et all.
Thank you very much your great tools.

09-14-2011, 01:04 PM
I have a trouble again.

So We made localised (Hungarian) version of Monkey Island SE 1 and 2 for PC and iPhone.
I just bought a JTAG XBOX 360, and I would like to make localisation for XBOX also.
I try Monkey Island Explorer with Xbox version Monkey1.pak, but it can not handle (version 0.4)
I used xbdecompress, than Eplorer opened decompressed monkey1.pak, but extracted dds files are corrupted, I can not open it with paint.net
( it worked well with PC version)

Please help

Version 0.4 don not work
Version 0.2 work with decompresed monkey1.pak, but do not work with monkey2.pak

09-14-2011, 02:04 PM
Version 0.4 should work fine to open either xbox version, provided you've used XBDecompress to decompress the pak file.

There does seem to be an issue with the dds files though, I'll have a quick look into it now

09-14-2011, 02:25 PM
Dear bgbennyboy,
I tried 0.4 with decompressed pak and did not work for me.
When I would like to see an image Ialways receive error mesage.

09-14-2011, 03:34 PM
Fixed it - was a stupid class overriding bug - the big endian detection got ignored. I'll upload new version later.

I've tried it with the demo versions of xbox mi1 and 2 that I was sent and it opens and works perfectly with both when XBDecompress has first been used to decompress the pak file.

[Edit] Done - see my site for the new version.