Guide_3DS/docs/dumping-titles-and-game-cartridges.md
lifehackerhansol d84cb07e29
docs: port to VitePress
Things that happen in this shameless squash:
- Removed 404 page
  - It doesn't work in VitePress and making it work in VitePress needs
    some invasive hack in the theme that I'm not willing to do
  - The default is more than enough, though
- Moved consoleVersionSelect include to another directory
  - This avoids being uploaded to Crowdin for translation
- Inline all SafeB9SInstaller includes
  - Not only do parameterized includes not work, but if/else statements
    don't work at all
- The sysupdate include parameter hasn't been used since MSET9, so it
  actually works just fine without any parameters. Hooray(?)
- Move mset9-chorus to an include, that logic doesn't work in VitePress
- Removed Get Started button from homepage, it breaks translations
- Tables in get-started are now shown by default; it seems VitePress really does
  not want us to use inline script. So we cannot enable it upon
  realizing that the browser is JS capable
- Include parameters are now in frontmatter to allow translation
- Hacked in a bunch of CSS values kanged from the old theme to make it
  look not stupid
- Drop headers down one level to make table of contents work
2024-09-27 08:38:29 -07:00

166 lines
6.5 KiB
Markdown

# Dumping Titles and Game Cartridges
::: info
For support (in English) with GodMode9, as well as help with scripting and to get updates and info, join [GodMode9 on Discord](https://discord.gg/BRcbvtFxX4).
:::
## Required Reading
Aside from creating and restoring NAND backups, GodMode9 has the functionality to dump installed titles to an installable `.cia` file, to dump game cartridge data to a `.3ds` ROM file, and to directly install a game cartridge to the system.
## Updating GodMode9
::: info
These instructions are written for use with GodMode9 v2.0.0 or later. If you have an older version of GodMode9, follow these instructions to update it.
:::
### What You Need
* The latest release of [GodMode9](https://github.com/d0k3/GodMode9/releases/latest) (the GodMode9 `.zip` file)
### Instructions
1. Power off your console
1. Insert your SD card into your computer
1. Copy `GodMode9.firm` from the GodMode9 `.zip` to the `/luma/payloads/` folder on your SD card
1. Copy the `gm9` folder from the GodMode9 `.zip` to the root of your SD card
1. Reinsert your SD card into your console
## Dumping a Game Cartridge
::: info
Insert the game cartridge you intend to dump into your console
+ 3DS game cartridges will be dumped to a `.3ds` format
+ NDS game cartridges will be dumped to a `.nds` format
:::
1. Press and hold (Start), and while holding (Start), power on your console. This will launch GodMode9
1. Navigate to `[C:] GAMECART`
1. Follow the steps applicable to your game cartridge:
+ **3DS Game Cartridge:** Press (A) on `[TitleID].trim.3ds` to select it
+ **NDS Game Cartridge:** Press (A) on `[TitleID].nds` to select it
+ Trimmed dumps are not recommended for NDS games in general, as they can cause various playback issues
1. Select "Copy to 0:/gm9/out"
1. Your non-installable `.3ds` or `.nds` formatted file will be outputted to the `/gm9/out/` folder on your SD card
## Installing a Game Cartridge Directly to the System
::: info
This will only work for 3DS games; it is not possible to install an NDS game cartridge to the system as a title.
:::
1. Press and hold (Start), and while holding (Start), power on your console. This will launch GodMode9
1. Navigate to `[C:] GAMECART`
1. Press (A) on `[TitleID].trim.3ds` to select it, then select "NCSD image options...", then select "Install game image"
1. Press (A) to unlock SysNAND (lvl1) writing, then input the key combo given
1. Once the process is complete, your game will show up in the HOME Menu as an installed title.
## Dumping a 3DS Game Cartridge to .CIA
::: info
This should only be used if [Installing a Game Cartridge Directly to the System](#installing-a-game-cartridge-directly-to-the-system) does not work.
:::
1. Press and hold (Start), and while holding (Start), power on your console. This will launch GodMode9
1. Navigate to `[C:] GAMECART`
1. Press (A) on `[TitleID].trim.3ds` to select it, then select "NCSD image options...", then select "Build CIA from file"
1. Your installable `.cia` formatted file will be outputted to the `/gm9/out/` folder on your SD card
## Dumping an Installed Title
::: info
This allows dumping of both System- and User-installed digital titles, such as ones downloaded from the eShop.
:::
1. Press and hold (Start), and while holding (Start), power on your console. This will launch GodMode9
1. Press (Home) to bring up the action menu
1. Select "Title manager"
1. Select one of the following depending on the type of title you wish to dump
+ **User Installed Title**: `[A:] SD CARD`
+ **System Title / DSiWare**: `[1:] NAND / TWL`
1. Select the title you wish to dump
1. Select "Manage Title..."
1. Select "Build CIA (standard)"
1. Your installable `.cia` formatted file will be outputted to the `/gm9/out/` folder on your SD card
## Backup GBA VC Saves
::: info
The game will be outputted to the `/gm9/out/` folder on your SD card with the name `<TitleID>.gbavc.sav`.
:::
::: info
To identify a `<TitleID>.gbavc.sav` file's Title ID, you can get a listing of all games on the system and their corresponding Title IDs by pressing (Home) to bring up the action menu, selecting `Title manager`, and selecting `[A:] SD CARD`.
:::
1. Do the following process for each GBA VC game that you want to back up the save for:
+ Launch the GBA VC game
+ Exit the GBA VC game
+ Power off your console
+ Press and hold (Start), and while holding (Start), power on your console. This will launch GodMode9
+ Navigate to `[S:] SYSNAND VIRTUAL`
+ Press (A) on `agbsave.bin` to select it
+ Select "AGBSAVE options..."
+ Select "Dump GBA VC save"
+ Press (A) to continue
+ Press (Start) to reboot your console
## Restore GBA VC Saves
::: info
To identify a `<TitleID>.gbavc.sav` file's Title ID, you can get a listing of all games on the system and their corresponding Title IDs by pressing (Home) to bring up the action menu, selecting `Title manager`, and selecting `[A:] SD CARD`.
:::
1. Do the following process for each GBA VC game that you want to restore the save for:
+ Launch the GBA VC game
+ Exit the GBA VC game
+ Power off your console
+ Press and hold (Start), and while holding (Start), power on your console. This will launch GodMode9
+ Navigate to `[0:] SDCARD` -> `gm9` -> `out`
+ Press (Y) on the `<TitleID>.gbavc.sav` file you wish to restore to copy it
+ Press (B) to return to the main menu
+ Navigate to `[S:] SYSNAND VIRTUAL`
+ Press (A) on `agbsave.bin` to select it
+ Select "AGBSAVE options..."
+ Select "Inject GBA VC save"
+ Press (A) to continue
+ Press (Start) to reboot your console
+ Launch the GBA VC game
+ Exit the GBA VC game
## Encrypting / Decrypting a .CIA file
::: info
For organizational purposes, copy each `.cia` file you wish to encrypt / decrypt to the `/cias/` folder on your SD card
:::
1. Press and hold (Start), and while holding (Start), power on your console. This will launch GodMode9
1. Navigate to `[0:] SDCARD` -> `cias`
1. Press (A) on the `.cia` file to select it, then select "CIA image options..."
1. Select the option to perform the desired function:
+ **Encrypt to 0:/gm9/out:** Create an encrypted copy of the selected `.cia` file in the `/gm9/out/` folder on your SD card
+ **Decrypt to 0:/gm9/out:** Create a decrypted copy of the selected `.cia` file in the `/gm9/out/` folder on your SD card
+ **Encrypt inplace:** Replace the selected `.cia` file with an encrypted version
+ **Decrypt inplace:** Replace the selected `.cia` file with a decrypted version
1. Your encrypted / decrypted `.cia` will be outputted to the desired location