DotNet 3DS Toolkit: Difference between revisions

From GameBrew
(Created page with "{{Infobox 3DS homebrew | title = DotNet 3ds Toolkit | image = https://dlhb.gamebrew.org/3dshomebrew/DotNet3dsToolkit.png|250px | type = PC Utilities | version = v1.5.0 | licen...")
 
m (Text replacement - "Category:PC utilities for 3DS homebrew" to "")
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = DotNet 3ds Toolkit
|title=.Net 3DS Toolkit
| image = https://dlhb.gamebrew.org/3dshomebrew/DotNet3dsToolkit.png|250px
|image=Dotnet3dstoolkit2.png
| type = PC Utilities
|description=Extract and Repack 3DS ROMs (and CIAs).
| version = v1.5.0
|author=evandixon
| licence = Mixed
|lastupdated=2018/10/08
| author = evandixon
|type=File Operation
| website = https://github.com/evandixon/DotNet3dsToolkit
|version=1.5.0
| download = https://dlhb.gamebrew.org/3dshomebrew/DotNet.3DS.Toolkit.v1.4.6.rar
|license=Mixed
| source = https://dlhb.gamebrew.org/3dshomebrew/DotNet.3DS.Toolkit.v1.4.6.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/dotnet3dstoolkit.7z 1.4.6 & 1.5.0
|website=https://github.com/evandixon/DotNet3dsToolkit
|source=https://github.com/evandixon/DotNet3dsToolkit
}}
}}
<youtube>-</youtube>
.Net 3DS Toolkit is a code library intended to simplify extracting and rebuilding 3DS ROMs, where ROMs can be extracted and repacked with a single command per operation, instead of using a dozen of commands.
 
# .Net 3DS Toolkit
.Net 3DS Toolkit is a code library intended to simplify extracting and rebuilding 3DS ROMs.


It is currently being rewritten in .Net Core 2.2 (and .Net Standard 2.1 once it's out). Please see the Old folder for the original source and details.
It is currently being rewritten in .Net Core 2.2 (and .Net Standard 2.1 once it's out). Please see the Old folder for the original source and details.


Current features:
==Features==
* Extract decrypted CCI files
* Extract decrypted CCI files.
* Extract decrypted CIA files
* Extract decrypted CIA files.
* Extract & Rebuild decrypted CXI files
* Extract & Rebuild decrypted CXI files.
* Extract & Rebuild decrypted RomFS files
* Extract & Rebuild decrypted RomFS files.
* Extract & Rebuild decrypted ExeFS files
* Extract & Rebuild decrypted ExeFS files.
* Allow reading data of individual files for all above formats without extraction
* Allow reading data of individual files for all above formats without extraction.


Planned features:
==User guide==
* Console interface
===System requirements===
* GUI
* .Net Framework 4.6.
* Build ROMs
* Free space on the system drive. Cleanup happens as soon as possible, but especially for larger ROMs, you may need several GB free.


## Credits
===Supported formats for extraction===
* Decrypted CCI (aka .3DS).
* Decrypted CXI (what Braindump gives you).
* Decrypted CIA.
* NDS ROM.


* 3dbrew.org for documentation
===Supported formats for building===
* SciresM for [RomFS-Builder](https://github.com/SciresM/RomFS-Builder), which was adapted for use in this project
* Decrypted CCI (aka .3DS) - For use with Citra. Can be used for Gateway and Sky 3DS (with CFW) if encrypted via [[Decrypt9WIP 3DS|Decrypt9]].
* 0-Key Encrypted CCI - For use with Gateway.
* CIA - For use with CFW.
* HANS RomFS, Code.Bin, and Homebrew Launcher Shortcut.
* NDS ROM.


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:
===Usage===
To extract:
ToolkitConsole.exe MyRom.3ds RawFiles


To extract:
Code:
ToolkitConsole.exe MyRom.3ds RawFiles
To repack as a CIA:
To repack as a CIA:
Code:
ToolkitConsole.exe RawFiles Repacked.cia
ToolkitConsole.exe RawFiles Repacked.cia
 
To repack as a 0-key encrypted CCI (for use with Gateway):
To repack as a 0-key encrypted CCI (for use with Gateway):
Code:
ToolkitConsole.exe RawFiles Repacked.3ds -key0
ToolkitConsole.exe RawFiles Repacked.3ds -key0
OR
OR
ToolkitConsole.exe RawFiles Repacked.3dz
ToolkitConsole.exe RawFiles Repacked.3dz
 
Note: 3dz files will be invalid until a private header is applied.
Note: 3dz files will be invalid until a private header is applied.


To repack as a decrypted CCI (for use with Citra or Decrypt9):
To repack as a decrypted CCI (for use with Citra or Decrypt9):
Code:
ToolkitConsole.exe RawFiles Repacked.3ds
ToolkitConsole.exe RawFiles Repacked.3ds
 
To repack for HANS:
To repack for HANS:
Code:
ToolkitConsole.exe RawFiles G:/ MyHack
ToolkitConsole.exe RawFiles G:/ MyHack
 
A GUI is available for anyone who doesn't want to bother with console commands. A .Net 4.6 code library is available for .Net developers making their own programs. See GitHub for library usage. Latest package will be on Sky Editor's MyGet feed and may be added to NuGet at some point.
A GUI is available for anyone who doesn't want to bother with console commands. A .Net 4.6 code library is available for .Net developers making their own programs. See GitHub for library usage. Latest package will be on Sky Editor's MyGet feed and may be added to NuGet at some point.


System requirements:
==Screenshots==
.Net Framework 4.6
https://dlhb.gamebrew.org/3dshomebrews/dotnet3dstoolkit6.png
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:
https://dlhb.gamebrew.org/3dshomebrews/dotnet3dstoolkit7.png
Decrypted CCI (aka .3DS)
Decrypted CXI (what Braindump gives you)
Decrypted CIA
NDS ROM


Supported formats for building:
https://dlhb.gamebrew.org/3dshomebrews/dotnet3dstoolkit8.png
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
NDS ROM


Planned Features:
==Credits==
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.
* 3dbrew.org for documentation.
* 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.


Credits:
==External links==
SciresM for 3DS Builder (modified to use command-line arguments)
* GitHub - https://github.com/evandixon/DotNet3dsToolkit
profi200 for Project_CTR's makerom
* MyGet - https://www.myget.org/feed/skyeditor/package/nuget/DotNet3dsToolkit
dnasdw for 3dstool
* GBAtemp - https://gbatemp.net/threads/release-net-3ds-toolkit-extract-and-repack-3ds-roms-and-cias.444427
Asia81 for HackingToolkit3DS, which provided the usage for 3dstool.
* Project Pokemon Forums - https://projectpokemon.org/home/forums/topic/39082-net-3ds-toolkit-extract-and-repack-3ds-roms-and-cias

Latest revision as of 04:24, 6 May 2024

.Net 3DS Toolkit
Dotnet3dstoolkit2.png
General
Authorevandixon
TypeFile Operation
Version1.5.0
LicenseMixed
Last Updated2018/10/08
Links
1.4.6 & 1.5.0 Download
Website
Source

.Net 3DS Toolkit is a code library intended to simplify extracting and rebuilding 3DS ROMs, where ROMs can be extracted and repacked with a single command per operation, instead of using a dozen of commands.

It is currently being rewritten in .Net Core 2.2 (and .Net Standard 2.1 once it's out). Please see the Old folder for the original source and details.

Features

  • Extract decrypted CCI files.
  • Extract decrypted CIA files.
  • Extract & Rebuild decrypted CXI files.
  • Extract & Rebuild decrypted RomFS files.
  • Extract & Rebuild decrypted ExeFS files.
  • Allow reading data of individual files for all above formats without extraction.

User guide

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).
  • Decrypted CIA.
  • NDS ROM.

Supported formats for building

  • Decrypted CCI (aka .3DS) - For use with Citra. Can be used for Gateway and Sky 3DS (with CFW) if encrypted via Decrypt9.
  • 0-Key Encrypted CCI - For use with Gateway.
  • CIA - For use with CFW.
  • HANS RomFS, Code.Bin, and Homebrew Launcher Shortcut.
  • NDS ROM.

Usage

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 -key0
OR
ToolkitConsole.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

A GUI is available for anyone who doesn't want to bother with console commands. A .Net 4.6 code library is available for .Net developers making their own programs. See GitHub for library usage. Latest package will be on Sky Editor's MyGet feed and may be added to NuGet at some point.

Screenshots

dotnet3dstoolkit6.png

dotnet3dstoolkit7.png

dotnet3dstoolkit8.png

Credits

  • 3dbrew.org for documentation.
  • 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.

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=DotNet_3DS_Toolkit&oldid=153379’

Advertising: