ScummVM main repository
Go to file
2023-06-13 00:44:23 -04:00
.github CI: Bump vcpkg 2023-06-05 05:12:25 +01:00
audio AUDIO: Skip JUNK padding in WAV files 2023-05-28 13:56:59 +03:00
backends BACKENDS: ATARI: work around engines with unaligned pitch 2023-06-10 23:27:57 +02:00
base BASE: Add number of game variants to --stats option 2023-06-09 18:21:47 +02:00
common COMMON: Fix string method comments in forbidden.h 2023-06-12 19:14:09 -07:00
devtools CREATE_ENGINE: Remove duplicate files from new events style 2023-06-09 19:55:14 -07:00
dists MM: Generate mm.dat engine data file 2023-06-05 21:53:35 -07:00
doc NEWS: Mention MM1 support in German NEWS file 2023-06-07 18:42:58 +02:00
engines MTROPOLIS: Add hack to fix failed integrity check when disembarking the Hispaniola 2023-06-13 00:44:23 -04:00
graphics GRAPHICS: Add support for dithering from 3bpp into 1bpp 2023-06-10 23:27:57 +02:00
gui GUI: Don't parse all available engines and games on startup 2023-06-10 23:27:57 +02:00
icons
image IMAGE: Speed up 16/24/32bpp BMP decoding 2023-05-14 22:53:33 +02:00
LICENSES DISTS: Include MKV license in distribution packages 2023-03-05 21:47:13 +01:00
math MATH: added function to obtain size of AABBs 2023-05-17 10:11:20 +02:00
po I18N: Update translation files 2023-06-13 02:14:25 +00:00
test TEST: Add tests for Common::upperBound 2023-06-01 23:07:41 +02:00
video VIDEO: Fix signed/unsigned mismatch potentially breaking DXA seek. 2023-04-29 12:16:47 +02:00
.clang-format
.clang-tidy
.editorconfig
.gitattributes
.gitignore BACKENDS: Remove old iPhone backend 2023-05-31 19:31:19 +01:00
.gitlab-ci.yml LIBRETRO: add libretro platform 2023-03-04 16:35:51 +01:00
.gitmodules
AUTHORS CREDITS: Add dwa for macOS PPC 2023-02-27 19:38:23 +01:00
config.guess BUILD: Update config.guess and config.sub 2022-11-18 17:06:59 +01:00
config.sub BUILD: Update config.guess and config.sub 2022-11-18 17:06:59 +01:00
configure CONFIGURE: Rename iphone host_os to iphoneos 2023-05-31 19:33:48 +01:00
CONTRIBUTING.md
COPYING
COPYRIGHT ALL: Update copyright year 2023-01-01 00:00:51 +01:00
engines.awk
Makefile BUILD: Disable -Wshadow and -Wmissing-field-initializers before GCC 5 2023-03-07 20:41:16 +01:00
Makefile.common MM: Fix define in Makefile.common 2023-06-05 22:41:20 -07:00
NEWS.md NEWS: New Xeen engine option for HP/SP bars 2023-06-10 16:08:30 -07:00
plugin.exp
ports.mk DISTS: Add support for go-appimage 2023-06-01 20:39:17 +02:00
README.md
rules.mk
TODO
vcpkg.json CI: Update to use latest vcpkg version and integration 2023-04-29 13:16:08 +02:00

ScummVM README · CI Translation status PRs Welcome Codacy Badge

About ScummVM

ScummVM allows you to play classic graphic point-and-click adventure games, text adventure games, and RPGs, as long as you already have the game data files. ScummVM replaces the executable files shipped with the games, which means you can now play your favorite games on all your favorite devices.

So how did ScummVM get its name? Many of the famous LucasArts adventure games, such as Maniac Mansion and the Monkey Island series, were created using a utility called SCUMM (Script Creation Utility for Maniac Mansion). The VM in ScummVM stands for Virtual Machine.

While ScummVM was originally designed to run LucasArts SCUMM games, over time support has been added for many other games: see the full list on our wiki. Noteworthy titles include Broken Sword, Myst and Blade Runner, although there are countless other hidden gems to explore.

For more information, compatibility lists, details on donating, the latest release, progress reports and more, please visit the ScummVM home page.

Quickstart

For the impatient among you, here is how to get ScummVM running in five simple steps.

  1. Download ScummVM from our website and install it.

  2. Create a directory on your hard drive and copy the game datafiles from the original media to this directory. Repeat this for every game you want to play.

  3. Start ScummVM, choose 'Add game', select the directory containing the game datafiles (do not try to select the datafiles themselves!) and press Choose.

  4. The Game Options dialog opens to allow configuration of various settings for the game. These can be reconfigured at any time, but for now everything should be OK at the default settings.

  5. Select the game you want to play in the list, and press Start. To play a game next time, skip to step 5, unless you want to add more games.

Hint:

To add multiple games in one go, press and hold the shift key, then click 'Add game' -- the label will change to 'Mass Add' and if you press it, you are again asked to select a directory, only this time ScummVM will search through all subdirectories for supported games.

Reporting a bug

To report a bug, go to the ScummVM Issue Tracker and log in with your GitHub account.

Please make sure the bug is reproducible, and still occurs in the latest git/Daily build version. Also check the compatibility list for that game, to ensure the issue is not already known. Please do not report bugs for games that are not listed as completable on the Supported Games wiki page, or on the compatibility list. We already know those games have bugs!

Please include the following information in the bug report:

  • ScummVM version (test the latest git/Daily build)
  • Bug details, including instructions for how to reproduce the bug. If possible, include log files, screenshots, and any other relevant information.
  • Game language
  • Game version (for example, talkie or floppy)
  • Platform and Compiler (for example, Win32, Linux or FreeBSD)
  • An attached saved game, if possible.
  • If this bug only occurred recently, include the last version without the bug, and the first version with the bug. That way we can fix it quicker by looking at the changes made.

Finally, please report each issue separately; do not file multiple issues on the same ticket. It is difficult to track the status of each individual bug when they aren't on their own tickets.

Documentation

User documentation

For everything you need to know about how to use ScummVM, see our user documentation.

The ScummVM Wiki

The wiki is the place to go for information about every game supported by ScummVM. If you're a developer, there's also some very handy information in the Developer section.

Changelog

Our extensive change log is available here.

SAST Tools

PVS-Studio - static analyzer for C, C++, C#, and Java code.

Credits

A massive thank you to the entire team for making the ScummVM project possible. See the credits here!


Good Luck and Happy Adventuring! The ScummVM team. https://www.scummvm.org/