Splitting up instructions for dumping installed games and titles and adding new instructions for digital games

tekas 2016-10-22 10:42:30 -05:00
parent 40e23bc1ab
commit fe6308b3d1

@ -0,0 +1,61 @@
##How to Dump Titles Installed to a 3DS System
There are two methods to dump installed titles to run in Citra. Detailed instructions are below for using either method, but in quick summary, the first method involves using [Decrypt9WIP](https://github.com/d0k3/Decrypt9WIP) on a 3DS with a system version below 9.2 or with [arm9loaderhax](https://github.com/Plailect/Guide/wiki) installed. This is the recommended method, but there is another way to dump games and applications using [braindump](https://gbatemp.net/threads/braindump-userland-game-dumping.407332/). Braindump is easy to set up, user-friendly, and compatible with newer system versions, but is also lossy and less reliable so it doesn't always work.
#### Note on DLC and updates
At this time, Citra does not emulate the 3DS's functions for checking for updates and DLC. While dumping this information can be done by following these instructions, Citra can't actually use it yet. See [this discussion topic](https://discuss.citra-emu.org/d/527-smash-bros-update) for more details.
---
### Method 1: Decrypt9WIP
By far the most reliable method of dumping games and system applications, but also by far the most complicated to up. It is recommended that you use the newest version of Decrypt9 because it greatly adds to the ease of the process, but instructions are detailed below if using an older version of the tool.
#### Required tools
- [Decrypt9WIP](https://github.com/d0k3/Decrypt9WIP)
- 3DS system with 9.2.0-20 or lower, or arm9loaderhax
- SD card with enough space to hold the dump; 8GB or higher recommended
- SD card reader (preferred), or a way to use wireless file transfer
#### Instructions
1. Set up Decrypt9WIP using one of the various entry points. [Read its readme](https://github.com/d0k3/Decrypt9WIP#how-to-run-this--entry-points) on how to do this.
2. Create a folder at the root of the 3DS SD card called `files9`.
3. Create a folder inside `files9` called `D9Game`.
4. Put the SD card into the 3DS.
5. Look up the title ID (TID), the 16-character ID, of the game to be dumped. [Here](http://www.3dsdb.com/) is a link to a database of games names, locales, and their corresponding TIDs, but if that link is not working, search online for "3DS Title Keys".
6. Split the TID into two equal parts. The left side is called the TID high and the right side is called the TID low. For example, the USA Health & Safety app's TID is `0004001000021300`, so its TID high is `00040010` and its TID low is `00021300`.
#### If using a version of Decrypt9 released on or after 10/21/2016...
7. From the root Decrypt9 menu, choose `Content Decryptor Options`, then `SD File Options...`->`SD CXI Dumper (SysNAND dir)`. If the game is installed to EmuNAND, choose `SD CXI Dumper (EmuNAND dir)` instead of `SD CXI Dumper (SysNAND dir)`. If unsure, the SysNAND option is probably the correct choice.
8. Using the arrow keys, navigate folders until `/title/<TID high>/<TID low>` is selected, replacing `<TID high>` with the TID high of the game being dumped and `<TID low>` with its TID low.
9. Once this process completes, the game has now been decrypted and is usable with Citra. It can be found as `<Title ID>.cxi` in the `\files9\D9Game` from the SD card root.
_Note - this currently only works for titles with TID highs of 00040000, 0004008c, and 0004000e. For dumping system applications (TID high 00040010) such as Mii Maker, follow the directions below for dumping titles with an older version of Decrypt9._
#### If using a version of Decrypt9 released before 10/21/2016...
7. From the root Decrypt9 menu, choose `Content Decryptor Options`, then `SD File Options...`->`SD Decryptor (SysNAND dir)`. If the game is installed to EmuNAND, choose `SD Decryptor (EmuNAND dir)` instead of `SD Decryptor (SysNAND dir)`. If unsure, the SysNAND option is probably the correct choice.
8. Using the arrow keys, navigate folders until `/title/<TID high>/<TID low>` is selected, replacing `<TID high>` with the TID high of the game being dumped and `<TID low>` with its TID low.
9. Press `A` and wait for the process to finish. If there is an error, the SeedDB may need to be updated. From the root Decrypt9 menu, choose `SysNAND Options`, then `Miscellaneous...`, then `Update SeedDB`. Restart this step once the process completes.
10. Using a computer or a file manager such as [CTRXplorer](https://github.com/d0k3/CTRXplorer/releases), navigate from the SD card's root to `\files9\D9Game\title\<TID high>\<TID low>\content`.
11. Inside this file is a folder called `command`, a file with the `.tnd` extension, and one or more files with the `.app` extension. Find the largest file with the `.app` extension and move it to `\files9\D9Game`. Once this is done, the `\files9\D9Game\title` directory is no longer needed and can be deleted.
12. From the root Decrypt9 menu, select `Content Decryptor Options`, then `NCCH/NCSD File Options...`, then `NCCH/NCSD Decryptor`.
13. Once this process completes, the game has now been decrypted and is usable with Citra.
---
### Method 2: braindump
Any system with [Homebrew Launcher](http://smealum.github.io/3ds/) access can use braindump to dump installed applications. This method is much simpler and more user-friendly than the previous method, but comes with two caveats:
1. Digitally installed games that were released after the introduction of system version 9.6 cannot be dumped using braindump.
2. Braindump can't access all of the game's information, so it generates fake metadata. That is usually good enough for Citra, [__but not always__](https://github.com/neobrain/braindump/issues/24). If you find the game from braindump doesn't work (while others can play it), or you need a lossless dump for better compatibility, please use Decrypt9WIP instead.
#### Required tools
- [braindump](https://gbatemp.net/threads/braindump-userland-game-dumping.407332/)
- 3DS system with access to [the Homebrew Launcher](https://smealum.github.io/3ds/)
- SD card with enough space to dump the game card, 8GB or higher recommended
- SD card reader (preferred), or a way to use wireless file transfer
#### Instructions
1. Set up braindump by extracting the `braindump` folder to the `3ds` folder at the root of your 3DS SD card.
2. Enter the Homebrew Launcher using one of the various exploits.
3. Choose braindump, then select the game you want to dump.
4. Wait for the process to finish.
5. Your game will be at the root of the SD card and is immediately usable with Citra.