ScummVM main repository
Go to file
Eugene Sandulenko 988dbf3fa0
DIRECTOR: DEBUGGER: Restrict max number of columns to 511
This is currntly a hard limit of ImGui
2024-05-23 00:50:43 +02:00
.github CI: Bump action versions 2024-05-20 10:16:05 +01:00
audio JANITORIAL: Fix substract typo in dbopl.cpp 2024-05-18 13:52:31 +02:00
backends MACOS: Added missing License files to macOS menu 2024-05-22 21:59:00 +02:00
base BASE: Enable aspect ratio correction by default 2024-05-04 00:12:20 +02:00
common COMMON: Fix Path::baseName 2024-05-19 21:18:34 +02:00
devtools DEVTOOLS: Sort engines alphabetically in prerelease checks 2024-05-22 22:46:03 +02:00
dists DISTS: REDHAT: Added missing License files 2024-05-22 21:59:00 +02:00
doc JANITORIAL: Fix tatoo typo in NEUES.md 2024-05-18 13:52:31 +02:00
engines DIRECTOR: DEBUGGER: Restrict max number of columns to 511 2024-05-23 00:50:43 +02:00
graphics JANITORIAL: Fix referece typo in zblit_public.h 2024-05-18 13:52:31 +02:00
gui FONTS: Replaced Material Icons with a bigger font 2024-05-21 22:38:44 +02:00
icons ICONS: Update macOS icon set 2024-03-05 13:46:35 +01:00
image JANITORIAL: Fix auxillary typo in png.cpp 2024-05-18 13:52:31 +02:00
LICENSES LICENSES: Make sure every license file has an appropriate Note 2024-05-22 21:59:00 +02:00
math MATH: added const qualifier to AABB collision function 2024-05-06 22:57:08 +02:00
po I18N: Update translation files 2024-05-22 22:45:01 +00:00
test COMMON: Fix Path::baseName 2024-05-19 21:18:34 +02:00
video JANITORIAL: Add apostrophe to seek'ed to distinguish between command and typo in video_decoder.cpp 2024-05-18 13:52:31 +02:00
.clang-format
.clang-tidy
.editorconfig
.gitattributes
.gitignore GIT: Fix casing in .gitignore comments 2024-05-20 00:01:58 +03:00
.gitlab-ci.yml
.gitmodules
.readthedocs.yaml DOCS: Update Sphinx to latest version 2024-02-03 15:28:57 +01:00
AUTHORS CREDITS: Added Linus as Finnish translator 2024-04-24 13:30:29 +02:00
config.guess
config.sub
configure CONFIGURE: ImGui now requires freetype2 2024-05-21 21:02:48 +02:00
CONTRIBUTING.md
COPYING
COPYRIGHT ALL: Set copyright year to 2024 2024-01-01 00:04:27 +01:00
engines.awk
Makefile AUDIO: Add a basic soundfont for fluidsynth 2023-12-03 16:17:32 +00:00
Makefile.common BUILD: Added missing License files to makefiles 2024-05-22 21:59:00 +02:00
NEWS.md NEWS: Mention Ultima VIII updates 2024-05-19 09:38:00 -05:00
plugin.exp
ports.mk BUILD: Added missing License files to makefiles 2024-05-22 21:59:00 +02:00
README.md
rules.mk
TODO
vcpkg.json AUDIO: Add libopenmpt support 2024-02-21 18:45:25 +01: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/