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

6.5 KiB

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.

:::

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 (the GodMode9 .zip file)

Instructions

  1. Power off your console
  2. Insert your SD card into your computer
  3. Copy GodMode9.firm from the GodMode9 .zip to the /luma/payloads/ folder on your SD card
  4. Copy the gm9 folder from the GodMode9 .zip to the root of your SD card
  5. 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
  2. Navigate to [C:] GAMECART
  3. 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
  4. Select "Copy to 0:/gm9/out"
  5. 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
  2. Navigate to [C:] GAMECART
  3. Press (A) on [TitleID].trim.3ds to select it, then select "NCSD image options...", then select "Install game image"
  4. Press (A) to unlock SysNAND (lvl1) writing, then input the key combo given
  5. 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 does not work.

:::

  1. Press and hold (Start), and while holding (Start), power on your console. This will launch GodMode9
  2. Navigate to [C:] GAMECART
  3. Press (A) on [TitleID].trim.3ds to select it, then select "NCSD image options...", then select "Build CIA from file"
  4. 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
  2. Press (Home) to bring up the action menu
  3. Select "Title manager"
  4. 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
  5. Select the title you wish to dump
  6. Select "Manage Title..."
  7. Select "Build CIA (standard)"
  8. 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
  2. Navigate to [0:] SDCARD -> cias
  3. Press (A) on the .cia file to select it, then select "CIA image options..."
  4. 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
  5. Your encrypted / decrypted .cia will be outputted to the desired location