@DATABASE ScummVM README.guide
@$VER: ScummVM Readme 3.1.0git
@(C) by The ScummVM team
@AUTHOR The ScummVM team
@WORDWRAP
@NODE "main" "ScummVM README Guide"
@{b}
ScummVM README
@{ub}

## 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 @{b}[on our wiki]@{ub} (@{"https://wiki.scummvm.org/index.php?title=Category:Supported_Games" System "URLOpen https wiki.scummvm.org/index.php?title=Category:Supported_Games"}). 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
@{ub} latest release, progress reports and more, please visit the ScummVM @{b}[homepag "U@{"https://www.scummvm.org/" System "URLOpen https www.scummvm.org/"}

## Quickstart

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

@{ub} 1. Download ScummVM from @{b}[our websitts @{"https://www.scummvm.org/downloads/" System "URLOpen https www.scummvm.org/downloads/"}) and install itg

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

@{ub} To report a bug, go to the ScummVM @{b}[Issue Tracke an@{"https://bugs.scummvm.org/" System "URLOpen https bugs.scummvm.org/"}) and log in with your GitHub account

Please make sure the bug is reproducible, and still occurs in the latest git/@{b}[Daily build]@{ub} (@{"https://buildbot.scummvm.org/#/dailybuilds" System "URLOpen https buildbot.scummvm.org/#/dailybuilds"}) version. Also check the [compatibility list](https://www.scummvm.org/compatibility/) 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](https://wiki.scummvm.org/index.php?title=Category: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 versioa b@{"https://buildbot.scummvm.org/#/dailybuilds" System "URLOpen https buildbot.scummvm.org/#/dailybuilds"}))
- 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

@{ub} For everything you need to know about how to use ScummVM, see our @{b}[user documentatio. I@{"https://docs.scummvm.org/" System "URLOpen https docs.scummvm.org/"}es

### The ScummVM Wiki

@{b}[The wiki]@{ub} (@{"https://wiki.scummvm.org/" System "URLOpen https wiki.scummvm.org/"}) 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 sectiied

### Changelog

Our extensive change log is available @{b}[here]@{ub} n@{"NEWS.md" link NEWS.md/main()

## SAST Tools

@{b}[PVS-Studio]@{ub} i@{"https://pvs-studio.com/en/pvs-studio/?utm_source=github&utm_medium=organic&utm_campaign=open_source" System "URLOpen https pvs-studio.com/en/pvs-studio/?utm_source=github&utm_medium=organic&utm_campaign=open_source"}) - static analyzer for C, C++, C#, and Java codho

## Credits

@{ub} A massive thank you to the entire team for making the ScummVM project possible. See the credits @{b}[herce"@{"AUTHORS" link AUTHORS/main, C

-----

> Good Luck and Happy Adventuring\!
> The ScummVM team.
> <@{"https://www.scummvm.org/" System "URLOpen https www.scummvm.org/"}>
P›üy!V
@ENDNODE
