ROM Hack [Release] .Net 3DS Toolkit - Extract and Repack 3DS ROMs (and CIAs)

TheShadowRunner · Feb 15, 2020

Yes, it worked! But I had to build to Decrypted CXI (.3ds), then "verify and fix" in GM9, before it allowed me to convert it to cia and finally install it.
Building directly to Decrypted cia (shouldn't it be Encrypted..?) generates an invalid cia that cannot be salvaged.

evandixon · Feb 15, 2020

In the past, I've never had any problems building CIA files with these tools. But I'm glad that you found a workaround.

TheShadowRunner said:
(shouldn't it be Encrypted..?)

Best we can do is encrypt CIAs with a zero-key or a development key for panda units, as Nintendo's private key is private. CFW should make decrypted CIAs not be a problem, but it's been quite a while since I've checked. Thanks to Luma 3DS's Layered FS, building custom CIAs is pretty much obsolete, but I don't think it would work for custom banners.

TheShadowRunner · Feb 15, 2020

Yes as long as it works
A question, if I modify files in the "decrypted banner" folder, are the changes taken into account when I rebuild the game?
Or is that folder just for convenience and not used on rebuild?

Hyoretsu · Mar 10, 2020

Is there a way to repack it as decrypted CXI? I just dumped all my games/updates/DLCs on 3DS to use with Citra, so I'm trying to merge all of them (CXI would be preferrable since its an exclusive format)

botik · Mar 11, 2020

Hyoretsu said:
Is there a way to repack it as decrypted CXI? I just dumped all my games/updates/DLCs on 3DS to use with Citra, so I'm trying to merge all of them (CXI would be preferrable since its an exclusive format)

There is a version for Python3 from the quick installation tool. Any .3ds or .cia file we will drag on the _citra.py and in the _citra folder will appear .cxi files

Hyoretsu · May 20, 2020

botik said:
There is a version for Python3 from the quick installation tool. Any .3ds or .cia file we will drag on the _citra.py and in the _citra folder will appear .cxi files

https://github.com/BpyH64/QuickSetup3DS/releases

No luck, the program closes as soon as I drag a file or folder (Tried with .cxi and renamed them to .cia, no use to at least throw an error) into _citra.py/_install.py.
DotNet 3DS Toolkit also thinks something's missing and doesn't allow me to rebuild to any format, not even rebuilding to .cia and re-extracting on the 3DS. I get "open file X:\!Emulators\!Updates\Super Smash Bros\game/HeaderExeFS.bin failed", same error for Header NCCH1.bin, NCCH2.bin, NCCH6.bin and NCCH7.bin. When trying to rebuild as .cxi/.3ds I get "NCCH header not found. This can happen if you extracted a CXI and are trying to rebuild a decrypted CCI. Try rebuilding as a key-0 encrypted CCI instead" which is exactly the case, but how'd I go about converting key-0 .3ds to .cxi? Or do I re-extract all games as .CIA and try rebuilding as .cxi instead?
Here's what my folder looks like:

eqagunn · Jun 8, 2020

AnalogMan said:
turns out this tool chokes on unpacking Update files since they lack a banner.bin and the extraction never finishes after giving an error.

Tygatiga said:
when I tried to extract an update patch .CIA and a DCL (also as .CIA), neither would work. Both of these hung after popping up with exception error windows.

evandixon said:
Updates and DLC are a little different than standard CIAs. Unfortunately the tool doesn't currently support these, not even the latest builds. If anyone happens to know the correct command-line tools to extract and rebuild updates and DLC, that'd be very helpful.

I hope someone can help out to have this amended.

For all the newbies looking into merging updates into the full game for usage in Citra I'd like to share my 24h-newbie findings.
Btw, yes, I know Citra can install .cia updates.

Regardless of the error and hang when handling updates tool seems to extract all the files.
I have successfully extracted .3ds ROM and .cia update and merged them afterwords following instructions here:
community.citra-emu. org /t/need-help-trying-to-rebuild-cxi-file-along-with-game-update/2910/5
Those were the only instructions I was able to find for this goal.

My only change was renaming ExeFS\icon.icn to icon.bin and copying it over along with code.bin so icon gets updated as well, as it's the case with Pokemon Ultra Sun v1.2 EUR.
My other working example was TriForce Heroes v2.1.0 EUR. Regarding the Title ID part, after following instructions at:
github. com /ihaveamac/3DS-rom-tools/wiki/Edit-title-ID-with-extracted-NCCH-header-and-ExHeader
Title ID turned out to be the same in the .3ds and .cia files for both games so I had nothing to do with it.

Both newly built .3ds files boot fine in Citra, with proper version number displayed in-game.
I've got no clue if any of the remaining files should be carried over as well.

@evandixon Would be great if you could implement option for trimming.

Deleted member 539007 · Sep 23, 2020

i want to repack Pokemon X, but i got an error:
ERROR: open file C:\Users\john\Desktop\STORAGE\3DS Editor\Pokemon X\HeaderNCCH2.bin failed
ERROR: create file failed
ERROR: open file C:\Users\john\Desktop\STORAGE\3DS Editor\Pokemon X\HeaderNCCH6.bin failed
ERROR: create file failed

LkgFate · Sep 23, 2020

How long does it take to build a file as Decrypted CCI. The folder from which im building is solidly big (5.8 GB) but i feel like it takes way to long. It also showed me this error. Previously the Error /Exheader.bin was not found occured. I added said file but it clearly sparked a new problem. Should i remove all of these files? Is it just fine like it is and will just take some time?
Exception Details:
System.IO.FileNotFoundException: Die Datei "C:\Users\leonb\OneDrive\Desktop\fates randomizer\Fates Randomizer Beta 5-1\StoreFE\ExeFS\banner.bin" konnte nicht gefunden werden.

evandixon · Sep 25, 2020

Shieldo said:
i want to repack Pokemon X, but i got an error:
ERROR: open file C:\Users\john\Desktop\STORAGE\3DS Editor\Pokemon X\HeaderNCCH2.bin failed
ERROR: create file failed
ERROR: open file C:\Users\john\Desktop\STORAGE\3DS Editor\Pokemon X\HeaderNCCH6.bin failed
ERROR: create file failed

These errors are more like warnings than errors, and it's likely Pokémon X was repacked successfully.

botik · Sep 25, 2020

CCI/3DS it has maximum 5 NCCH partitions

0 Game Executable (the most important!!!)
1 Manual
2 Download Play Child container
6 New3DS Update Data
7 Old3DS Update Data

ERROR: open HeaderNCCH2.bin
ERROR: open HeaderNCCH6.bin

Means that "Download Play Child container" and "New3DS Update Data" are not in this image CCI/3DS

newguy312 · Dec 6, 2022

With the 3DS shop closing soon I was looking for a tool to patch my games with latest updates and dlc in a single file for archival and preservation purposes. This tool kinda works, it extracted the games fine, but extracting updates and dlcs always presents an error. It extracts some files but idk if those are all the files I would need. Anyway merging the files that I get with the base game and then rebuilding it works, the game runs on Citra with the updated version applied although I can't really tell if the full update was patched. One bad side effect from doing this is that the file size gets way bigger, for instance, F*** E***** A******** goes from 1.2gb to 2gb when applying a 100~ mbs dlc.

Chiantox · May 24, 2026

@evandixon I'm very confused cause when i try to repack my Fire Emblem Fates rom toolkit claims I'm trying to create an already existing file. I'm not technologically litterate so I don't know how to help you help me. Here's what I get (it's in french sry):

à System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)
à System.IO.__Error.WinIOError()
à System.IO.File.InternalMove(String sourceFileName, String destFileName, Boolean checkHost)
à DotNet3dsToolkit.Converter.VB$StateMachine_70_BuildExeFS.MoveNext() dans D:\TeamCity\buildAgent\work\c024c1966f7da4c7\DotNet3dsToolkit\Converter.vb:ligne 355
--- Fin de la trace de la pile à partir de l'emplacement précédent au niveau duquel l'exception a été levée ---
à System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
à System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
à DotNet3dsToolkit.Converter.VB$StateMachine_71_BuildPartition0.MoveNext() dans D:\TeamCity\buildAgent\work\c024c1966f7da4c7\DotNet3dsToolkit\Converter.vb:ligne 376
--- Fin de la trace de la pile à partir de l'emplacement précédent au niveau duquel l'exception a été levée ---
à System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
à System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
à DotNet3dsToolkit.Converter.VB$StateMachine_76_BuildPartitions.MoveNext() dans D:\TeamCity\buildAgent\work\c024c1966f7da4c7\DotNet3dsToolkit\Converter.vb:ligne 431
--- Fin de la trace de la pile à partir de l'emplacement précédent au niveau duquel l'exception a été levée ---
à System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
à System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
à DotNet3dsToolkit.Converter.VB$StateMachine_85_Build3DSDecrypted.MoveNext() dans D:\TeamCity\buildAgent\work\c024c1966f7da4c7\DotNet3dsToolkit\Converter.vb:ligne 593
--- Fin de la trace de la pile à partir de l'emplacement précédent au niveau duquel l'exception a été levée ---
à System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
à System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
à DotNet3dsToolkit.Converter.VB$StateMachine_86_Build3DSDecrypted.MoveNext() dans D:\TeamCity\buildAgent\work\c024c1966f7da4c7\DotNet3dsToolkit\Converter.vb:ligne 627
--- Fin de la trace de la pile à partir de l'emplacement précédent au niveau duquel l'exception a été levée ---
à System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
à System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
à DotNet3dsToolkit.Converter.VB$StateMachine_94_BuildAuto.MoveNext() dans D:\TeamCity\buildAgent\work\c024c1966f7da4c7\DotNet3dsToolkit\Converter.vb:ligne 853
--- Fin de la trace de la pile à partir de l'emplacement précédent au niveau duquel l'exception a été levée ---
à System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess(Task task)
à System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task)
à ToolkitForm.Form1.VB$StateMachine_24_btnBuild_Click.MoveNext() dans D:\TeamCity\buildAgent\work\c024c1966f7da4c7\ToolkitForm\Form1.vb:ligne 190
--- Fin de la trace de la pile à partir de l'emplacement précédent au niveau duquel l'exception a été levée ---
à System.Runtime.CompilerServices.AsyncMethodBuilderCore.<>c.<ThrowAsync>b__6_0(Object state)

ROM Hack [Release] .Net 3DS Toolkit - Extract and Repack 3DS ROMs (and CIAs)

I'm like you, I have no name.

PMD Researcher

I'm like you, I have no name.

Itosugi Masahiro's Loyal Reader

Well-Known Member

Itosugi Masahiro's Loyal Reader

Active Member

New Member

New Member

PMD Researcher

Well-Known Member

New Member

New Member

Similar threads

Popular threads in this forum