OpenPunk/citra
1
0
Fork 0
mirror of https://github.com/citra-emu/citra.git synced 2024-11-25 07:00:14 +00:00
Code Issues Projects Releases Wiki Activity

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

tekas 2016-10-22 10:43:40 -05:00
parent fe6308b3d1
commit 3653dd58fa
2 changed files with 46 additions and 59 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
Dumping-Game-Cartridges.md Normal file

@ -0,0 +1,46 @@
## How to Dump and Decrypt 3DS Cartridges
There are two methods to dump game cartridges 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
Dumping a cartridge does not dump DLC and updates for that cartridge. Those are stored on the SD card. See [[Dumping Installed Titles]] for more information.
---
### Method 1: Decrypt9WIP
By far the most reliable method of dumping game cartridges, but also by far the most complicated to up.
#### 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. Insert the game cartridge to be dumped into the 3DS.
6. From the root Decrypt9 menu, choose `Gamecart Dumper Options`, then `Dump & Decrypt Cart (trim)`.
7. Once this process completes, the game will be a .3ds file inside `/files9/D9Game` and is immediately usable with Citra.
---
### Method 2: braindump
Any system with [Homebrew Launcher](http://smealum.github.io/3ds/) access can use braindump to dump cartridges. 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. The inserted game card is the first one to appear.
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.

59
Dumping-Games-and-Applications.md

@ -1,59 +0,0 @@
## How to Dump and Decrypt 3DS Games
There are two methods to dump games and applications 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 similarly to how installed applications and games are dumped, 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 game cartridges and system applications, but also by far the most complicated to up, especially since you use different instructions for dumping applications installed to the 3DS than for dumping a physical cartridge.
#### 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.
#### If dumping a cartridge...
5. Insert the game cartridge to be dumped.
6. From the root Decrypt9 menu, choose `Gamecart Dumper Options`, then `Dump & Decrypt Cart (trim)`.
7. Once this process completes, the game will be a .3ds file inside `/files9/D9Game` and is immediately usable with Citra.
#### If dumping an installed game or application...
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`.
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 cartridges and 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. The inserted game card is the first one to appear.
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.