tutorial .Net 3DS Toolkit - Extract and Repack 3DS ROMs (and CIAs)

[evandixon]

Ever notice how the majority of command-line applications require about a dozen commands for a single logical operation? This tool aims to fix that! ROMs can be extracted and repacked with a single command per operation, like so:

To extract:

ToolkitConsole.exe MyRom.3ds RawFiles

 

To repack as a CIA:

ToolkitConsole.exe RawFiles Repacked.cia

 

To repack as a 0-key encrypted CCI (for use with Gateway):

ToolkitConsole.exe RawFiles Repacked.3ds -key0ORToolkitConsole.exe RawFiles Repacked.3dz

 

Note: 3dz files will be invalid until a private header is applied.

To repack as a decrypted CCI (for use with Citra or Decrypt9):

ToolkitConsole.exe RawFiles Repacked.3ds

 

To repack for HANS:

ToolkitConsole.exe RawFiles G:/ MyHack

 

System requirements:

• .Net Framework 4.6
• Free space on the system drive. Cleanup happens as soon as possible, but especially for larger ROMs, you may need several GB free.

Supported formats for extraction:

• Decrypted CCI (aka .3DS)
• Decrypted CXI (what Braindump gives you)

Supported formats for building:

• Decrypted CCI (aka .3DS)
  • For use with Citra
  • Can be used for Gateway and Sky 3DS (with CFW) if encrypted using Decrypt9

  [*] 0-Key Encrypted CCI

  • For use with Gateway

  [*] CIA

  • For use with CFW

  [*] HANS RomFS, Code.Bin, and Homebrew Launcher Shortcut

Planned Features:

• Copy private header to 0-key encrypted CCI files as they are built. Until this is done, any *.3dz files created are invalid until a private header is added.
• Decrypted CIA extraction

This also doubles as a code library for developers. See GitHub for library usage. Latest package will be on Sky Editor's MyGet feed and may be added to NuGet at some point.

Credits:

• SciresM for 3DS Builder (modified to use command-line arguments)
• profi200 for Project_CTR's makerom
• dnasdw for 3dstool
• Asia81 for HackingToolkit3DS, which provided the usage for 3dstool.

Release Page

GitHub

Download

[BlackShark]

Really nice and helpful tool! Thanks!

I found a small issue though. The tool is throwing an unhandled exception while extracting an update cia because it expects a banner.bin to be extracted which doesn't exist for update data.

[ttyybb]

im new to romhacks where do you input the commands/ is there a tutorial i could look at

[aka_boonie]

Hello, I used this to make a .3ds file into a folder so I could randomize the game. How would I take this folder and make it back into a .3ds, so I can play the game using Citra?

 

 

Edited October 14, 2022 by aka_boonie