ScummVM -
FAQ :: Frequently Asked Questions

FAQ
last updated: May 10, 2005

1. Introduction
1.1. Why is it called ScummVM - what does this name mean?
1.2. What is SCUMM?
1.3. Is ScummVM free?
1.4. What games does ScummVM support?
1.5. Will ScummVM support other games?
1.6. When will Maniac Mansion Deluxe be supported?
1.7. Where do I find ScummVM?
1.8. How do I compile the source code for my OS?
1.9. On what platform does ScummVM run?
1.10. Does ScummVM run any non-SCUMM games?
1.11. Can I use ScummVM to make new games?
2. ScummVM and SCUMM games
2.1. Do I need original CD or Floppy disks?
2.2. Does ScummVM work with all versions of games?
2.3. Can I play through xxx (place your favorite SCUMM adventure here) ?
2.4. Can I save/restore the game?
2.5. Do savegames from the original games work in ScummVM?
3. Graphics and Audio
3.1. Does ScummVM support CD audio?
3.2. Does ScummVM support using MP3/Ogg/FLAC files instead of CD audio?
3.3. Does ScummVM support using MP3/Ogg/FLAC files instead of the original MIDI music?
3.4. Does ScummVM support filtered graphic modes?
3.5. Can I run my game full screen?
4. Troubleshooting
4.1. My game won't run.
4.2. I installed my game but ScummVM can't find it.
4.3. I don't hear any sound.
4.4. I don't hear any music.
4.5. My game crashes at some point.
4.6. ScummVM crashes, but console window disappears too quick to see the error message.
4.7. The game colors are messed up.
4.8. The subtitles in my non english game are messed up.
4.9. How do I make my mac version of a game work?
4.10. Reporting Bugs.
4.11. I downloaded the Broken Sword packs from your site but the game won't run.
4.12. There are no graphics in the Broken Sword I intro.
4.13. I get "WARNING: Unable to open configration file C:\windows\scummvm.ini!"
4.14. I get "Failed to save game state to file: xxx"
5. Features
5.1. Will you add support for zip archives?

1. Introduction

1.1. Why is it called ScummVM - what does this name mean?

Scumm comes from the fact that it was originally designed to run SCUMM games, like Monkey Island. VM stands for Virtual Machine.

1.2. What is SCUMM?

SCUMM stands for "Script Creation Utility for Maniac Mansion". It is a utility used to create the famous LucasArts adventure games.

It was initially created in 1987 by Aric Wilmunder and Ron Gilbert for the game "Maniac Mansion" and was used later, with some modifications, for Zak McKracken and the Alien Mindbenders. Development on the SCUMM system continued for some time, and was used in Loom, Indiana Jones and the Last Crusade, Indiana Jones and the Fate of Atlantis, Monkey Island 1,2,3, Sam & Max Hit the Road, Day of the Tentacle, The Dig and Full Throttle.

1.3. Is ScummVM free?

ScummVM is released under the GPL (General Public License), so it's more than free. ScummVM source code is freely available and you can do whatever you want with it. If you make modifications to it and redistribute your work you MUST make the source available. However, the ScummVM team would be pleased if you choose to send them your modifications, so they can be merged into the main tree.

1.4. What games does ScummVM support?

We have a compatibility list on our website that contains an up to date list of what games work, and how well they work. As well as SCUMM games, we also include virtual machines for the first two Simon the Sorcerer games (by Adventure Soft), Broken Sword 1/2 and Beneath a Steel Sky (by Revolution), as well as Flight of the Amazon Queen. Other games may be added, but this is not a common occurrence - see below.

1.5. Will ScummVM support other games?

The ScummVM team is currently focusing on bugfixes for our next release.

We do NOT generally add support for non-SCUMM games! Reverse engineering a completely new game without source is a long process, and our developers are all very busy as it is... so unless you work for a company interested in providing us with source code for one of your classic titles, please do not ask.

1.6. When will Maniac Mansion Deluxe be supported?

The short answer: never. The long answer: This game is a fan-made replica of the original Maniac Mansion. It is not the same game as Maniac Mansion Enhanced, which we do support. It features improved music, sound, 256-colors graphics and reworked game interface. It was made using the Adventure Game Studio which is a free, albeit closed-source graphics adventures engine. There are Windows, Linux and FreeBSD versions of the engine. Its author keeps his source code closed due to reasons explained in the project FAQ (see last two questions). That means that you need to download that program to play the game.

1.7. Where do I find ScummVM?

You can find it on the download section on our homepage. You can download the latest version, which could be a little old. For the most recent cutting-edge in-development version, you have to compile it yourself from CVS or use the 'daily builds' linked from our download page.

1.8. How do I compile the source code for my OS?

The source code package contains a file called README that should explain everything.

1.9. On what platform does ScummVM run?

ScummVM should be able to be compiled on any SDL platform, with just small modifications.

Currently tested platforms are Win32 (Windows 95/98/ME/NT/2000/XP), Linux i386 and PPC, BeOS, Solaris, Mac OS X, Dreamcast, MorphOS, IRIX, PalmOS and WinCE. It is also part of the Free/Net/Open BSD ports collections and included in Debian testing and unstable

1.10. Does ScummVM run any non-SCUMM games?

Yes. As well as SCUMM titles, ScummVM supports Simon the Sorcerer (1 and 2), Flight of the Amazon Queen, and the Revolution Games: Broken Sword 1, Broken Sword 2, and Beneath a Steel Sky.

Simon support was initially written by the original founder of ScummVM as a separate program, and later included in the main binary. Revolution Software Ltd. are very nice people and kindly provided us with the source code to BASS and Broken Sword 1/2, from which we based our interpreters. John Passfield and Steven Stamatiadis kindly provided the original source code to Flight of the Amazon Queen.

We do not have any plans to support any other non-SCUMM games at this time. If we do, it will be added to the Compatibility List.

Unless you work for a company interested providing us with source code for one of your classic titles, please do not ask us to support a game.

1.11. Can I use ScummVM to make new games?

While it is theoretically possible to write a new game that uses ScummVM it is not advisable. ScummVM has many hacks to support older games and no tools geared towards creating content usable by ScummVM. Potential game authors are encouraged to look at open source technologies such as libSDL for a cross platform DirectX like library, and the >Lua and Python scripting languages for game logic.

2. ScummVM and SCUMM games

2.1. Do I need original CD or Floppy disks?

Most definitely. ScummVM won't work without them. If you would like to buy these games, we suggest you browse Ebay. Do not ask the ScummVM team where you can download the full versions of LucasArts games. These requests will be ignored.

2.2. Does ScummVM work with all versions of games?

2.3. Can I play through xxx (place your favorite SCUMM adventure here) ?

2.4. Can I save/restore the game?

Yes. Saving and restoring is already supported (ALT-1/9 to save, CTRL - 1/9 to restore, or F5 to access the save/load menu).

2.5. Do savegames from the original games work in ScummVM?

No. We do not have any plans to load old savegames (with the exception of the Simon the Sorcerer series of games). Newer versions of ScummVM have also broken compatibility with older ScummVM savegames. Since ScummVM is in heavy development, this may occur again in the future.

3. Graphics and Audio

3.1. Does ScummVM support CD audio?

Yes, ScummVM fully supports CD audio in Monkey Island CD, and Loom. Just keep your game CD inserted into your CD drive when you start ScummVM. If you have more than one CD drive in your system. You can specify your CD drive using the -c command line parameter. See the README for more info.

3.2. Does ScummVM support using MP3/Ogg/FLAC files instead of CD audio?

Yes. You can use LAME or some other CD audio conversion utility to convert your CD audio to MP3. Since version 0.3.0 we also support Ogg Vorbis files. And FLAC is supported since version 0.7.0. See the README for more info.

3.3. Does ScummVM support using MP3/Ogg/FLAC files instead of the original MIDI music?

No. If all the game does is to play or loop a tune it would be possible, but many of the games do fancy stuff like smooth transitions from one tune to another, or turn individual instruments on and off, etc. There's simply no way ScummVM could take a piece of digital music and emulate that kind of behaviour.

This question usually comes up in connection with Sam & Max Hit the Road (which has a few unusued bonus audio tracks on the CD) and Monkey Island 2 (which is sometimes distributed on the same CD as the version of Monkey Island 1 that uses CD audio). Both of these games do far too much fancy stuff to even consider an idea like this.

3.4. Does ScummVM support filtered graphic modes?

Yes, ScummVM supports several filtered graphic modes such as super2xsai. See the README for more info.

3.5. Can I run my game full screen?

Yes. You can either start your game using the -f command line parameter, setting the game to Full Screen in the ScummVM Options dialog, or by using the Alt+Enter key combination in-game to switch between full screen and windowed modes.

4. Troubleshooting

4.1. My game won't run.

First make sure your game is supported. See "What games does ScummVM support?". If it is a supported game and you have followed the instructions in README to the letter, then see "Reporting Bugs." to report this as a bug.

4.2. I installed my game but ScummVM can't find it.

First don't use the install.exe or setup.exe shipped with the game. They usually will not do what you need to run the game with ScummVM -- rather they just copy the game .exe and install some shortcuts. ScummVM requires all game data to run, so you will need to copy those manually. Look at the Game Data Files page for further details.

4.3. I don't hear any sound.

Check the compatibility list to see if your game has sound support currently. You can also try the -s command line parameter to set the in game SFX volume.

4.4. I don't hear any music.

4.5. My game crashes at some point.

Check the Compatibility List to see if your game has any known issues. If you can reproduce this crash more than once, please report it to our Bug Tracker. See "Reporting Bugs.".

If you are experiencing random crashes, and your game plays music from CD, you have encountered a Windows bug. Try copying the data files from CD to your hard disk, and running them from there.

4.6. ScummVM crashes, but console window disappears too quick to see the error message.

To make it visible, you should run ScummVM from command line. To open a command prompt, open the Start Menu and select the 'Run' option. Under Windows NT/2000/XP, type 'cmd.exe' (no quotes) in the dialog box that shows up; under Windows 95/98/Me, type 'command.com' instead. If necessary, change to the proper drive first by typing 'D:' (where 'D' is the drive ScummVM is located). Change to ScummVM's directory by typing 'cd \your\path\to\scummvm' (substituting the appropriate path) and then type 'scummvm'.

4.7. The game colors are messed up.

This is a known issue with using Amiga version datafiles. Select Amiga as a platform in the ScummVM Game Options dialog, or use the --platform=amiga command line parameter to enable Amiga-specific code.

4.8. The subtitles in my non english game are messed up.

You are most likely using a game such as Maniac Mansion or Zak McKracken if you have this problem. You need to specify a language in the ScummVM Game Options dialog, with the -q parameter or by using the 'language' config file option.

Consult the README or command line help for further information.

4.9. How do I make my mac version of a game work?

First, if you use a ScummVM version prior to 0.7.0 we strongly recommend you to upgrade to the latest version, as we improved support for mac games considerably starting with 0.7.0.

For newer games ScummVM needs the main data file, usually called "<Game Title> Data" (where <Game Title> is name of your game, such as "The Dig" or "Sam & Max"). Some CDs may appear to only contain an application (watch out, it has almost the same name as the data file, except that it lacks the " Data" at the end). In that case there is still a separate data file but it is invisible.

The older games which have LFL files should only need the platform set to 'macintosh' to run. See "The game colors are messed up." for information on specifying the game platform.

4.10. Reporting Bugs.

To report a bug, please create a SourceForge account and follow the bugs link from our homepage. Please make sure the bug is reproducible, and still exists in the latest daily build/current CVS version. Also check the compatibility listing for that game to ensure the issue is not already known. In your bugreport please provide the following information:

  • ScummVM version (PLEASE test the latest CVS/Daily build)

  • Bug details, including instructions on reproducing it

  • Language of game (English, German, ...)

  • Version of game (talkie, floppy, ...)

  • Platform and Compiler (Win32, Linux, MacOS, ...)

  • Attach a save game if possible

  • If this bug only occurred recently, please note the last version without the bug, and the first version including the bug. That way we can fix it quicker by looking at the changes made.

4.11. I downloaded the Broken Sword packs from your site but the game won't run.

These are not full games but reencoded cutscene (video) packs. To run the games you still need the original disks. Originally cutscenes were encoded in proprietary format and Revolution Software kindly permitted us to reencode them into MPEG and distribute them freely on our site.

4.12. There are no graphics in the Broken Sword I intro.

Be patient. There are about 12 seconds of speech only and eventually the Revolution logo will appear.

4.13. I get "WARNING: Unable to open configration file C:\windows\scummvm.ini!"

Make sure you have enough permissions to write in c:\windows directory.

4.14. I get "Failed to save game state to file: xxx"

Check savepath in Options->Paths->Save Path. That should point to writeable directory.

5. Features

5.1. Will you add support for zip archives?

We will not do it. There are two main reasons for that. First, we believe that it would ease illegal distribution of games. Second, we already support compression of sound & speech in most larger titles, and use specially designed algorithms like MP3, Ogg and FLAC, so you can already reduce the size of the data files.

We as a team already discussed that question. We can't absolutely exclude the possibility of changing our mind one day in the future, but for now, we have no intentions to do so, hence please don't ask us about it!