Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

ScummVM 3DS: Difference between revisions

From GameBrew
(Created page with "{{Infobox 3DS homebrew | title = ScummVM 3DS | image = https://dlhb.gamebrew.org/3dshomebrew/ScummVM-3DS.jpeg|250px | type = Other Emulators | version = 0.3 & 2.1 | licence =...")
 
No edit summary
 
(36 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = ScummVM 3DS
|title=ScummVM 3DS
| image = https://dlhb.gamebrew.org/3dshomebrew/ScummVM-3DS.jpeg|250px
|image=Scummvm3ds3.png
| type = Other Emulators
|description=SCUMM game engine virtual machine.
| version = 0.3 & 2.1
|author=ScummVM Team
| licence = Mixed
|lastupdated=2024/04/23
| author = Cruel
|type=Other Emulators
| website = https://github.com/Cruel/scummvm/tree/3ds
|version=2.8.1
| download = https://dlhb.gamebrew.org/3dshomebrew/ScummVM-3DS-3DS.rar
|license=GPL-3.0
| source = https://dlhb.gamebrew.org/3dshomebrew/ScummVM-3DS-3DS.rar
|download=[https://downloads.scummvm.org/frs/scummvm/2.8.1/scummvm-2.8.1-3ds-3dsx.zip 3DSX-build] - [https://downloads.scummvm.org/frs/scummvm/2.8.1/scummvm-2.8.1-3ds-cia.zip CIA-build]
|website=http://www.scummvm.org
|source=https://www.scummvm.org/downloads/#source
|donation=https://www.scummvm.org/
}}
}}
ScummVM is a program which allows you to run certain classic graphical point-and-click adventure games, provided you already have their data files. The clever part about this: ScummVM just replaces the executables shipped with the game, allowing you to play them on systems for which they were never designed.
Originally it was designed to run LucasArts' SCUMM games, such as Maniac Mansion, Monkey Island, Day of the Tentacle or Sam and Max. SCUMM stands for Script Creation Utility for Maniac Mansion, which was the first game for which LucasArts designed this system. And much later it gave its name to ScummVM (VM meaning Virtual Machine).
Over time support for a lot of non-SCUMM games has been added, and ScummVM now also supports many of Sierra's AGI and SCI games (such as King's Quest 1-6, Space Quest 1-5,...), Discworld 1 and 2, Simon the Sorcerer 1 and 2, Beneath A Steel Sky, Lure of the Temptress, Broken Sword I and II, Flight of the Amazon Queen, Gobliiins 1-3, The Legend of Kyrandia series, many of Humongous Entertainment's children's SCUMM games (including Freddi Fish and Putt Putt games) and many more.
==Installation==
Available in 3DX and CIA formats.
* 3DSX - Copy the extracted files to your SD card into the /3ds/scummvm/ directory. Launch ScummVM using the Homebrew Launcher.
* CIA - Use any CIA installation software to install the scummvm.cia file.
Note that CIA format requires a [[DSP1 3DS|DSP binary dump]] saved on your SD card as /3ds/dspfirm.cdc.
Transfer game folders onto the SD card, you can find a list of required data files for each game from the [https://wiki.scummvm.org/index.php?title=Category:Supported_Games wiki entry] for that game ([https://docs.scummvm.org/en/latest/use_scummvm/game_files.html read more]).
The exact location for the game data files is not important. 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/
  |-Day of the Tentacle/
  |    |-MONSTER.SOU
  |    |-TENTACLE.000
  |    |-TENTACLE.001
  |-Flight of the Amazon Queen/
  |    |-QUEEN.1
  |    |-queen.tbl
ScummVM for the Nintendo 3DS also has cloud functionality. See [https://docs.scummvm.org/en/v2.5.1/use_scummvm/connect_cloud.html Connecting a cloud service].
==User guide==
===Compatibility List===
You can find a full list with details on which adventures are supported and how well on the [https://www.scummvm.org/compatibility compatibility page]. ScummVM is continually improving, so check back often.
Please note that ScummVM is still under development and you may encounter crashes or occassional problems. That being said, some of the games have been supported for a long time and should work fine with any recent stable release.
===Hover mode===
When using the touchscreen, hover mode simulates the movement of the mouse.
You can click with taps, however you can’t drag or hold down a mouse button unless you use the buttons mapped to the right/left mouse buttons.
===Drag mode===
Simulates the click and release of the mouse buttons every time you touch and release the touchscreen.
At the moment, this is only a left mouse button click.
===Magnify mode===
Due to the low resolutions of the 3DS screens (400x240 for the top, and 320x240 for the bottom), games that run at a higher resolution will inevitably lose some visual detail from being scaled down. This can result in situations where essential information, such as text, is indiscernable.
Magnify mode increases the scale factor of the top screen back to 1, but the bottom screen remains unchanged. The touchscreen can then be used to change which part of the game display is being magnified. This can be done even in situations where the cursor is disabled, such as during full-motion video segments.
When activating magnify mode, touchscreen controls are automatically switched to Hover mode mode to reduce the risk of the user accidentally inputting a click when changing the magnified area with the stylus. Clicking can still be done as in normal hover mode. Turning off magnify mode will revert controls back to what was used previously. It will also restore the top screen’s previous scale factor.
Magnify mode can only be used when the following conditions are met:
* In the 3DS config menu, the Use Screen option is set to Both.
* The horizontal and/or vertical in-game resolution is greater than that of the top screen.
* You’re playing a game.
Magnify mode cannot be used in the Launcher menu.
===Paths===
Saved games are at sdmc:/3ds/scummvm/saves/.
Configuration file is located at sdmc:/3ds/scummvm/scummvm.ini.
===Settings===
For more information about Settings, see the Settings section of the documentation. Only platform-specific differences are listed here.
* Show mouse cursor - Toggles a visible mouse cursor on/off.
* Stretch to fit - Stretches the image to fit the screen
* Snap to edges - The 3DS touch screen has difficulty reaching the very end of the screen. With this option enabled, if you’re within a few pixels of the edge the cursor snaps to the edge.
* Use Screen - Sets whether ScummVM uses the Top, Bottom or Both screens.
* C-Pad Sensitivity - Sets the sensitivity of the Circle Pad.
===Audio===
Supported audio file formats are:
* MP3.
* OGG.
* OGG.
* Uncompressed audio.
==Controls==
Circle Pad - Moves the cursor
R+Circle Pad - Slow Mouse
A - Left mouse button
B - Right mouse button
X - Opens the virtual keyboard
Y - ESC (skip cutscenes and such)
Control Pad - Keypad cursor keys
L - Toggles magnify mode on/off
R  - Toggles between hover/drag modes
Start - Opens global main menu
Select - Opens 3DS config menu
==Media==
'''ScummVM-3DS - Broken Sword 1''' ([https://www.youtube.com/watch?v=1BemU7pw-KY Jack DeMar]) <br>
<youtube>1BemU7pw-KY</youtube>
<youtube>1BemU7pw-KY</youtube>


ScummVM 3DS README -------------------------------------- Table of Contents: ------------------ 1.0) Installation * 1.1 3DSX installation * 1.2 CIA installation 2.0) Controls * 2.1 Default key mappings * 2.2 Hover mode * 2.3 Drag mode 3.0) Supported Games 4.0) Compiling * 4.1 Prerequisites * * 4.1.1 Compiling third-party libraries * 4.2 Compiling ScummVM * 4.3 Warning for 3DSX build 1.0) Installation ----------------- There are two possible formats to be used: 3DSX and CIA (recommended). The 3DSX format is exclusively used by the Homebrew Launcher and its derivatives. The CIA format can be installed directly to the 3DS home menu and can be launched using any CFW (Custom Firmware) of your choice. Installing the Homebrew Launcher or any CFW is beyond the scope of this README. Look elsewhere to see how to install those if you do not already have them set up. 1.1) 3DSX installation ---------------- The CIA format is recommended for stability and maximum game support. If that is not an option, you will need one of a collection of 3DS titles installed on your system in order to properly launch ScummVM as a 3DSX. This is because the Homebrew Launcher hijacks other processes to run 3DSX homebrew, and ScummVM is a particularly large homebrew that can't be launched with the resources provided by standard system applications. You will need one of the following (installed or physically in cart slot): - Youtube - Monster Hunter 4 Ultimate Special Demo - Monster Hunter 4 Ultimate - Monster Hunter 4G - Super Smash Bros. for Nintendo 3DS Demo - Super Smash Bros. for Nintendo 3DS Special Demo - Super Smash Bros. for Nintendo 3DS Once you have one of the above, you need to merely extract all ScummVM 3DS files to the root of your SD card so that all files reside in the /3ds/scummvm/ directory. 1.2) CIA installation --------------------- The CIA format requires a DSP binary dump saved on your SD card as /3ds/dspfirm.cdc for proper audio support. You can search online to find software to dump this. Not having this file will cause many problems with games that need audio, sometimes even crashing, so this is NOT considered optional. Using any CIA installation software (search elsewhere for that), you need to install the scummvm.cia file. Then, just like what is done with the 3DSX installation, you need to extract all ScummVM 3DS files (scummvm.cia excluded) to the root of your SD card so that all files reside in the /3ds/scummvm/ directory. 2.0) Controls ------------- 2.1) Default key mappings ------------------------- The D-Pad and A/B/X/Y buttons have mirrored usage. So they do the same things depending on if you're right or left-handed. | Buttons | Function | |------------|--------------------------------| | A / D-left | Left-click | | X / D-up | Right-click | | B / D-down | ESC (skips cutscenes and such) | | L | Use virtual keyboard | | R | Toggle hover/drag modes | | Start | Open game menu | | Select | Open 3DS config menu | | Circle Pad | Move the cursor | 2.2) Hover mode --------------- When you use the touchscreen, you are simulating the mere moving of the mouse. You can click only with taps, meaning it is impossible to drag stuff or hold down a mouse button without using buttons mapped to right/left-click. 2.3) Drag mode -------------- Every time you touch and release the touchscreen, you are simulating the click and release of the mouse buttons. At the moment, this is only a left-click. 3.0) Supported Games -------------------- The full game engine compatibility list can be found here: http://scummvm.org/compatibility/ While all the above games should run on the 3DS (report if they do not), there are many games which are unplayable due to the lack of CPU speed on the 3DS. So if you play any games that run really slow, this is not considered a bug, but rather a hardware limitation. Though possible GPU optimizations are always in the works. The New 3DS console has much better performance, but there are still many newer and high-resolution games that cannot be played. A list of these unplayable games and game engines will eventually be listed here. 4.0) Compiling -------------- 4.1) Prerequisites ------------------ - devkitARM (presumably with libctru, picasso and such) - citro3d - Optional: You should compile third-party libraries for the 3ds (commonly referred to as portlibs in the devkitPRO community). Some games requires these to operate properly. 4.1.1) Compiling third-party libraries -------------------------------------- Most libraries used can be compiled with same commands and configuration flags. It is assumed that you have these environment variables defined: - DEVKITPRO Your root devkitPro directory - DEVKITARM Your root devkitARM directory (probably same as $DEVKITPRO/devkitARM) - CTRULIB Your root libctru directory (probably same as $DEVKITPRO/libctru) In the source directory of the library: - $ export PORTLIBS=$DEVKITPRO/portlibs/armv6k - $ export PATH=$DEVKITARM/bin:$PATH - $ export PKG_CONFIG_PATH=$PORTLIBS/lib/pkgconfig - $ export CFLAGS=&quot;-g -march=armv6k -mtune=mpcore -mfloat-abi=hard -O2 -mword-relocations -ffunction-sections -fdata-sections&quot; - $ export CPPFLAGS=&quot;-I$PORTLIBS/include -I$CTRULIB/include&quot; - $ export LDFLAGS=&quot;-L$PORTLIBS/lib&quot; - $ mkdir -p $PORTLIBS - $ ./configure --prefix=$PORTLIBS --host=arm-none-eabi --disable-shared --enable-static - $ make - $ make install Useful libraries (and special config flags needed): - zlib - libpng - libjpeg - freetype2 --without-bzip2 --without-harfbuzz - libmad - tremor - libogg - flac --disable-cpplibs --without-flac - faad 4.2) Compiling ScummVM ---------------------- - $ ./configure --host=3ds - $ make Additionally compile to specific formats to be used on the 3ds: - $ make scummvm.3dsx - $ make scummvm.cia 4.3) Warning for 3DSX build --------------------------- The above configuration command will include all game engines by default and will likely be too massive to run using the 3DSX format. Until dynamic modules are figured out, you should configure engines like this for 3DSX builds: - $ ./configure --host=3ds --disable-all-engines --enable-engine=scumm-7-8,myst,riven, sword1,sword2,sword25,sci,lure,sky,agi,agos Choose whatever engines you want, but if the ELF's .text section exceeds ~10MB, it won't be playable unless it's a CIA.
==Known issues==
Some games are not playable due to the slow CPU speed on the 3DS. If there are any games that run really slowly, this is considered a hardware limitation, not a bug.
 
==External Links==
* Official website - https://www.scummvm.org
* ScummVM Wiki - https://wiki.scummvm.org
* Read the Docs - https://docs.scummvm.org/en/v2.5.1/other_platforms/nintendo_3ds.html
* GitHub - https://github.com/scummvm/scummvm
* SourceForge - https://sourceforge.net/projects/scummvm
 
 
 
[[Category:Support the author]]

Latest revision as of 05:03, 6 October 2024

ScummVM 3DS
Scummvm3ds3.png
General
AuthorScummVM Team
TypeOther Emulators
Version2.8.1
LicenseGPL-3.0
Last Updated2024/04/23
Links
[3DSX-build - CIA-build Download]
Website
Source
Support Author

ScummVM is a program which allows you to run certain classic graphical point-and-click adventure games, provided you already have their data files. The clever part about this: ScummVM just replaces the executables shipped with the game, allowing you to play them on systems for which they were never designed.

Originally it was designed to run LucasArts' SCUMM games, such as Maniac Mansion, Monkey Island, Day of the Tentacle or Sam and Max. SCUMM stands for Script Creation Utility for Maniac Mansion, which was the first game for which LucasArts designed this system. And much later it gave its name to ScummVM (VM meaning Virtual Machine).

Over time support for a lot of non-SCUMM games has been added, and ScummVM now also supports many of Sierra's AGI and SCI games (such as King's Quest 1-6, Space Quest 1-5,...), Discworld 1 and 2, Simon the Sorcerer 1 and 2, Beneath A Steel Sky, Lure of the Temptress, Broken Sword I and II, Flight of the Amazon Queen, Gobliiins 1-3, The Legend of Kyrandia series, many of Humongous Entertainment's children's SCUMM games (including Freddi Fish and Putt Putt games) and many more.

Installation

Available in 3DX and CIA formats.

  • 3DSX - Copy the extracted files to your SD card into the /3ds/scummvm/ directory. Launch ScummVM using the Homebrew Launcher.
  • CIA - Use any CIA installation software to install the scummvm.cia file.

Note that CIA format requires a DSP binary dump saved on your SD card as /3ds/dspfirm.cdc.

Transfer game folders onto the SD card, you can find a list of required data files for each game from the wiki entry for that game (read more).

The exact location for the game data files is not important. 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/
 |-Day of the Tentacle/
 |    |-MONSTER.SOU
 |    |-TENTACLE.000
 |    |-TENTACLE.001
 |-Flight of the Amazon Queen/
 |    |-QUEEN.1
 |    |-queen.tbl

ScummVM for the Nintendo 3DS also has cloud functionality. See Connecting a cloud service.

User guide

Compatibility List

You can find a full list with details on which adventures are supported and how well on the compatibility page. ScummVM is continually improving, so check back often.

Please note that ScummVM is still under development and you may encounter crashes or occassional problems. That being said, some of the games have been supported for a long time and should work fine with any recent stable release.

Hover mode

When using the touchscreen, hover mode simulates the movement of the mouse.

You can click with taps, however you can’t drag or hold down a mouse button unless you use the buttons mapped to the right/left mouse buttons.

Drag mode

Simulates the click and release of the mouse buttons every time you touch and release the touchscreen.

At the moment, this is only a left mouse button click.

Magnify mode

Due to the low resolutions of the 3DS screens (400x240 for the top, and 320x240 for the bottom), games that run at a higher resolution will inevitably lose some visual detail from being scaled down. This can result in situations where essential information, such as text, is indiscernable.

Magnify mode increases the scale factor of the top screen back to 1, but the bottom screen remains unchanged. The touchscreen can then be used to change which part of the game display is being magnified. This can be done even in situations where the cursor is disabled, such as during full-motion video segments.

When activating magnify mode, touchscreen controls are automatically switched to Hover mode mode to reduce the risk of the user accidentally inputting a click when changing the magnified area with the stylus. Clicking can still be done as in normal hover mode. Turning off magnify mode will revert controls back to what was used previously. It will also restore the top screen’s previous scale factor.

Magnify mode can only be used when the following conditions are met:

  • In the 3DS config menu, the Use Screen option is set to Both.
  • The horizontal and/or vertical in-game resolution is greater than that of the top screen.
  • You’re playing a game.

Magnify mode cannot be used in the Launcher menu.

Paths

Saved games are at sdmc:/3ds/scummvm/saves/.

Configuration file is located at sdmc:/3ds/scummvm/scummvm.ini.

Settings

For more information about Settings, see the Settings section of the documentation. Only platform-specific differences are listed here.

  • Show mouse cursor - Toggles a visible mouse cursor on/off.
  • Stretch to fit - Stretches the image to fit the screen
  • Snap to edges - The 3DS touch screen has difficulty reaching the very end of the screen. With this option enabled, if you’re within a few pixels of the edge the cursor snaps to the edge.
  • Use Screen - Sets whether ScummVM uses the Top, Bottom or Both screens.
  • C-Pad Sensitivity - Sets the sensitivity of the Circle Pad.

Audio

Supported audio file formats are:

  • MP3.
  • OGG.
  • OGG.
  • Uncompressed audio.

Controls

Circle Pad - Moves the cursor

R+Circle Pad - Slow Mouse

A - Left mouse button

B - Right mouse button

X - Opens the virtual keyboard

Y - ESC (skip cutscenes and such)

Control Pad - Keypad cursor keys

L - Toggles magnify mode on/off

R - Toggles between hover/drag modes

Start - Opens global main menu

Select - Opens 3DS config menu

Media

ScummVM-3DS - Broken Sword 1 (Jack DeMar)

Known issues

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

External Links

Advertising: