Difference between revisions of "HOWTO-Mac Games"

From ScummVM :: Wiki
Jump to navigation Jump to search
(Expand the explanations a bit)
(rewrite HOWTO-Mac Games to be more generic)
Line 1: Line 1:
= Windows =
+
This is a HOWTO for extracting data from Macintosh games.
  
== Introduction ==
+
= Getting the Data =
  
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.
+
== Windows ==
  
== Tools ==
+
=== HFVExplorer ===
  
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 [http://home.earthlink.net/~gamba2/pc2mac.html 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.
+
In order to be able to read Mac floppies and CD's, you will need to download [http://web.archive.org/web/20011202005455/http://gamma.nic.fi/~lpesonen/HFVExplorer/ 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.
+
After inserting your media, start up the program. Make sure HFVExplorer is displaying hidden files: Select View->Options and enable "Show invisible Mac files" on the "File attributes" tab.
  
== Copying the game data file ==
+
Select the files and folders you want to extract. Then copy it by pressing ctrl+c or going to edit->copy. Navigate to where you want to copy the data. Then paste by pressing ctrl+v or going to edit->paste.
  
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.
+
A "Select copy mode" window will pop up. If you need a resource fork, you want to extract it as "MacBinary 2". Otherwise, you want to extract it as "Raw copy, data fork". If you don't know what you need, please see the [[Datafiles]] page to see if it says "resource fork" under the name.
  
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.
+
=== HFSExplorer ===
  
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.
+
Alternatively, you can use [http://www.catacombae.org/hfsx.html HFSExplorer] to extract data.
  
== Running extract_scumm_mac ==
+
== Linux ==
  
'''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)'''
+
=== Ubuntu ===
 
+
Working as of 9.04 (Jaunty).
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 [http://www.scummvm.org/documentation.php ScummVM documentation README] describes ScummVM and extract_scumm_mac usage in detail. If you have any questions, look at the [http://www.scummvm.org/faq.php ScummVM FAQ], the [http://www.scummvm.org/documentation.php ScummVM Documentation], and the [http://forums.scummvm.org/ ScummVM forums].
 
  
= Linux =
+
==== Command line ====
== Ubuntu ==
 
Working as of 9.04 (Jaunty).
 
=== Command line ===
 
 
#Install [http://www.mars.org/home/rob/proj/hfs/ hfsutils] (e.g. ''sudo aptitude install hfsutils'')
 
#Install [http://www.mars.org/home/rob/proj/hfs/ hfsutils] (e.g. ''sudo aptitude install hfsutils'')
 
#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)
 
#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)
Line 40: Line 32:
 
#*Use the -r hcopy option to copy only the Raw data if you don't need the resource fork
 
#*Use the -r hcopy option to copy only the Raw data if you don't need the resource fork
 
#You can optionally use [http://ibiblio.org/pub/linux/utils/compress/macutils.tar.gz 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.)
 
#You can optionally use [http://ibiblio.org/pub/linux/utils/compress/macutils.tar.gz 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.)
 +
 +
== Mac OS X ==
 +
Fortunately, Mac OS X already supports HFS discs. When you copy the data off the discs it should be able to copy it with both resource and data fork already, which ScummVM can handle out of the box.
 +
 +
If there are hidden files, you can use this Terminal command for showing hidden files in the Finder
 +
 +
defaults write com.Apple.Finder AppleShowAllFiles true
 +
 +
followed by relaunching the Finder (cmd+opt+esc, and then select Finder). To turn off hidden files again, repeat the command but change <tt>true</tt> to <tt>false</tt>.
 +
 +
= Naming Resource Forks =
 +
 +
This section mostly pertains to people ''not'' using Mac OS X.
 +
 +
If you have a file with a resource fork, you have to name the file in a certain way for ScummVM to pick up on it. If you have a MacBinary file, please make sure it has a ".bin" extension. If you have a raw resource fork, please make sure it has a ".rsrc" extension.

Revision as of 19:39, 23 September 2012

This is a HOWTO for extracting data from Macintosh games.

Getting the Data

Windows

HFVExplorer

In order to be able to read Mac floppies and CD's, you will need to download 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.

After inserting your media, start up the program. Make sure HFVExplorer is displaying hidden files: Select View->Options and enable "Show invisible Mac files" on the "File attributes" tab.

Select the files and folders you want to extract. Then copy it by pressing ctrl+c or going to edit->copy. Navigate to where you want to copy the data. Then paste by pressing ctrl+v or going to edit->paste.

A "Select copy mode" window will pop up. If you need a resource fork, you want to extract it as "MacBinary 2". Otherwise, you want to extract it as "Raw copy, data fork". If you don't know what you need, please see the Datafiles page to see if it says "resource fork" under the name.

HFSExplorer

Alternatively, you can use HFSExplorer to extract data.

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

Mac OS X

Fortunately, Mac OS X already supports HFS discs. When you copy the data off the discs it should be able to copy it with both resource and data fork already, which ScummVM can handle out of the box.

If there are hidden files, you can use this Terminal command for showing hidden files in the Finder

defaults write com.Apple.Finder AppleShowAllFiles true

followed by relaunching the Finder (cmd+opt+esc, and then select Finder). To turn off hidden files again, repeat the command but change true to false.

Naming Resource Forks

This section mostly pertains to people not using Mac OS X.

If you have a file with a resource fork, you have to name the file in a certain way for ScummVM to pick up on it. If you have a MacBinary file, please make sure it has a ".bin" extension. If you have a raw resource fork, please make sure it has a ".rsrc" extension.