Difference between revisions of "Nintendo 3DS emulators"

From Emulation General Wiki
Jump to navigation Jump to search
(Emulation issues)
m (Emulators)
(Tags: Mobile edit, Mobile web edit)
(24 intermediate revisions by 10 users not shown)
Line 10: Line 10:
 
|emulated = {{✓}}
 
|emulated = {{✓}}
 
}}
 
}}
 +
 +
{{for|other emulators that run on 3DS hardware|Emulators on 3DS}}
  
 
The '''[[wikipedia:Nintendo 3DS|Nintendo 3DS]]''' is an eighth-generation handheld game console by Nintendo, released on March 27, 2011 for {{inflation|USD|249|2011}}. The original model and the 2DS had a dual-core ARM11 MPCore at 268 MHz and a single-core ARM9, 128MB of RAM and 6MB of VRAM, and a DMP PICA200 GPU. The New 3DS and New 2DS XL models upgrade this to an 804 MHz quad-core ARM11 and 256MB of RAM, along with an extra pair of shoulder buttons and a right analogue stick.
 
The '''[[wikipedia:Nintendo 3DS|Nintendo 3DS]]''' is an eighth-generation handheld game console by Nintendo, released on March 27, 2011 for {{inflation|USD|249|2011}}. The original model and the 2DS had a dual-core ARM11 MPCore at 268 MHz and a single-core ARM9, 128MB of RAM and 6MB of VRAM, and a DMP PICA200 GPU. The New 3DS and New 2DS XL models upgrade this to an 804 MHz quad-core ARM11 and 256MB of RAM, along with an extra pair of shoulder buttons and a right analogue stick.
Line 18: Line 20:
  
 
==Emulators==
 
==Emulators==
 +
<div style="max-width:100%; overflow:auto;">
 
{| class="wikitable" style="text-align:center;"
 
{| class="wikitable" style="text-align:center;"
 
! scope="col"|Name
 
! scope="col"|Name
Line 23: Line 26:
 
! scope="col"|Latest Version
 
! scope="col"|Latest Version
 
! scope="col"|<abbr title="Free/Libre and Open-Source Software">FLOSS</abbr>
 
! scope="col"|<abbr title="Free/Libre and Open-Source Software">FLOSS</abbr>
! scope="col"|[[libretro|Libretro Core]]
+
! scope="col"|[[libretro]]
 
! scope="col"|Active
 
! scope="col"|Active
 
! scope="col"|[[Recommended Emulators|Recommended]]
 
! scope="col"|[[Recommended Emulators|Recommended]]
Line 31: Line 34:
 
|[[Citra]]
 
|[[Citra]]
 
|align=left|{{Icon|Windows|Linux|macOS}}
 
|align=left|{{Icon|Windows|Linux|macOS}}
|[https://citra-emu.org/download Nightly]
+
|[https://citra-emu.org/download/#downloads-canary Canary]<br/>[https://citra-emu.org/download/#downloads-nightly Nightly]
 
|{{✓}}
 
|{{✓}}
 
|{{✓}}
 
|{{✓}}
 
|{{✓}}
 
|{{✓}}
 
|{{✓}}
 
|{{✓}}
 +
|-
 +
|[[Mikage]]
 +
|align=left|{{Icon|Windows|Linux}}
 +
|{{na}} <small>(WIP)</small>
 +
|{{✗}}
 +
|{{✗}}
 +
|{{✓}}
 +
|{{✗}}
 
|-
 
|-
 
|Corgi3DS
 
|Corgi3DS
Line 45: Line 56:
 
|{{✗}}
 
|{{✗}}
 
|-
 
|-
|[[3dmoo]]
+
|[[TronDS]]
 
|align=left|{{Icon|Windows|Linux}}
 
|align=left|{{Icon|Windows|Linux}}
|[https://github.com/plutooo/3dmoo git]
+
|[http://trondsemu.byethost15.com/downloads.html 1.0.0.5]
|{{}}
+
|{{}}
 
|{{✗}}
 
|{{✗}}
 
|{{✗}}
 
|{{✗}}
 
|{{✗}}
 
|{{✗}}
 
|-
 
|-
|[[TronDS]]
+
|[[3dmoo]]
 
|align=left|{{Icon|Windows|Linux}}
 
|align=left|{{Icon|Windows|Linux}}
|[http://trondsemu.byethost15.com/downloads.html 1.0.0.5]
+
|[https://github.com/plutooo/3dmoo git]
|{{}}
+
|{{}}
 
|{{✗}}
 
|{{✗}}
 
|{{✗}}
 
|{{✗}}
Line 63: Line 74:
 
|LemonLime
 
|LemonLime
 
|align=left|{{Icon|Windows|Linux|macOS}}
 
|align=left|{{Icon|Windows|Linux|macOS}}
|[https://github.com/Cyuubi/LemonLime/ git]
+
|[https://github.com/ItsKaitlyn03/LemonLime/ git]
 
|{{✓}}
 
|{{✓}}
 
|{{✗}}
 
|{{✗}}
Line 72: Line 83:
 
|-
 
|-
 
|-
 
|-
|[[Citra]]<br/><small>(Citra MMJ)</small>
+
|[[Citra MMJ]]
 
|align=left|{{Icon|Android}}
 
|align=left|{{Icon|Android}}
 
|[https://github.com/weihuoya/citra/releases git]
 
|[https://github.com/weihuoya/citra/releases git]
|{{}}
+
|{{~}}
 
|{{✗}}
 
|{{✗}}
 
|{{✓}}
 
|{{✓}}
Line 82: Line 93:
 
|[[Citra]]
 
|[[Citra]]
 
|align=left|{{Icon|Android}}
 
|align=left|{{Icon|Android}}
|[https://play.google.com/store/apps/details?id=org.citra.citra_emu Beta 15]<br/>[https://github.com/citra-emu/citra-android git]
+
|[https://play.google.com/store/apps/details?id=org.citra.citra_emu Beta 15]<br/>[https://github.com/citra-emu/citra-nightly/releases Nightly]<br/>[https://github.com/citra-emu/citra-canary/releases Canary]
 
|{{✓}}
 
|{{✓}}
 
|{{✗}}
 
|{{✗}}
 +
|{{✓}}
 
|{{✗}}
 
|{{✗}}
|{{~}}
 
 
|-
 
|-
 
| Citra-Enhanced
 
| Citra-Enhanced
Line 93: Line 104:
 
| {{✓}}
 
| {{✓}}
 
| {{✗}}  
 
| {{✗}}  
| {{✓}}
+
| {{✗}}
| {{~}}
+
| {{✗}}
 +
|-
 +
|[[Mikage]]
 +
|align=left|{{Icon|Android}}
 +
|{{na}} <small>(WIP)</small>
 +
|{{✗}}
 +
|{{✗}}
 +
|{{✓}}
 +
|{{}} <small>(WIP)</small>
 
|}
 
|}
 +
</div>
  
 
===Comparisons===
 
===Comparisons===
Line 101: Line 121:
 
:An open-source Nintendo 3DS emulator made by experienced emulator developers. The devs insist that it's still experimental, but as of mid-2019 around half of all games are fully playable with minor or no issues.  [https://citra-emu.org/entry/announcing-citra-android/ An official Android version was released in May of 2020].
 
:An open-source Nintendo 3DS emulator made by experienced emulator developers. The devs insist that it's still experimental, but as of mid-2019 around half of all games are fully playable with minor or no issues.  [https://citra-emu.org/entry/announcing-citra-android/ An official Android version was released in May of 2020].
  
;[[3dmoo]]:Another open-source Nintendo 3DS emulator, made by experienced developers in the DS hacking scene. It was released shortly after Citra and received similar progress for a few months, but was eventually aborted by its authors after a while.
+
;Corgi3DS:An unique 3DS emulator designed for macOS systems. Its GitHub activity started on [https://github.com/PSI-Rockin/Corgi3DS/commit/1b81c7e00c9a7a73f2da12d07ec3a9e4bc69c6ac May 5, 2019]. Main programmer is a self-proclaimed dog lover and has previously created CorgiDS and DobieStation, though the former seemed to be abandoned. Corgi3DS is mainly indigenous but the preliminary [https://github.com/PSI-Rockin/Corgi3DS/commit/a60b06683495e4e8fd0c170ec4ca8c453ce31609 Wi-Fi code] was ported from [[melonDS]]'s code. (The Project is on a indefinite hiatus, PSI said this about the matter "Haven't worked on it in several months, it's basically a hobby project of mine that I touch when I feel the urge").
 +
 
 +
;[[Mikage]]:An emulator developed by Tony Wasserka, a.k.a. ''neobrain'', with focus on optimization and stability in Android, willing to fill the gap left by Citra. It is closed-source and also has a PC port.
 +
 
 
;[[TronDS]]:A closed-source Nintendo 3DS emulator, presumably made by the iDeaS author. Little is known about it other than that it can run simple homebrew. It cannot be used for playing games.
 
;[[TronDS]]:A closed-source Nintendo 3DS emulator, presumably made by the iDeaS author. Little is known about it other than that it can run simple homebrew. It cannot be used for playing games.
  
;Corgi3DS:An unique 3DS emulator designed for macOS systems. Its GitHub activity started on [https://github.com/PSI-Rockin/Corgi3DS/commit/1b81c7e00c9a7a73f2da12d07ec3a9e4bc69c6ac May 5, 2019]. Main programmer is a self-proclaimed dog lover and has previously created CorgiDS and DobieStation, though the former seemed to be abandoned. Corgi3DS is mainly indigenous but the preliminary [https://github.com/PSI-Rockin/Corgi3DS/commit/a60b06683495e4e8fd0c170ec4ca8c453ce31609 Wi-Fi code] was ported from [[melonDS]]' code. (The Project is on a indefinite hiatus, PSI said this about the matter "Haven't worked on it in several months, it's basically a hobby project of mine that I touch when I feel the urge").
+
;[[3dmoo]]:Another open-source Nintendo 3DS emulator, made by experienced developers in the DS hacking scene. It was released shortly after Citra and received similar progress for a few months, but was eventually aborted by its authors after a while.
  
 
==Emulation issues==
 
==Emulation issues==
 
Citra currently can't emulate any of the 3DS's online features aside from LAN multiplayer. It can't connect to Nintendo's servers but users can create rooms and play through the internet.
 
Citra currently can't emulate any of the 3DS's online features aside from LAN multiplayer. It can't connect to Nintendo's servers but users can create rooms and play through the internet.
  
Corgi3ds currently can't run any game without heavy stuttering.
+
Corgi3DS can't run any games without heavy stuttering.
  
Citra emulates the home menu although you can't launch anything on it.
+
Citra emulates the home menu although you can't launch anything on it, also Citra can't launch the system apps or other games while in game (as the same with the home menu) and resulting on the softlock of the emulator, effectively making Citra unplayable.
Also Citra can't launch the system apps or other games while in game (as the same with the home menu) and resulting on the softlock of the emulator, effectively making citra unplayable.
 
  
 
==Game images==
 
==Game images==
Line 136: Line 158:
 
The game changer was the sighax exploit, allowing to dump the 3DS bootrom which includes these encryption keys. This file can be downloaded from the [[Emulator Files#Nintendo 3DS|Emulator Files]] page. You can then use a program like '''[https://gbatemp.net/threads/tutorial-extract-decrypt-games-nand-backups-and-sd-contents-with-fuse-3ds.499994/ fuse-3ds]''' to decrypt games using this file. Simply place boot9.bin in the same folder, run the program, mount the encrypted .cia or .3ds, and find the '''decrypted.cxi''' file inside (usually in the first folder). Citra should be able to load this file without issues.
 
The game changer was the sighax exploit, allowing to dump the 3DS bootrom which includes these encryption keys. This file can be downloaded from the [[Emulator Files#Nintendo 3DS|Emulator Files]] page. You can then use a program like '''[https://gbatemp.net/threads/tutorial-extract-decrypt-games-nand-backups-and-sd-contents-with-fuse-3ds.499994/ fuse-3ds]''' to decrypt games using this file. Simply place boot9.bin in the same folder, run the program, mount the encrypted .cia or .3ds, and find the '''decrypted.cxi''' file inside (usually in the first folder). Citra should be able to load this file without issues.
  
Due to these keys being available, Citra can now play encrypted games (3ds or CIA) without decrypting them. Read this page
+
Due to these keys being available, Citra can now play encrypted games (3ds or CIA) without decrypting them. Read [https://citra-emu.org/wiki/aes-keys this page]. Then, go to this reddit page and copy the code from [https://www.reddit.com/r/CemuPiracy/comments/gpo2ey/aes_key_nintendo_3ds_title_keys_for_citra second comment] (credit floppydoppy2). Copy it and make a new .TXT file named '''aes_keys.txt'''. Place this txt file in the sysdata folder of Citra's user directory. This key file is already included in the 3DS Shared Data download in the [[Emulator files#Nintendo_3DS|Emulator Files]] page.  
[https://citra-emu.org/wiki/aes-keys/]. Then, go to this reddit page and copy the code from second comment (credit floppydoppy2)
 
[https://www.reddit.com/r/CemuPiracy/comments/gpo2ey/aes_key_nintendo_3ds_title_keys_for_citra/]. Copy it and make a new .TXT file named 'aes_keys.txt'
 
Place this txt file in the sysdata folder of Citra's user directory. This key file is already included in the 3DS Shared Data download in the Emulator Files page.  
 
 
 
  
 
{{Nintendo}}
 
{{Nintendo}}

Revision as of 12:38, 31 October 2022

Nintendo 3DS
3ds.png
Developer Nintendo
Type Handheld game console
Generation Eighth generation
Release date 2011
Discontinued 2020
Predecessor Nintendo DSi
Emulated
For other emulators that run on 3DS hardware, see Emulators on 3DS.

The Nintendo 3DS is an eighth-generation handheld game console by Nintendo, released on March 27, 2011 for $249. The original model and the 2DS had a dual-core ARM11 MPCore at 268 MHz and a single-core ARM9, 128MB of RAM and 6MB of VRAM, and a DMP PICA200 GPU. The New 3DS and New 2DS XL models upgrade this to an 804 MHz quad-core ARM11 and 256MB of RAM, along with an extra pair of shoulder buttons and a right analogue stick.

The most notable feature of this console is the use of autostereoscopic (glasses-free) 3D, which can be configured using a slider. This was omitted on the cost-reduced 2DS and New 2DS XL models, which was released due to eye health concerns with children whom Nintendo advised not to use the 3DS's stereoscopic mode (though it is speculated that said advisories were more for liability reasons in case of a health-related lawsuit).

Emulators

Name Platform(s) Latest Version FLOSS libretro Active Recommended
PC / x86
Citra Windows Linux macOS Canary
Nightly
Mikage Windows Linux N/A (WIP)
Corgi3DS Windows Linux macOS git
TronDS Windows Linux 1.0.0.5
3dmoo Windows Linux git
LemonLime Windows Linux macOS git
Mobile / ARM
Citra MMJ Android git ~ ~
Citra Android Beta 15
Nightly
Canary
Citra-Enhanced Android git
Mikage Android N/A (WIP) (WIP)

Comparisons

Citra (compatibility)
An open-source Nintendo 3DS emulator made by experienced emulator developers. The devs insist that it's still experimental, but as of mid-2019 around half of all games are fully playable with minor or no issues. An official Android version was released in May of 2020.
Corgi3DS
An unique 3DS emulator designed for macOS systems. Its GitHub activity started on May 5, 2019. Main programmer is a self-proclaimed dog lover and has previously created CorgiDS and DobieStation, though the former seemed to be abandoned. Corgi3DS is mainly indigenous but the preliminary Wi-Fi code was ported from melonDS's code. (The Project is on a indefinite hiatus, PSI said this about the matter "Haven't worked on it in several months, it's basically a hobby project of mine that I touch when I feel the urge").
Mikage
An emulator developed by Tony Wasserka, a.k.a. neobrain, with focus on optimization and stability in Android, willing to fill the gap left by Citra. It is closed-source and also has a PC port.
TronDS
A closed-source Nintendo 3DS emulator, presumably made by the iDeaS author. Little is known about it other than that it can run simple homebrew. It cannot be used for playing games.
3dmoo
Another open-source Nintendo 3DS emulator, made by experienced developers in the DS hacking scene. It was released shortly after Citra and received similar progress for a few months, but was eventually aborted by its authors after a while.

Emulation issues

Citra currently can't emulate any of the 3DS's online features aside from LAN multiplayer. It can't connect to Nintendo's servers but users can create rooms and play through the internet.

Corgi3DS can't run any games without heavy stuttering.

Citra emulates the home menu although you can't launch anything on it, also Citra can't launch the system apps or other games while in game (as the same with the home menu) and resulting on the softlock of the emulator, effectively making Citra unplayable.

Game images

3DS vs. CIA

There are two big types of 3DS game images currently:

NCSD-type
Includes .CCI (CTR Cart Image), aka .3DS - data on physical carts, can be executed right off the bat, not used much since no one bothered to develop a CFW solution to load them yet (besides converting them to CIA) and only overpriced flashcarts (Gateway/Sky3DS) can load them.
NCCH-type
Includes .CIA (CTR Importable Archive) and .CXI - installers that unpack game data to the SD card or the 3DS NAND memory. Some homebrew apps (FBI, DevMenu) can install CIA files on 3DS systems with CFW installed. Digital games are often distributed as CIAs.
  • Note that CTR (Citrus) is the internal code names for the 3DS.

Due to one format being so far restricted to overpriced flashcarts and the very slow Citra development (meaning playing on a real 3DS is still the preferred way to go), the CIA format is preferred in many sharing websites, downloader tools and even tools to dump your own games.

However, converting a CIA image to 3DS format (and vice-versa) is still possible with no loss of content. Read the Encryption section below for a guide.

Some outdated dumping utilities intended for use with Citra (like braindump) produce damaged decrypted 3DS images that can't be easily converted back. No known solution exists so far to fix those dumps.

Encryption

Most dumps online are also encrypted. This encryption poses no problem for playing game images on a real 3DS since it can deal with that encryption with internal keys included in the bootrom, but becomes a problem when trying to emulate them on PC. Citra requires additional encryption keys to play encrypted games. If you want to play encrypted games on Citra without these keys, you'll have to convert your game images to the decrypted format.

Formerly, decrypting those ROMs used to require real 3DS hardware (bafflingly enough, Citra devs still ask users to do this even nowadays). It required files generated by a real 3DS called xorpads unique to that game version, using the encryption engine within the 3DS. After this part, these xorpads (which are big) can be used with PC tools (or other 3DS-based homebrew) to produce the decrypted game image. After that, some 3DS homebrew (Decrypt9, GodMode9) included tools to directly convert encrypted images to decrypted images with a single button press, but those still require a real 3DS.

The game changer was the sighax exploit, allowing to dump the 3DS bootrom which includes these encryption keys. This file can be downloaded from the Emulator Files page. You can then use a program like fuse-3ds to decrypt games using this file. Simply place boot9.bin in the same folder, run the program, mount the encrypted .cia or .3ds, and find the decrypted.cxi file inside (usually in the first folder). Citra should be able to load this file without issues.

Due to these keys being available, Citra can now play encrypted games (3ds or CIA) without decrypting them. Read this page. Then, go to this reddit page and copy the code from second comment (credit floppydoppy2). Copy it and make a new .TXT file named aes_keys.txt. Place this txt file in the sysdata folder of Citra's user directory. This key file is already included in the 3DS Shared Data download in the Emulator Files page.