From ed6fb2b68ffca205b6256c41c703cf92b3f39513 Mon Sep 17 00:00:00 2001
From: tekas <e9aaa7d3@opayq.com>
Date: Wed, 26 Oct 2016 21:35:00 -0500
Subject: [PATCH] creating a new page for dumping extdata. todo - weird quirk
 with smash brothers 3ds and add other known games to the extdata id table

---
 Dumping-Extra-Data-from-a-3DS-Console.md | 48 ++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Dumping-Extra-Data-from-a-3DS-Console.md

diff --git a/Dumping-Extra-Data-from-a-3DS-Console.md b/Dumping-Extra-Data-from-a-3DS-Console.md
new file mode 100644
index 0000000..b3662b5
--- /dev/null
+++ b/Dumping-Extra-Data-from-a-3DS-Console.md
@@ -0,0 +1,48 @@
+## How to Transfer 3DS Extra Data to Citra
+In addition to save data, some games and system applications use extra data. Game extra data is stored on the SD card and can be extracted and used by Citra. The below tutorial uses [JK's Save Manager](https://github.com/J-D-K/JKSM/releases) (JKSM) to perform the extraction, which is easy to install and use.
+
+##### Example - location of Mario vs. Donkey Kong: Tipping Stars extra data
+Location of the "User Directory": on Windows it is the user folder in the same directory as the Citra executable. on macOS and Linux it is at ~/.local/share/citra-emu/
+```
+"User Directory"
+└── sdmc
+    └── Nintendo 3DS
+        └── 00000000000000000000000000000000
+            └── 00000000000000000000000000000000
+                └── extdata
+                    └── 00000000
+                        └── 000012C8
+                            └── user
+```
+
+#### Required tools
+- A 3DS with [arm9loaderhax](https://github.com/Plailect/Guide/wiki) installed (recommended) or [homebrew launcher](http://smealum.github.io/3ds/) access.
+- [JKSM](https://github.com/J-D-K/JKSM/releases)
+- SD card reader (preferred), or a way to use wireless file transfer
+
+In addition to the tools required, some knowledge is required as well. The game to have its extra data dumped from has an ID associated with its extra data (called its Ext ID). This needs to be known in order to place the dumped data in the correct place in Citra's directory structure. Below are some of the known extra data IDs. This list is a work in progress and not comprehensive. Please add additional extra data IDs as they are learned.
+
+| Game          | Ext ID High   | Ext ID Low |
+| ------------- |:-------------:|:----------:|
+| Mario vs. Donkey Kong: Tipping Stars | 00000000 | 000012C8 |
+
+### Installing JKSM
+1. Download JK's Save Manager from the link above.
+2. Move the JKSV folder containing filter.txt to the root of the SD card.
+3. Move JKSM.cia to the SD card and install it to the home menu.
+
+***Note - JKSM has a homebrew app available, but The .cia is recommended because the homebrew app does not work with up-to-date 3DS firmware. To install the homebrew app, merge the 3ds/JKSM folder containing the JKSM.3dsx, JKSM.smdh, and JKSM.xml file with the 3ds folder on the SD card and use the [homebrew launcher](http://smealum.github.io/3ds/) to open it.
+
+---
+
+### Transferring Extra Data
+1. Open JKSM
+2. Select `SD/CIA` if you are dumping extra data from an installed game or `System Titles` if you are dumping extra data from a system application.
+3. Highlight the title to dump the save data from*. Press A.
+4. Select `Extra Data Options`, then `Export ExtData`.
+5. You will be prompted to select a folder or `New`. If selecting `New`, enter any name you wish and then select `OK`.
+6. A popup should appear that says `Complete!` Close JKSM.
+7. Transfer all files located in `/JKSV/ExtData/<Title Name>/<Folder name selected or created in Step 5>` to the computer.
+8. Place the files in Citra's emulated SD card's extra data directory at `user/sdmc/Nintendo 3DS/000...0/000...0/extdata/<Ext ID High>/<Ext ID Low>/user/`. These directories may have to be created if the title the extra data was dumped from hasn't been played in Citra yet.
+
+*In step 3, If the title to be dumped isn't on the list, JKSM's filter may need to be updated. This can be done easily from the app's root menu and selecting `Download Filter` (internet connection required). If that still doesn't work, filter.txt will have to be updated manually. Look up the game [here](http://www.3dsdb.com/) and grab it's title ID. Open filter.txt located in the JKSM folder and add a new line. Type 0xXXXXXXXX where XXXXXXXX is the game's title low (the last 8 characters of the game's title ID). Save the edited file. The game should now appear in the list.
\ No newline at end of file