ScummVM DS: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 1: Line 1:
{{Infobox homebrew
{{Infobox homebrew
| title      = ScummVM DS
| title      = ScummVM for Nintendo DS
| image      = [[File:ScummVMDS.jpg]]
| image      = https://dlhb.gamebrew.org/dshomebrew/scummvmds.png
| type        = Emulator
| type        = Emulator
| version    = 1.2.1
| version    = 2.5.0
| licence    = Mixed
| licence    = Mixed
| author      = Neil Millstone (agentq)
| author      = ScummVM Team
| website    = http://www.scummvm.org/
| website    = http://www.scummvm.org
| download    = Media:Scummvm121ds.zip
| download    = [https://dlhb.gamebrew.org/dshomebrew/scummvmds.7z 1.2.1 and 2.5.0]
| source      = http://prdownloads.sourceforge.net/scummvm/scummvm-1.1.0.tar.bz2?download
| source      = https://www.scummvm.org/downloads/#source
}}
}}


ScummVM DS is a part of the ScummVM project. The ScummVM project is an attempt to re-engineer many classic point and click adventure games of the 80s and 90s to run on modern computer hardware.  
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.
 
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) and the VM in ScummVM stands for Virtual Machine.


ScummVM is written in such a way that it can be ported from one type of machine to another, and ScummVM DS is a port of ScummVM to the Nintendo DS handheld games console.  
ScummVM is written in such a way that it can be ported from one type of machine to another, and ScummVM DS is a port of ScummVM to the Nintendo DS handheld games console.  
Line 25: Line 27:


==Installation==
==Installation==
'''Note:''' In the package you will find a number of builds labeled from A to H. You will need to choose one and [[DLDI|DLDI]] patch it depending on which game you want to run. See the [https://www.gamebrew.org/wiki/ScummVM_DS#Game_compatibility_list compatibility table] below (or on the [https://wiki.scummvm.org/index.php?title=Nintendo_DS ScummVM DS website]) to find which games are supported by which build. A detailed guide for specific card readers is available in the readme file.
'''Note:''' ScummVM does not include any games. To play one of the supported games you will need to have your own copy of the game and add it to ScummVM.


Put [[DLDI|DLDI]] patched .nds or .ds.gba files on your flash card. If you're using the Supercard, you will need to use the .ds.gba files, but rename them to .nds.
Extract the archive and copy the extracted scummvm.nds file onto the SD card. The exact location is not important.


Put your game data in any folder on the card. One per folder, do not use a zip file (zip format is no longer supported).
Transfer game folders onto the SD card (see the list of [https://wiki.scummvm.org/index.php?title=Category:Supported_Games required data files for each game]).


Run the relevent ScummVM build for the game you want to play, click Add Game, select the folder where your game is stored.
For ease of use, you can create a dedicated games folder into which folder containing game files can be copied. The resulting directory structure will look somewhat like this:


ScummVM Games/
  |-Day of the Tentacle/
  |    |-MONSTER.SOU
  |    |-TENTACLE.000
  |    |-TENTACLE.001
  |-Flight of the Amazon Queen/
      |-QUEEN.1
      |-queen.tbl
==User Guide==
==User Guide==
Once ScummVM has loaded, you are presented with the main menu. To add a game, tap the Add button, browse your card's file structure until you have the folder containing the game you wish to add in view.
===Supported games===
 
While ScummVM was originally designed to run LucasArts' SCUMM games, over time support has been added for many other games.  
Select the folder via either the Stylus or the D-Pad, and tap Choose.
 
If, instead of being greeted with the game config dialog, you are presented with a "No games found" error or similar, you have may have:
* Used the incorrect ScummVM DS build.
* Attempted to add an incompatible game.
* Added an incomplete/corrupted game.


Assuming the game was added without problem, you are then presented with the game config dialog, in which you can setup various options. This can usually be dismissed immediately by clicking OK.
Please see the full list of [https://wiki.scummvm.org/index.php?title=Category:Supported_Games supported games]. [Compatibility list for the current version is availalbe https://www.scummvm.org/compatibility/2.5.0 here].


To run your game simply select it from the list shown on the main menu, and click Start.  
Note that games requiring a resolution of 512x512 or higher are not supported on the DS version.


===Game compatibility list===
===Where to get games===
To decrease the memory usage ScummVM for Nintendo DS has been split into several builds. Depending on the game you want to play you will have to select the correct build. Even so, some of the games cannot be run on a Nintendo DS because they require too much memory. You can find the list of supported games and which build you need to use for each one in the readme_ds.txt file present in the ScummVM Nintendo DS package. This information is also available on the [https://wiki.scummvm.org/index.php?title=Nintendo_DS ScummVM Nintendo DS] page.
Some games are available for free on ScummVM's [https://www.scummvm.org/games Game downloads page].  


{| class="wikitable sortable"
For other games see the [https://wiki.scummvm.org/index.php?title=Where_to_get_the_games Where to get the games page] from the official wiki.
!Game || Status || Supported by build || Notes
|-
| Maniac Mansion || Fully Working || A ||
|-
| Zak McKracken and the Alien Mindbenders || Fully Working. || A ||
|-
| Indiana Jones and the Last Crusade || Fully Working. || A ||
|-
| Loom || Fully Working. || A ||
|-
| Passport to Adventure || Fully Working. || A ||
|-
| The Secret of Monkey Island || Fully Working. || A ||
|-
| Monkey Island 2: LeChuck's Revenge || Fully Working. || A ||
|-
| Indiana Jones and the Fate of Atlantis || Fully Working. || A ||
|-
| Day of the Tentacle || Fully Working. || A || Minor slowdown in a few scenes when music is enabled.
|-
| Sam & Max Hit the Road || Fully Working. || A || Major slowdown in a few scenes when music is enabled.
|-
| Bear Stormin' || Fully working. || A || DOS version only.
|-
| Fatty Bear's Birthday Surprise || Fully working. || A || DOS version only.
|-
| Fatty Bear's Fun Pack || Fully working. || A || DOS version only.
|-
| Putt-Putt's Fun Pack || Fully working. || A || DOS version only.
|-
| Putt-Putt Goes to the Moon || Fully working. || A || DOS version only.
|-
| Putt-Putt Joins the Parade || Fully working. || A || DOS version only.
|-
| Beneath a Steel Sky || Fully Working. || B ||
|-
| Flight of the Amazon Queen || Fully Working. || B ||
|-
| Gobliiins || Fully Working. || D ||
|-
| Gobliins 2 || Fully Working. || D ||
|-
| Goblins 3 || Fully Working. || D ||
|-
| Simon the Sorcerer 1 || Fully Working. || C || Zoomed view does not follow the speaking character.
|-
| Simon the Sorcerer 2 || Fully Working. || C || Zoomed view does not follow the speaking character.
|-
| Elvira 1 || Fully working. || C || Zoomed view does not follow the speaking character.
|-
| Elvira 2 || Fully working. || C || Zoomed view does not follow the speaking character.
|-
| Waxworks || Fully working. || C || Zoomed view does not follow the speaking character. Amiga version only.
|-
| Inherit the Earth || Zoomed view does not follow the speaking character. || E ||
|-
| The Legend of Kyrandia || Zoomed view does not follow the speaking character. || F ||
|-
| Lure of the Temptress || Zoomed view does not follow the speaking character. || G ||
|-
| Nippon Safes || Zoomed view does not follow the speaking character. || H ||
|-
| Return to Zork || Fully Working. || I ||
|-
| Leather Goddess of Phobos 2 || Zoomed view does not follow the speaking character. || I ||
|-
| Cruise for a Corpse || Zoomed view does not follow the speaking character. || K ||
|-
| Full Throttle || Unsupported. || - || DS does not have enough RAM.
|-
| The Dig || Unsupported. || - || DS does not have enough RAM.
|-
| The Curse of Monkey Island || Unsupported. || - || DS does not have enough RAM.
|-
| I Have No Mouth and I Must Scream || Unsupported. || - || DS does not have enough RAM or screen resolution.
|-
|}


Full Throttle and The Dig can run on the DS using an external RAM pack plugged into slot-2 (the GBA slot).  To do this, download the special build of ScummVM DS from [http://forums.scummvm.org/viewtopic.php?t=7044 here].
===Audio===
 
Supported audio file formats:
There is no support for Windows Humongous Entertainment games, Broken Sword, and all other games that run at 640x480 resolution. The DS cannot cope with scaling these games down to 256x192, the resolution of the DS screens.
* MP3.
 
* Uncompressed audio - The games run gaster using uncompressed audio files.
Here is a [http://www.scummvm.org/compatibility/1.2.1/ complete list of the compatible games in version 1.2.1].
 
Flight of the Amazon Queen, Beneath a Steel Sky, and Lure of the Temptress have generously been released as freeware by the original authors, [http://www.revolution.co.uk/ Revolution Software]. You can download the game data from the [http://www.scummvm.org/downloads.php official ScummVM download page].


===FAQ===
===FAQ===
'''Q. I can't see the bottom line of inventory items in Day of the Tentacle, Monkey Island 2, or a few other games.'''
Please refer to the [https://docs.scummvm.org/en/latest/help/faq.html# FAQ section].


Hold down the left shoulder button and use D-pad (or the touch screen) to scroll the screen around.
==Known issues==
Games requiring a resolution of 512x512 or higher are not supported on the DS due to hardware limitations.


'''Q. I don't get speech or sound effects in Lucasarts games.'''
Some games are not playable due to the slow CPU speed and limited RAM on the DS. If there are any games that run really slowly, this is considered a hardware limitation, not a bug.


Do you have a monster.sog file?  If so, this is the wrong kind of speech file for ScummVM DS.  
==Changelog==
'''2.5.0 2021/10/09'''
* The Nintendo DS port got a major rewrite.


Copy the monster.sou file present on your original CD or floppies, and you will have speech.
'''1.2.1'''
 
'''Q. I don't see a menu when I press Start in Flight of the Amazon Queen or Simon the Sorcerer.'''
 
No. To save in Simon the Sorcerer, click use, then click on the postcard in your inventory.
 
In Flight of the Amazon Queen, click use, then click on the journal in your inventory.
 
'''Q. Why does ScummVM crash when I play Monkey Island 1?'''
 
This happens when MP3 audio tracks are present from the PC version of ScummVM.
 
Delete the MP3 tracks and reencode them to ADPCM WAV files as described in the CD audio section.
 
'''Q. Can't you use the extra RAM in the M3/Supercard or the official Opera Expansion Pack to support more games like The Dig and Full Throttle? DS Linux has done it, so why can't you?'''
 
Yes. The Dig and Full Throttle are playable with some limitations.
 
See the forum thread [http://forums.scummvm.org/viewtopic.php?t=7044 here] for a download.
 
'''Q. ScummVM DS turns off my DS when I hit Quit in the game or quit from the frontend. Why doesn't it return to the menu?'''
 
To return to the game launcher, hold Select during the game to access the main ScummVM menu, then click Return to Launcher.
 
==Controls==
'''Right-handed mode (default):'''
 
Left - Left mouse button
 
Right - Right mouse button
 
Up - Hover mouse (no mouse button)
 
Down - Skip dialogue line (some Lucasarts games), Show inventory (Beneath a Steel Sky), Show active objects (Simon the Sorceror)
 
Start - Pause/game menu (works in some games)
 
Select - DS Options
 
B - Skip cutscenes
 
A - Swap main screen and zoomed screen
 
Y - Show/Hide debug console
 
X - Show/Hide on-screen keyboard
 
L+D-pad or L+Pen - Scroll touch screen view
 
L+B - Zoom in
 
L+A - Zoom out
 
'''Left-handed mode:'''
 
Y - Left mouse button
 
A - Right mouse button
 
X - Hover mouse (no mouse button)
 
B - Skip dialogue line (some Lucasarts games), Show inventory (Beneath a Steel Sky), Show active objects (Simon the Sorceror)
 
Start - Pause/game menu (some games)
 
Select - DS Options
 
Down - Skip cutscenes
 
Up - Swap main screen and zoomed screen
 
Left - Show/Hide debug console
 
Right - Show/Hide on-screen keyboard
 
R+D-Pad or R+Pen - Scroll touch screen view
 
R+Down - Zoom in
 
R+Right - Zoom out
 
==Changelog==
'''ScummVM DS 1.2.1'''
* Bugfix release - no new features.
* Bugfix release - no new features.


'''ScummVM DS 1.2.0'''
'''1.2.0'''
* New game supported: Fascination.
* New game supported: Fascination.


'''ScummVM DS 1.1.1'''
'''1.1.1'''
* Bugfix release: no new features.
* Bugfix release: no new features.


'''ScummVM DS 1.1.0'''
'''1.1.0'''
* New games are supported in this stable build: Return to Zork, Rodney's Funscreen, Manhole, Leather Goddess of Phobos 2, Cruise for a Corpse.
* New games are supported in this stable build: Return to Zork, Rodney's Funscreen, Manhole, Leather Goddess of Phobos 2, Cruise for a Corpse.


'''ScummVM DS 1.0.0'''
'''1.0.0'''
* No changes.
* No changes.


'''ScummVM DS 1.0.0 RC1'''
'''1.0.0 RC1'''
* Gamma correction feature to improve brightness level of game on the original DS.
* Gamma correction feature to improve brightness level of game on the original DS.
* The usual round of bugfixes.
* The usual round of bugfixes.


'''ScummVM DS 0.13.1'''
'''0.13.1'''
* Support for the ScummVM Global Main Menu (hold select during the game).
* Support for the ScummVM Global Main Menu (hold select during the game).
* The usual round of bugfixes.
* The usual round of bugfixes.


'''ScummVM DS 0.12.0'''
'''0.12.0'''
* New games supported: Lure of the Temptress, Nippon Safes, Lost in Time.
* New games supported: Lure of the Temptress, Nippon Safes, Lost in Time.
* New laptop-style trackpad input method.  Uses relative movement when you drag on the touch screen.
* New laptop-style trackpad input method.  Uses relative movement when you drag on the touch screen.
Line 259: Line 105:
* The usual round of bug fixes.
* The usual round of bug fixes.


'''ScummVM DS 0.11.1'''
'''0.11.1'''
* Bugfix release - No new DS port features
* Bugfix release - No new DS port features.


'''ScummVM DS 0.11.0'''
'''0.11.0'''
* New games supported: Elvira 1 and 2, Waxworks (Amiga version).
* New games supported: Elvira 1 and 2, Waxworks (Amiga version).
* Software scaler for improved image quality. Turn it on using the DS options screen (press select during the game). Thanks to Tramboi and Robin Watts for this feature.
* Software scaler for improved image quality. Turn it on using the DS options screen (press select during the game). Thanks to Tramboi and Robin Watts for this feature.
Line 269: Line 115:


==Credits==
==Credits==
* ScummVM DS uses chishm's GBA Movie Player FAT driver.
A massive thank you to the entire team for making the ScummVM project possible.
* The CPU scaler is by Tramboi and Robin Watts.
 
* The ARM code was optimised by Robin Watts.
==External links==
* Thanks to highpass for the ScummVM DS icons.
* Official website - https://www.scummvm.org
* Thanks to zhevon for the Sam & Max cursor code.
* ScummVM Wiki - https://wiki.scummvm.org
* Thanks to theNinjaBunny for the M3 Adaptor guide on this site.
* Read the Docs - https://docs.scummvm.org/en/v2.5.0/index.html
* Thanks also to everyone on the GBADev Forums.
* GitHub - https://github.com/scummvm/scummvm
* This program was brought to you by caffiene, sugar and late nights.
* SourceForge - https://sourceforge.net/projects/scummvm
* GBAtemp - https://gbatemp.net/threads/scummvm-for-nintendo-ds-prerelease.593455


<br>
[[Category:DS homebrew emulators]]
[[Category:DS homebrew emulators]]
[[Category:Homebrew computer emulators on DS]]
[[Category:Homebrew computer emulators on DS]]

Revision as of 01:10, 12 October 2021

ScummVM for Nintendo DS
scummvmds.png
General
Author(s)ScummVM Team
TypeEmulator
Version2.5.0
LicenceMixed
Links
[1.2.1 and 2.5.0 Download]
Website
Source
Advertisements

<htmlet>adsense</htmlet>


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.

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) and the VM in ScummVM stands for Virtual Machine.

ScummVM is written in such a way that it can be ported from one type of machine to another, and ScummVM DS is a port of ScummVM to the Nintendo DS handheld games console.

Features

  • Runs nearly all of Lucasarts' SCUMM games up to and including Sam & Max Hit the Road.
  • Runs many non-Lucasarts point-and-click adventures too.
  • Supports sound.
  • Provides a GUI to change settings and choose games.
  • Supports using the DS touch screen for controls.
  • Suports saving games to compatible flash cards.
  • All games run at pretty much full speed.

Installation

Note: ScummVM does not include any games. To play one of the supported games you will need to have your own copy of the game and add it to ScummVM.

Extract the archive and copy the extracted scummvm.nds file onto the SD card. The exact location is not important.

Transfer game folders onto the SD card (see the list of required data files for each game).

For ease of use, you can create a dedicated games folder into which folder containing game files can be copied. The resulting directory structure will look somewhat like this:

ScummVM Games/
 |-Day of the Tentacle/
 |    |-MONSTER.SOU
 |    |-TENTACLE.000
 |    |-TENTACLE.001
 |-Flight of the Amazon Queen/
      |-QUEEN.1
      |-queen.tbl

User Guide

Supported games

While ScummVM was originally designed to run LucasArts' SCUMM games, over time support has been added for many other games.

Please see the full list of supported games. [Compatibility list for the current version is availalbe https://www.scummvm.org/compatibility/2.5.0 here].

Note that games requiring a resolution of 512x512 or higher are not supported on the DS version.

Where to get games

Some games are available for free on ScummVM's Game downloads page.

For other games see the Where to get the games page from the official wiki.

Audio

Supported audio file formats:

  • MP3.
  • Uncompressed audio - The games run gaster using uncompressed audio files.

FAQ

Please refer to the FAQ section.

Known issues

Games requiring a resolution of 512x512 or higher are not supported on the DS due to hardware limitations.

Some games are not playable due to the slow CPU speed and limited RAM on the DS. If there are any games that run really slowly, this is considered a hardware limitation, not a bug.

Changelog

2.5.0 2021/10/09

  • The Nintendo DS port got a major rewrite.

1.2.1

  • Bugfix release - no new features.

1.2.0

  • New game supported: Fascination.

1.1.1

  • Bugfix release: no new features.

1.1.0

  • New games are supported in this stable build: Return to Zork, Rodney's Funscreen, Manhole, Leather Goddess of Phobos 2, Cruise for a Corpse.

1.0.0

  • No changes.

1.0.0 RC1

  • Gamma correction feature to improve brightness level of game on the original DS.
  • The usual round of bugfixes.

0.13.1

  • Support for the ScummVM Global Main Menu (hold select during the game).
  • The usual round of bugfixes.

0.12.0

  • New games supported: Lure of the Temptress, Nippon Safes, Lost in Time.
  • New laptop-style trackpad input method. Uses relative movement when you drag on the touch screen.
  • New option which allows you to drag to hover, tap the touch screen to click, and double tap the screen to right click.
  • Reorganised DS Options screen into three tabs for clearer navigation.
  • New top screen scaling options let you choose the scaling factor used on startup.
  • The usual round of bug fixes.

0.11.1

  • Bugfix release - No new DS port features.

0.11.0

  • New games supported: Elvira 1 and 2, Waxworks (Amiga version).
  • Software scaler for improved image quality. Turn it on using the DS options screen (press select during the game). Thanks to Tramboi and Robin Watts for this feature.
  • Function keys added to virtual keyboard (used in AGI games).
  • Plenty of bug fixes.

Credits

A massive thank you to the entire team for making the ScummVM project possible.

External links

Advertising: