|
|
| Line 11: |
Line 11: |
| }} | | }} |
| <youtube>1BemU7pw-KY</youtube> | | <youtube>1BemU7pw-KY</youtube> |
| | ====Offical Build ==== |
| | http://www.scummvm.org/ |
|
| |
|
| 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="-g -march=armv6k -mtune=mpcore -mfloat-abi=hard -O2 -mword-relocations -ffunction-sections -fdata-sections" - $ export CPPFLAGS="-I$PORTLIBS/include -I$CTRULIB/include" - $ export LDFLAGS="-L$PORTLIBS/lib" - $ 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. | | =ScummVM 3DS= |
| | |
| | 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. 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. |
| | |
| | Among the systems on which you can play those games are regular desktop |
| | computers (running Windows, Linux, Mac OS X, ...), game consoles |
| | (Dreamcast, Nintendo DS & Wii, PS2, PSP, ...), smartphones (Android, |
| | iPhone, PocketPC, Symbian ...) and more. |
| | |
| | At this time ScummVM is still under heavy development. Be aware that |
| | whilst we attempt to make sure that many games can be completed with few |
| | major bugs, crashes can happen and we offer no warranty. That being said, |
| | some of the games have been supported for a long time and should work |
| | fine with any recent stable release. You can get a feeling of how well |
| | each game is working in ScummVM by looking at the compatibility page. |
| | Actually if you browse a bit around you might discover that ScummVM is |
| | even being used commercially to re-release some of the supported games on |
| | modern platforms. This shows that several companies are happy with the |
| | quality of the software and how well it can run some of the games. |
| | |
| | If you enjoy ScummVM feel free to donate using the PayPal button on the |
| | ScummVM homepage. This will help us buy utilities needed to develop |
| | ScummVM easier and quicker. If you cannot donate, help and contribute a |
| | patch! |
ScummVM 3DS
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. 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.
Among the systems on which you can play those games are regular desktop
computers (running Windows, Linux, Mac OS X, ...), game consoles
(Dreamcast, Nintendo DS & Wii, PS2, PSP, ...), smartphones (Android,
iPhone, PocketPC, Symbian ...) and more.
At this time ScummVM is still under heavy development. Be aware that
whilst we attempt to make sure that many games can be completed with few
major bugs, crashes can happen and we offer no warranty. That being said,
some of the games have been supported for a long time and should work
fine with any recent stable release. You can get a feeling of how well
each game is working in ScummVM by looking at the compatibility page.
Actually if you browse a bit around you might discover that ScummVM is
even being used commercially to re-release some of the supported games on
modern platforms. This shows that several companies are happy with the
quality of the software and how well it can run some of the games.
If you enjoy ScummVM feel free to donate using the PayPal button on the
ScummVM homepage. This will help us buy utilities needed to develop
ScummVM easier and quicker. If you cannot donate, help and contribute a
patch!
