Difference between revisions of "User Manual/Installing a game for use with ScummVM"

From ScummVM :: Wiki
Jump to navigation Jump to search
(Add section for FOTAQ)
(group BASS, BS1 and BS2 into a "Revolution Software Games" section.)
Line 96: Line 96:
 
TO DO: add screenshot and description of in-game menu.
 
TO DO: add screenshot and description of in-game menu.
  
== Beneath a Steel Sky ==
+
== Revolution Software Games ==
=== Installation ===
+
=== Beneath a Steel Sky ===
 +
==== Installation ====
 
In August 2003, the creators and copyright holders of Beneath a Steel Sky, [[Revolution|Revolution Software]], released the game as freeware for use with ScummVM. You can therefore download the game from our [http://www.scummvm.org/downloads.php#extras Downloads page]. Then follow the general [[User_Manual/Running and Using ScummVM#Installing_Games|installation instructions]].
 
In August 2003, the creators and copyright holders of Beneath a Steel Sky, [[Revolution|Revolution Software]], released the game as freeware for use with ScummVM. You can therefore download the game from our [http://www.scummvm.org/downloads.php#extras Downloads page]. Then follow the general [[User_Manual/Running and Using ScummVM#Installing_Games|installation instructions]].
  
=== Hotkeys ===
+
==== Hotkeys ====
 
{|class="wikitable"
 
{|class="wikitable"
 
! Hotkey
 
! Hotkey
Line 124: Line 125:
 
|}
 
|}
  
== Broken Sword 1 ==
+
=== Broken Sword 1 ===
=== Installation ===
+
==== Installation ====
 
For this game, you will need all of the files from the clusters directories on both CDs. You will also need the speech.clu files from the speech directories, but since they are not identical you will need to rename them speech1.clu and speech2.clu for CD 1 and 2 respectively.
 
For this game, you will need all of the files from the clusters directories on both CDs. You will also need the speech.clu files from the speech directories, but since they are not identical you will need to rename them speech1.clu and speech2.clu for CD 1 and 2 respectively.
  
Line 132: Line 133:
 
ScummVM does not support the original cutscene files (with file extension .smk) for legal reasons, so there is no need to copy them. [[Revolution|Revolution Software]] kindly permitted us to reencode them into DXA and distribute them freely on our site. You can get them on [http://www.scummvm.org/downloads.php#extras the download page]. If you want to see the cutscenes when playing these games with ScummVM you need to download these reencoded cutscenes and install them in the directory in which you copied the other games files on your hard drive.
 
ScummVM does not support the original cutscene files (with file extension .smk) for legal reasons, so there is no need to copy them. [[Revolution|Revolution Software]] kindly permitted us to reencode them into DXA and distribute them freely on our site. You can get them on [http://www.scummvm.org/downloads.php#extras the download page]. If you want to see the cutscenes when playing these games with ScummVM you need to download these reencoded cutscenes and install them in the directory in which you copied the other games files on your hard drive.
  
=== Hotkeys ===
+
==== Hotkeys ====
 
{|class="wikitable"
 
{|class="wikitable"
 
! Hotkey
 
! Hotkey
Line 141: Line 142:
 
|}
 
|}
  
== Broken Sword 2 ==
+
=== Broken Sword 2 ===
=== Installation ===
+
==== Installation ====
 
For this game, you will need all of the files from the clusters directories on both CDs. (Actually, a few of them may not be strictly necessary, but the ones that I’m uncertain about are all fairly small.) You will need to rename the speech.clu and music.clu files speech1.clu, speech2.clu, music1.clu and music2.clu so that ScummVM can tell which ones are from CD 1 and which ones are from CD 2. Any other files that appear in both cluster directories are identical. Use whichever you like.
 
For this game, you will need all of the files from the clusters directories on both CDs. (Actually, a few of them may not be strictly necessary, but the ones that I’m uncertain about are all fairly small.) You will need to rename the speech.clu and music.clu files speech1.clu, speech2.clu, music1.clu and music2.clu so that ScummVM can tell which ones are from CD 1 and which ones are from CD 2. Any other files that appear in both cluster directories are identical. Use whichever you like.
  
Line 149: Line 150:
 
ScummVM does not support the original cutscene files (with file extension .smk) for legal reasons, so there is no need to copy them. [[Revolution|Revolution Software]] kindly permitted us to reencode them into DXA and distribute them freely on our site. You can get them on [http://www.scummvm.org/downloads.php#extras the download page]. If you want to see the cutscenes when playing these games with ScummVM you need to download these reencoded cutscenes and install them in the directory in which you copied the other games files on your hard drive.
 
ScummVM does not support the original cutscene files (with file extension .smk) for legal reasons, so there is no need to copy them. [[Revolution|Revolution Software]] kindly permitted us to reencode them into DXA and distribute them freely on our site. You can get them on [http://www.scummvm.org/downloads.php#extras the download page]. If you want to see the cutscenes when playing these games with ScummVM you need to download these reencoded cutscenes and install them in the directory in which you copied the other games files on your hard drive.
  
=== Hotkeys ===
+
==== Hotkeys ====
 
{|class="wikitable"
 
{|class="wikitable"
 
! Hotkey
 
! Hotkey
Line 164: Line 165:
 
|}
 
|}
  
=== Configuration ===
+
==== Configuration ====
 
This game has some specific configuration settings described in [[User_Manual/Configuration#Game_specific_settings|the Configuration section]].
 
This game has some specific configuration settings described in [[User_Manual/Configuration#Game_specific_settings|the Configuration section]].
  

Revision as of 18:02, 8 March 2009

WORK IN PROGRESS, HELP NEEDED
If you want to contribute, send us a sample of text you'd write for the new manual, and we will consider adding you an account. You can work on the manual in the Wiki, but if you prefer, supplying us with HTML or TeX sources is fine, too (we will then translate them for the Wiki).

You can have a look at our TODO page for a list of tasks that need to be done.

LucasArts Games (SCUMM Engine)

Installation

The Curse of Monkey Island

For this game, you will need the comi.la0, comi.la1 and comi.la2 files. The comi.la0 file can be found on either CD, but since they are identical it doesn't matter which one of them you use.

In addition, you will need a resource subdirectory with all of the files from the resource subdirectories on both CDs. Some of the files appear on both CDs, but again they're identical.

Macintosh Games

All LucasArts SCUMM based adventures except Curse of Monkey Island also exist in versions for the Macintosh. ScummVM can use most (all?) of them, however, in some cases some additional work is required.

First off, if you are not using a Macintosh for this, accessing the CD/floppy data might be tricky. See notes in the Installing Games section.

Most of the newer games on the Macintosh shipped with only a single data file (note that in some cases this data file was made invisible, so you may need extra tools in order to copy it). ScummVM is able to directly use such a data file; simply point ScummVM at the directory containing it, and it should work (just like with every other supported game).

We also provide a tool called 'extract_scumm_mac' in the tools package to extract the data from these data files, but this is neither required nor recommended.

Maniac Mansion NES

Supported versions are English GB (E), French (F), German (G), Swedish(SW) and English US (U). ScummVM requires just the PRG section to run and not the whole ROM.

In order to get the game working, you will have to strip out the first 16 bytes from the ROM you are trying to work with. Any hex editor will work as long as you are able to copy/paste. After you open the ROM with the hex editor, copy everything from the second row (17th byte) to the end. After you do this, paste it to a new hex file. Name the new file "Maniac Mansion (XX).prg" while XX stands for the version you are working with (E, F, G, SW, or U). The final size should be exactly 262144 bytes.

If you add the game manually make sure that the platform is set to NES.

Most common mistakes which prevents the game from running:

  • Bad file
  • ROM extracted with the 0.7.0 tools
  • You try to feed ScummVM with the FULL ROM and not just the PRG section.

It is also possible to extract the separate LFL files from the PRG section. To do so use the 'extract_mm_nes' utility from the tools package.

Maniac Mansion Commodore 64

This games is detected and runs in ScummVM but is not yet completable. Simply name the D64 disks "maniac1.d64" and "maniac2.d64", then ScummVM should be able to automatically detect the game if you point it at the right directory.

Alternatively, you can use 'extract_mm_c64' from the tools package to extract the data files. But then the game will not be properly auto-detected by ScummVM, and you must make sure that the platform is set to Commodore64. We recommend using the much simpler approach described in the previous paragraph.

ZakMcKracken Commodore 64

Rename the D64 disks "zak1.d64" and "zak2.d64", then ScummVM should be able to automatically detect the game if you point it at the right directory.

Alternatively, you can use 'extract_zak_c64' from the tools package to extract the data files. But then the game will not be properly auto-detected by ScummVM, and you must make sure that the platform is set to Commodore64. We recommend using the much simpler approach described in the previous paragraph.

Hotkeys

Hotkey Description
Ctrl 0-9 and Alt 0-9 Load and save game state
Crtl-d Starts the debugger
Crtl-f Toggle fast mode
Crtl-g Runs in really REALLY fast mode
Crtl-t Switch between 'Speech only', 'Speech and Subtitles' and 'Subtitles only'
Tilde (~) Show/hide the debugging console
[ and ] Music volume, down/up
- and + Text speed, slower/faster
F5 Displays a save/load box (see ScummVM in-game menu).
Alt-F5 Displays the original save/load box, if the game has one (see ScummVM in-game menu).
i Displays IQ points (Indiana Jones and the Last Crusade, and Indiana Jones and the Fate of Atlantis)
Space Pauses
Period (.) Skips current line of text in some games
Enter Simulate left mouse button press
Tab Simulate right mouse button press

ScummVM in-game menu

This is the menu that you get by pressing F5 in the LucasArts games. It replaces the original menu present in some of the games. You can still access the original menu using Alt-F5 and you can save and load games using this, however it is not intended for this purpose, and may even crash ScummVM in some games.

TO DO: add screenshot and description of in-game menu.

Revolution Software Games

Beneath a Steel Sky

Installation

In August 2003, the creators and copyright holders of Beneath a Steel Sky, Revolution Software, released the game as freeware for use with ScummVM. You can therefore download the game from our Downloads page. Then follow the general installation instructions.

Hotkeys

Hotkey Description
Ctrl-d Starts the debugger
Ctrl-f Toggle fast mode
Crtl-g Runs in really REALLY fast mode
F5 Displays a save/load box
Escape Skips the game intro
Period (.) Skips current line of text

Broken Sword 1

Installation

For this game, you will need all of the files from the clusters directories on both CDs. You will also need the speech.clu files from the speech directories, but since they are not identical you will need to rename them speech1.clu and speech2.clu for CD 1 and 2 respectively.

In addition, you will need a music subdirectory with all of the files from the music subdirectories on both CDs. Some of these files appear on both CDs, but in these cases they are either identical or, in one case, so nearly identical that it makes little difference.

ScummVM does not support the original cutscene files (with file extension .smk) for legal reasons, so there is no need to copy them. Revolution Software kindly permitted us to reencode them into DXA and distribute them freely on our site. You can get them on the download page. If you want to see the cutscenes when playing these games with ScummVM you need to download these reencoded cutscenes and install them in the directory in which you copied the other games files on your hard drive.

Hotkeys

Hotkey Description
F5 or Escape Displays save/load box

Broken Sword 2

Installation

For this game, you will need all of the files from the clusters directories on both CDs. (Actually, a few of them may not be strictly necessary, but the ones that I’m uncertain about are all fairly small.) You will need to rename the speech.clu and music.clu files speech1.clu, speech2.clu, music1.clu and music2.clu so that ScummVM can tell which ones are from CD 1 and which ones are from CD 2. Any other files that appear in both cluster directories are identical. Use whichever you like.

In addition, you will need the cd.bin, cd.inf and startup.inf files from the sword2 directory on CD 1.

ScummVM does not support the original cutscene files (with file extension .smk) for legal reasons, so there is no need to copy them. Revolution Software kindly permitted us to reencode them into DXA and distribute them freely on our site. You can get them on the download page. If you want to see the cutscenes when playing these games with ScummVM you need to download these reencoded cutscenes and install them in the directory in which you copied the other games files on your hard drive.

Hotkeys

Hotkey Description
Ctrl-d Starts the debugger
Ctrl-f Toggle fast mode
p Pauses

Configuration

This game has some specific configuration settings described in the Configuration section.

The Feeble Files

TODO

Flight of the Amazon Queen

Installation

In March 2004, the creators and copyright holders of Flight of the Amazon Queen, John Passfield and Steve Stamatiadis, released the game as freeware for use with ScummVM. You can therefore download the game from our Downloads page. Then follow the general installation instructions.

Hotkeys

Hotkey Description
Ctrl-d Starts the debugger
Ctrl-f Toggle fast mode
F1 Use Journal (saving/loading)
F11 Quicksave
F12 Quickload
Escape Skips cutscenes
Space Skips current line of text