Help:Dumping games: Difference between revisions

Updated instructions for latest version of nxdumptool (rewrite release: dump from Switch to PC through USB) - missing exefs dump instructions, will update this part later
m (Added back "Before running Dumpling, disable auto power off and standby on your Wii U." to the website version.)
(Updated instructions for latest version of nxdumptool (rewrite release: dump from Switch to PC through USB) - missing exefs dump instructions, will update this part later)
Line 37: Line 37:


== Switch ==
== Switch ==
Dump the game files directly to your SD card using nxdumptool. Update data can only be processed if the base game is available, because they share the same filesystem. DLCs don't, so they have to be dumped separately.
Dump the game files directly to your PC using nxdumptool. Update data can only be processed if the base game is available, because they share the same filesystem. DLCs don't, so they have to be dumped separately.


'''Warning''': If you misbehave (piracy, online cheating or anything equally stupid), you might get banned from Nintendo online services. If you do not want to leave any traces, turn on airplane mode, back up your eMMC '''before running any homebrew''' and do not ever go online before you have restored the backup.
'''Warning''': If you misbehave (piracy, online cheating or anything equally stupid), you might get banned from Nintendo online services. If you do not want to leave any traces, turn on airplane mode, back up your eMMC '''before running any homebrew''' and do not ever go online before you have restored the backup.
If you already have the game setup on a Switch emulator, you do not need to follow any of the steps with nxdumptool on your Switch. Right click the game in your emulator and:
* ''<code>Extract data</code>'' > <code>''Dump RomFS''</code> ('''Ryujinx''')
* ''<code>Dump RomFS</code>'' > <code>''Dump RomFS''</code> > <code>''Full''</code> ('''Yuzu''')


=== Prerequisites ===
=== Prerequisites ===
* [https://github.com/DarkMatterCore/nxdumptool nxdumptool].
* Keys file generated using [https://github.com/Decscots/Lockpick_RCM/releases Lockpick_RCM], located at <code>sdmc:/switch/prod.keys</code>. Run the payload on your console through RCM in order to dump the keys needed by nxdumptool to decrypt contents.
* Keys file generated using [https://github.com/shchmue/Lockpick_RCM Lockpick_RCM], located at <code>sdmc:/switch/prod.keys</code>. Run the payload on your console through RCM in order to dump the keys needed by nxdumptool to decrypt contents.
* [https://github.com/DarkMatterCore/nxdumptool/releases/tag/rewrite-prerelease nxdumptool rewrite] (join the discord server linked on the description of this release to get the PC host app in <code>#pre-build-files</code>).
* [https://zadig.akeo.ie/ Zadig] to setup the driver for dumping through USB


=== Dumping game files ===
=== Dumping game files ===
* On your Switch, open nxdumptool. Afterwards:
*# '''If you have the gamecard''': Select <code>Dump gamecard content</code>.
*# '''If you have the eShop version''': Select <code>Dump SD card / eMMC content</code>, then select BotW.
* Select <code>RomFS options</code>.
* Highlight the <code>Use update/DLC</code> option and use the left/right buttons to cycle through the available updates/DLCs for the game.
*# '''If you have no available updates/DLCs''', this option won't appear. You'll only be able to dump the files from the non-updated base game (which is the same to just leaving this option set to <code>No</code>).
*# Updates are tagged as <code>(UPD)</code>, and they use <code>01007EF00011E800</code> as their ID. v786432 (0.0.12.0) corresponds to BotW v1.6.0 update.
*# DLCs are tagged as <code>(DLC)</code>. <code>01007EF00011F001</code> and <code>01007EF00011F002</code> are the known IDs for the existent BotW DLCs.
* Select <code>RomFS section data dump</code> and wait for the process to finish. This will dump the internal filesystem from the selected update/DLC to the inserted SD card.


Just like it was previously mentioned, updates share their filesystem data with the base game, so dumping the RomFS from an update is equivalent to dumping the whole filesystem from the updated game data. In other words, it isn't necessary to dump the base game filesystem separately if you choose an update.
* First, make sure to dump your keys by injecting the '''Lockpick_RCM''' payload and selecting "Dump title keys".
 
* Then, reboot to Atmosphère, open nxdumptool rewrite (''nxdt_rw_poc''), and plug the Switch to your computer with a USB cable.
* With nxdumptool open, launch Zadig on your computer, and follow the driver installation instructions below
*# Go to <code>Options</code> and make sure <code>List all devices</code> is checked -- if not, click that option.
*# Using the dropdown list with USB devices, select the name of the NRO you launched on your Switch (e.g. <code>nxdt_rw_poc</code>).
*# Change the <code>Driver</code> dropdown on the right to <code>libusbK</code> (the actual version number doesn't matter).
*# Wait until the installation process finishes.
[[File:Zadig.png|left|thumb|500x500px|Once the installation is complete, the window should look like this]]
 
 
 
 
 
 
 
 
 
 
* Open the host app downloaded from <code>#pre-build-files</code> in the official nxdumptool discord server, and click <code>Start Server</code> (if the Switch is not detected, it means you probably didn't setup the driver properly).
* On nxdumptool, navigate through the menu by selecting the following options:
*# Go to <code>user titles menu</code>, then select <code>The Legend of Zelda: Breath of the Wild</code>
*# Select the following options: <code>nca / nca fs dump options</code>  -> <code>dump base application</code> -> <code>Program #0</code> -> <code>FS section #2: RomFS</code>
*# On the line with <code>use base/patch title</code>: select the installed update
*# On the line with <code>output storage</code>: select <code>usb host (pc)</code>
*# Select <code>start nca fs section dump</code>
Depending on your USB speed (2.0 or 3.0) and the quality of your cable, it may vary from 10 minutes up to an hour.
'''It may fail if your USB cable is faulty, or if you run out of space on your computer (requires at least 14GB of available storage).'''
Just like it was previously mentioned, updates share their filesystem data with the base game, so dumping the RomFS with an update is equivalent to dumping the whole filesystem from the updated game data. In other words, it isn't necessary to dump the base game filesystem and update separately.


DLCs, on the other hand, must be dumped separately.
DLCs, on the other hand, must be dumped separately.


When you're done, you'll be able to find the output dumps in <code>sdmc:/switch/nxdumptool/RomFS</code>.
If you have the DLCs installed, once the dump of the base application and update was completed, repeat previous steps from 1 to 5 again, but select <code>dump dlc</code> instead of <code>dump base application</code> on step 2.
 
# Updates are tagged as <code>(UPD)</code>, and they use <code>01007EF00011E800</code> as their ID. v786432 (0.0.12.0) corresponds to BotW v1.6.0 update.
It is recommended to copy these dumps to your PC, for use with modding tools and to free up space on your SD card.
# DLCs are tagged as <code>(DLC)</code>. <code>01007EF00011F001</code> and <code>01007EF00011F002</code> are the known IDs for the existent BotW DLCs.
When you're done, you'll be able to find the output dumps under <code>NCA FS\Extracted</code> in the nxdumptool host app folder.


=== Dumping binaries (executable files) ===
=== Dumping binaries (executable files) ===