HOWTO-Mac Games

From ScummVM :: Wiki
Revision as of 14:02, 20 May 2010 by Jvprat (talk | contribs) (Expand the explanations a bit)
Jump to navigation Jump to search

Windows

Introduction

This is a rough description of how to use your Macintosh CD version of a classic LucasArts game with ScummVM on Win32. Following procedure describes how to do it with "Sam & Max Hit the Road Macintosh CD-ROM" on Windows 2000 Professional. Your mileage may vary with other titles or versions of Windows.

Tools

You will need the "Windows Installer" from the download page. If you're using a ScummVM version prior to 0.7.0 you additionally will need "ScummVM Tools Windows Installer" from the same page. To copy the game data file from the CD to your hard disc, you will need HFVExplorer. Make sure you get the "HFV Explorer installer" rather than the zip file. If you choose to download the zip file, make sure you read the readme included with HFVExplorer, to set it up properly.

You should be running as Administrator to install all of the tools. Everything else should work as a normal user. Run the ScummVM installers and allow them to install to the default location (C:\Program Files\ScummVM). Don't worry about overwriting files. Run the HFVExplorer installer and allow it to use its defaults.

Copying the game data file

Start up HFVExplorer; if you do not have a shortcut for it, find it in "c:\program files\HFVExplorer". It should open the HFS (Macintosh filesystem) CD-ROM automatically when you insert the disc. Make sure HFVExplorer is displaying hidden files: Select View->Options and enable "Show invisible Mac files" on the "File attributes" tab.

Now, look for the data file in the right pane. It will probably end with the word "Data" and will be the largest file on the volume. For instance, it is called "Sam & Max Data" on the "Sam & Max" CD-ROM. Select the data file and copy it (use Ctrl+C or Edit->Copy). In the left HFVExplorer pane, navigate to the directory where you want the game to reside on your hard disc. We recommend selecting drive C: and creating a new folder called "SamNMax" or a name that better reflects your particular game.

Paste the data file (with Ctrl+V or Edit->Paste) and allow HFVExplorer to choose the copy mode. Now, wait while the program copies several hundred megabytes from the CD. When the file is copied, close HFVExplorer.

Running extract_scumm_mac

NOTE: If you are using ScummVM version 0.7.0 and above, you do not need this. Just point ScummVM to the folder where you copied the Data file. (Hint: If you are using an older version we strongly recommend to upgrade)

Open a command prompt window and change the directory to your newly created folder. Then, run extract_scumm_mac on the data file to extract its contents. For example, type the following for Sam & Max, making sure you use double quotes around the data filename:

 cd c:\SamNMax c:\program files\ScummVM\tools\extract_scumm_mac "Sam & Max Data"

Once the several files are successfully extracted, you can delete the data file or move it to a separate folder. Now, you can fire up ScummVM and add the new game to play it. The ScummVM documentation README describes ScummVM and extract_scumm_mac usage in detail. If you have any questions, look at the ScummVM FAQ, the ScummVM Documentation, and the ScummVM forums.

Linux

Ubuntu

Working as of 9.04 (Jaunty).

Command line

  1. Install hfsutils (e.g. sudo aptitude install hfsutils)
  2. If you don't already know it, find the device name of the drive the disc is in (e.g. doing eject /dev/cdrom type commands is a good way)
  3. Run hmount /dev/devicename. This will let all the other hfsutils know what they should refer to
  4. Use hls, hcd, hcopy to copy all the required files to your hard disc (man hfsutils will list all the available commands)
    • Use the -m hcopy option to use the MacBinary format if you need the resource fork
    • Use the -r hcopy option to copy only the Raw data if you don't need the resource fork
  5. You can optionally use macutils to manage mac files after you've copied them (with this you can extract concrete forks, convert between formats, repackage several forks into a MacBinary, etc.)