LucasForums (
-   SCUMM (
-   -   Monkey Island Explorer (

bgbennyboy 04-20-2010 06:43 PM

Monkey Island Explorer
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).

[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 and the readme for more information.

Download it here.

Samnmax221 04-20-2010 10:13 PM

Cool, I'll have to play with it a bit.

elTee 04-21-2010 04:24 AM

I'm sorry Ben, I'm afraid this name is already copyrighted.

But I won't press charges ;)

bgbennyboy 04-21-2010 01:27 PM

Hee, a real blast from the past. I await my c+d letter from you ;)

SyntheticGerbil 04-21-2010 02:07 PM

Are there plans to allow you to dump the music with this someday?

elTee 04-21-2010 05:20 PM

No, unfortunately that was never intended to be a feature of -- oh... did you mean Ben? :(

LordTrilobite 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.

bobdowl 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.

bgbennyboy 06-20-2010 07:57 AM

Updated with support for the Xbox360 version of the game.

Kenko 07-07-2010 08:35 AM

Very useful, and it would be nice if you made it possible to sort the list by name.

Laserschwert 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? ;)

bgbennyboy 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.

Laserschwert 07-07-2010 12:09 PM

Ah, I see. I wasn't sure what Steam did to those files prior to unlocking.

bgbennyboy 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.

Gabez 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?

bgbennyboy 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.

LordTrilobite 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?

bgbennyboy 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.

LogicDeLuxe 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.

kenand 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.

kenand 11-22-2010 07:14 AM

I found an OSX app (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....

kenand 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

bgbennyboy 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.

kenand 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.

bgbennyboy 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.

kenand 11-22-2010 03:05 PM

If I have a fortunate UI elements are in PNG, that I could translate them.

bgbennyboy 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.

kenand 11-23-2010 03:42 AM

Is it possible to repair header ?

bgbennyboy 11-27-2010 03:53 PM

I dont have the time to look into it, sorry.

kenand 11-28-2010 06:16 AM

Not et all.
Thank you very much your great tools.

kenand 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
( 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

bgbennyboy 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

kenand 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.

bgbennyboy 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.

All times are GMT -4. The time now is 09:40 PM.

Powered by vBulletin®
Copyright ©2000 - 2016, Jelsoft Enterprises Ltd.
LFNetwork, LLC ©2002-2015 - All rights reserved.