RxTools 3DS: Difference between revisions

From GameBrew
No edit summary
m (Text replacement - "Category:3DS homebrew system tools" to "")
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox-3DS-Homebrews
{{Infobox 3DS Homebrews
| title = rxTools
|title=rxTools
| image = https://dlhb.gamebrew.org/3dshomebrew/rxTools---Roxas75-3DS-Toolkit.png|250px
|image=Rxtools3.png
| type = System Tools
|description=A collection of hacking tools for FW 4.1 to 9.2.
| version=3.0-beta_2
|author=roxas75
| lastupdated = 2016/02/09
|lastupdated=2016/02/09
| licence = MIT
|type=System Tools
| author = roxas75
|version=3.0-beta_2
| website = https://github.com/roxas75/rxTools
|license=GPL-2.0
| download = https://dlhb.gamebrew.org/3dshomebrew/rxTools---Roxas75-3DS-Toolkit-3DS.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/rxtools.7z
| source = https://github.com/roxas75/rxTools
|website=https://github.com/roxas75/rxTools
|source=https://github.com/roxas75/rxTools
}}
}}
<youtube>DxWHuAcc6Po</youtube>
{{Obsolete}}
 
rxTools is a collection of hacking tools for Nintendo 3DS/3DSXL/2DS, compatible with all the system versions from 4.1 to 9.2. rxMode is a free custom firmware which works through rxTools, not meant to replace any existing software, but based on personal work made public and easy for the end-user.


== rxTools - Roxas75 3DS Toolkit ==
Originally created by Roxas75 and released in 2015. Shortly after the rxTools 2.6 release, Roxas75 announced his retirement from the rxTools project and has passed on the development of rxTools to the PastaCFW Team.


rxTools is a collection of hacking tools for Nintendo 3DS/3DSXL/2DS, compatible with all the system versions from 4.1 to 9.2. rxMode is a free custom firmware which works through rxTools, not meant to replace any existing software, but just my personal work made public and easy for the end-user. It was not meant, at the beginning, to be open-source, so you can expect some messed up code here. I do not support piracy in any way, all the data and information in my software have already been made public.
==Features==
* rxMode, free 3DS custom firmware.
* CTR Titles Decryption.
* Title Keys Decryption.
* Xorpad Generation.
* NAND Dumping.
* NAND Partitions Decryption/Injection.
* NAND FAT16 Xorpad Generation.
* System Titles Dumping.
* NAND Files Dumping/Injecting, for various hacks/mods.
* Much, much more.


==Tools​==
==Installation==
'''Setting up rxTools:'''
* If you have used a previous version, please delete SD:/rxTools, SD:/3ds/rxTools, and rxTools.dat, if present on your (m)SD card. 
* Extract the rxTools folder from the release and place it into the root of your card.
* If you are using an Old 3DS or 2DS, ensure you have Python 2.7 installed on your PC and run /Tools/o3ds_cdn_firm.py.
** This should download 3 files into a folder named /firm.
** Copy this entire folder and place it into SD:/rxTools/.
* If you are using an New 3DS, ensure you have Python 2.7 installed on your PC and run /Tools/n3ds_cdn_firm.py.
** This should download 1 file into a folder named /firm.
** Copy this entire folder and place it into SD:/rxTools/.
** You also need the files key_0x16.bin (N3DS arm9bin decryption, 9.6+ keyX) and key_0x1B.bin (N3DS 9.6 NCCH keyX) on the root of your SD card.
* For use with the Homebrew Launcher, go into the ninjhax folder and copy the /rxTools folder to SD:/3ds/ 


So, here we go with the utilities rxTools can offer.
'''Launch with Spider (9.2 or older):'''
* rxTools now stores its code.bin in rxTools/sys/code.bin (formerly /rxTools.dat).
* To launch rxTools using the Spider exploit visit https://dukesrg.github.io/?rxTools/sys/code.bin using the 3DS Internet Browser.  


*rxMode, free 3DS custom firmware
'''Install DS Profile (MSET) Exploit (MSET 6.x):'''
*CTR Titles Decryption
* Upon building, there will be a folder called release/mset that contains the files rxinstaller.nds and rxinstaller.bin.
*Title Keys Decryption
* Using a supported NDS flash cart, launch rxinstaller.nds to install the MSET exploit.
*Xorpad Generation
** Otherwise, on firmwares 9.2 or older, copy rxinstaller.bin (take it in release/mset/) to SD:/mset/.
*NAND Dumping
** Then visit https://dukesrg.github.io/?mset/rxinstaller.bin to install the MSET exploit via the Spider exploit.
*NAND Partitions Decryption/Injection
* If it worked, you'll see the bottom screen flash, and then the browser will appear to continue functioning normally.
*NAND FAT16 Xorpad Generation
* Press the home button, and after you see the Home Menu splash screen your DS will say An Error Occurred and ask you to reboot, but it's already done.
*System Titles Dumping
* You can then launch rxTools by going to Settings > Profile > DS Profile Settings.
*NAND Files Dumping/Injecting, for various hacks/mods
** Alternatively, you can install the MSET ROP with FBI.
*Much, much more
** Press select and use left and right on the D-pad to select rxTools3.x 4.x or rxTools3.x 6.x, depending on the version of MSET you are using.
* Note: Do not install 4.x MSET on a 2DS. Formatting in this configuration will cause a soft brick.


==rxMode==
==User guide==
===rxMode===
'''rxMode''' is probably the first free custom firmware for the Nintendo 3DS.
rxMode is a custom firmware/part of rxTools, bootable from the main menu:
Since it's part of rxTools, it is bootable from the main menu.
* It supports all Gateway emuNAND up to the latest version.
* It will boot in emuNAND in automatic, if it is present in your sdcard.​
* Note: To boot emuNAND 8.0 or higher, or to play newer games, you need​ slot0x25KeyX.bin in the root of your sdcard too, if you are on a sysNAND below 7.0.


===How it works :===
rxMode contains the following features:
It supports all Gateway emuNAND up to the latest version.
* '''Native Firm:'''
It will boot in emuNAND in automatic, if it is present in your sdcard.
** Full and free EmuNAND support, up to the latest version, 10.5, also on n3ds.
** Access to the eShop and to online playing (requires an updated emuNAND).
** Support for 100% of the games (newer ones will require emuNAND).
** Support for sysNAND, in case an emuNAND is not found.
** Signatures Checks disabled.
** Dynamic ram dumping (just for debug purpouses).
** RX-E/S string patch in settings.
** PastaMode, for Signatures Check free, but clean, sysNAND.
** Reboot patch, for using SSBB and MH4 on o3ds.
** Exceptions handler (just for debug purposes).
** AGB (GBA Virtual Console) Support, wip on n3ds.
** TWL (DSiWare/DS Cardriges) Support, wip on n3ds.
** Region free on both o3ds and n3ds.
* '''TWL Firm:'''
** Cartridge blacklist check disabled.
** Cartridge save type check disabled.
** DSi cartridge save file exploit check disabled.
** Nintendo logo check patch.
** SHA hashes check patched, always succeeds.
** Whitelist check disabled.
** Signatures Check disabled.
* '''AGB Firm:'''
** Signatures Check disabled.


'''Note:''' To boot emuNAND 8.0 or higher, or to play newer games, you need​
===FAQ===
'''slot0x25KeyX.bin''' in the root of your sdcard too, if you are on a sysNAND below 7.0.
'''Q. How do i know if i'm in sysNAND or emuNAND?'''


==Features :==
Check in System Settings, near the system version.


===NATIVE FIRM:​===
RX-S stays for sysNAND, while RX-E stays for emuNAND. Be sure to be in emuNAND before updating.


*Full and free EmuNAND support, up to the latest version, 10.5, also on n3ds!
'''Q. Does this boot roms or homebrews? Any plan?'''
*Access to the eShop and to online playing (requires an updated emuNAND)
*Support for 100% of the games (newer ones will require emuNAND)
*Support for sysNAND, in case an emuNAND is not found
*Signatures Checks disabled
*Dynamic ram dumping (just for debug purpouses)
*RX-E / S string patch in settings
*PastaMode, for Signatures Check free, but clean, sysNAND
*Reboot patch, for using SSBB and MH4 on o3ds
*Exceptions handler (just for debug purposes)
*AGB (GBA Virtual Console) Support, wip on n3ds
*TWL (DSiWare/DS Cardriges) Support, wip on n3ds
*Region free on both o3ds and n3ds


===TWL FIRM:===
Yes, 100% support.


*Cartridge blacklist check disabled
'''Q. Can i use flashcards with this?'''
*Cartridge save type check disabled
*DSi cartridge save file exploit check disabled
*Nintendo logo check patch
*SHA hashes check patched, always succeeds
*Whitelist check disabled
*Signatures Check disabled


===AGB FIRM:===
Sky3DS should work, no other will work.


*Signatures Check disabled
'''Q. Can i play GBA or DS/DSi games?'''


==FAQs:​==
Yes, in both emuNand and sysNand.


*How do i know if i'm in sysNAND or emuNAND?
The only issue is that to make those apps playable on emuNand you need to install them in sysNand too, or have your Nands linked.
**Check in System Settings, near the system version. RX-S stays for sysNAND, while RX-E stays for emuNAND. Be sure to be in emuNAND before updating.
*Does this boot roms or homebrews? Any plan?
**Yes, 100% support
*Can i use flashcards with this?
**Sky3DS should work, no other will work.
*Does it work on New3DS?
**No. I have no plans for it right now.
*Can i fill your mail/pm-box with silly questions?
**No you can't.
*Can i play GBA or DS/DSi games?
**Yes, in both emuNand and sysNand. The only issue is that to make those apps playable on emuNand you need to install them in sysNand too, or have your Nands linked.


== Current functionality ==
==Media==
=== General ===
'''SKY3DS with rxTools Emunand the newest 9.7.0-25E Play Eshop and 3d roms on 8.1.0-4E''' ([https://www.youtube.com/watch?v=DxWHuAcc6Po May liang]) <br>
* Support for Web Browser (SPIDER) entrypoint for Old 3DS (ver 4.1-9.2)
<youtube>DxWHuAcc6Po</youtube>
* Support for System Settings (MSET) entrypoint for Old 3DS (ver 4.1-4.5, 6.0-6.4, and 9.2 with MSET downgraded to 6.x)
 
* Support for System Settings (MSET) downgrading for Old 3DS
==Compatibility==
* Support for Ninjhax (Not Stable)
Support for:
* Hacking tools collection
* Web Browser (SPIDER) entrypoint for Old 3DS (ver 4.1-9.2).
=== rxMode ===
* System Settings (MSET) entrypoint for Old 3DS (ver 4.1-4.5, 6.0-6.4, and 9.2 with MSET downgraded to 6.x).
* Support for the latest emuNAND version on Old 3DS and New 3DS (you currently need key_0x16.bin and key_0x1B.bin for N3DS)
* System Settings (MSET) downgrading for Old 3DS.
* Support for sysNAND, in case an emuNAND is not found
* Ninjhax (Not Stable).
* Access to the eShop and to online playing (requires an updated emuNAND)
 
* Support for 100% of the games (newer ones will require emuNAND)
==Credits==
* Signatures Checks disabled, which should allow just homebrew, but the world is cruel...
* All the documentation on [http://3dbrew.org 3dbrew], and to all the devs who contributed.
* Support for installing FBI (a CIA Manager) in both emuNAND and sysNAND
* Roxas75, myself, as the creator of rxTools.
* Support for AGB (GBA Virtual Console) on both sysNAND and emuNAND on Old 3DS
* Gateway team, for their work.
* Support for TWL (DS/DSi cartridges and DSiWare) '''only on sysNAND'''
* Reisyukaku for New 3DS MSET.
* Dynamic RAM dumping (just for debug purposes)
* [https://github.com/archshift Archshift], who wrote some useful libs used in this project.
== Nightlies ==
* Many GBATemp users, who helped in the testing process.
Nightly builds of rxTools are a thing, again! :D [https://lavanoid.github.io/ https://lavanoid.github.io/]
* patois, who developed [https://github.com/patois/Brahma BRAHMA].
== How to build ==
* mid-kid and b1l1s, who developed [https://github.com/mid-kid/CakeHax CakeHax].
Requirements for Windows:
* Many other people who offered helped in private.
* git, clone this repository with the following command: ''git clone --recursive [https://github.com/roxas75/rxTools.git https://github.com/roxas75/rxTools.git]''
* [http://sourceforge.net/projects/devkitpro devkitPRO] with devkitARM option and suboptions installed
* [http://www.imagemagick.org ImageMagick]
* [https://www.python.org Python 2.7] non needed for build, only for auxiliary tools Requirements for GNU/Linux:
* [https://apps.ubuntu.com/cat/applications/git/ git], clone this repository with the following command: ''git clone --recursive [https://github.com/roxas75/rxTools.git https://github.com/roxas75/rxTools.git]''
* [http://3dbrew.org/wiki/Setting_up_Development_Environment devkitPRO and devkitARM] (follow the tutorial for Linux)
* [http://www.imagemagick.org ImageMagick] (on Debian/Ubuntu, [https://apps.ubuntu.com/cat/applications/imagemagick/ install it using apt]) In case make.exe fails with stack trace dump, install [http://gnuwin32.sourceforge.net GnuWin Make] and place it in path before devkitPRO/msys/bin If you get the ''make: Interrupt/Exception caught (code = 0xc00000fd, addr = 0x4227d3)'' error on Windows, look at your PATH and move any path with parenthesis to the end of it Requires ImageMagick &gt;= 6.8.9 - If you are using Ubuntu 14.04 or below, do not use the version in the official repositories, as it is outdated Just run '''make release''' and rxTools/sys directory should be generated in the '''release''' folder, along with all the other packets, then copy the contents of the release folder to the root of your SD card. Make sure that the path to rxTools doesn't include space (' ').
== Setting up rxTools ==
* If you have used a previous version, please delete SD:/rxTools, SD:/3ds/rxTools, and rxTools.dat, if present on your (m)SD card.
* Extract the rxTools folder from the release and place it into the root of your card.
* If you are using an Old 3DS or 2DS, ensure you have Python 2.7 installed on your PC and run /Tools/o3ds_cdn_firm.py. This should download 3 files into a folder named /firm. Copy this entire folder and place it into SD:/rxTools/.
* If you are using an New 3DS, ensure you have Python 2.7 installed on your PC and run /Tools/n3ds_cdn_firm.py. This should download 1 file into a folder named /firm. Copy this entire folder and place it into SD:/rxTools/. You also need the files key_0x16.bin (N3DS arm9bin decryption, 9.6+ keyX) and key_0x1B.bin (N3DS 9.6 NCCH keyX) on the root of your SD card.
* For use with the Homebrew Launcher, go into the ninjhax folder and copy the /rxTools folder to SD:/3ds/
== How to launch with Spider ==
rxTools ''now'' stores its code.bin in rxTools/sys/code.bin (formerly /rxTools.dat). To launch rxTools using the Spider exploit visit [https://dukesrg.github.io/?rxTools/sys/code.bin https://dukesrg.github.io/?rxTools/sys/code.bin] using the 3DS Internet Browser. (Requires ver 9.2 or older).
== How to install DS Profile (MSET) Exploit (requires MSET 6.x) ==
Upon building, there will be a folder called release/mset that contains the files rxinstaller.nds and rxinstaller.bin. Using a supported NDS flash cart, launch rxinstaller.nds to install the MSET exploit. Otherwise, on firmwares 9.2 or older, copy rxinstaller.bin (take it in release/mset/) to SD:/mset/, and visit [https://dukesrg.github.io/?mset/rxinstaller.bin https://dukesrg.github.io/?mset/rxinstaller.bin] to install the MSET exploit via the Spider exploit. If it worked, you'll see the bottom screen flash, and then the browser will appear to continue functioning normally. Press the home button, and after you see the Home Menu splash screen your DS will say &quot;an error occurred&quot; and ask you to reboot, but it's already done. You can then launch rxTools by going to Settings -&gt; Profile -&gt; DS Profile Settings. Alternatively, you can install the MSET ROP with FBI. Press select and use left and right on the D-pad to select &quot;rxTools3.x 4.x&quot; or &quot;rxTools3.x 6.x&quot;, depending on the version of MSET you are using.
* Do NOT install 4.x MSET on a 2ds. Formatting in this configuration will cause a soft brick!
== Credits ==
* All the documentation on [http://3dbrew.org http://3dbrew.org], and to all the devs who contributed
* Roxas75, myself, as the creator of rxTools
* Gateway team, for their work
* Reisyukaku for New 3DS MSET
* Archshift, who wrote some useful libs I used: [https://github.com/archshift https://github.com/archshift]
* Many GBATemp users, who helped in the testing process
* patois, who developed BRAHMA: [https://github.com/patois/Brahma https://github.com/patois/Brahma]
* mid-kid and b1l1s, who developed CakeHax: [https://github.com/mid-kid/CakeHax https://github.com/mid-kid/CakeHax]
* Steveice10, ApacheThunder and TuxSH for most TWL patches
* Many other people who helped me in private
* All the dudes who reversed and fucked up my project, who wasted their time on making useless keeping the sources private.


'''Support the original, not the imitation!'''
==External links==
* Official website - http://www.rxtools.net
* Official Twitter - https://twitter.com/RxTools
* GitHub - https://github.com/roxas75/rxTools
* GBAtemp - https://gbatemp.net/threads/release-rxtools-roxas75-3ds-toolkit-fw-2-0-9-2.382782

Latest revision as of 05:19, 6 May 2024

rxTools
Rxtools3.png
General
Authorroxas75
TypeSystem Tools
Version3.0-beta_2
LicenseGPL-2.0
Last Updated2016/02/09
Links
Download
Website
Source

rxTools is a collection of hacking tools for Nintendo 3DS/3DSXL/2DS, compatible with all the system versions from 4.1 to 9.2. rxMode is a free custom firmware which works through rxTools, not meant to replace any existing software, but based on personal work made public and easy for the end-user.

Originally created by Roxas75 and released in 2015. Shortly after the rxTools 2.6 release, Roxas75 announced his retirement from the rxTools project and has passed on the development of rxTools to the PastaCFW Team.

Features

  • rxMode, free 3DS custom firmware.
  • CTR Titles Decryption.
  • Title Keys Decryption.
  • Xorpad Generation.
  • NAND Dumping.
  • NAND Partitions Decryption/Injection.
  • NAND FAT16 Xorpad Generation.
  • System Titles Dumping.
  • NAND Files Dumping/Injecting, for various hacks/mods.
  • Much, much more.

Installation

Setting up rxTools:

  • If you have used a previous version, please delete SD:/rxTools, SD:/3ds/rxTools, and rxTools.dat, if present on your (m)SD card.
  • Extract the rxTools folder from the release and place it into the root of your card.
  • If you are using an Old 3DS or 2DS, ensure you have Python 2.7 installed on your PC and run /Tools/o3ds_cdn_firm.py.
    • This should download 3 files into a folder named /firm.
    • Copy this entire folder and place it into SD:/rxTools/.
  • If you are using an New 3DS, ensure you have Python 2.7 installed on your PC and run /Tools/n3ds_cdn_firm.py.
    • This should download 1 file into a folder named /firm.
    • Copy this entire folder and place it into SD:/rxTools/.
    • You also need the files key_0x16.bin (N3DS arm9bin decryption, 9.6+ keyX) and key_0x1B.bin (N3DS 9.6 NCCH keyX) on the root of your SD card.
  • For use with the Homebrew Launcher, go into the ninjhax folder and copy the /rxTools folder to SD:/3ds/

Launch with Spider (9.2 or older):

Install DS Profile (MSET) Exploit (MSET 6.x):

  • Upon building, there will be a folder called release/mset that contains the files rxinstaller.nds and rxinstaller.bin.
  • Using a supported NDS flash cart, launch rxinstaller.nds to install the MSET exploit.
  • If it worked, you'll see the bottom screen flash, and then the browser will appear to continue functioning normally.
  • Press the home button, and after you see the Home Menu splash screen your DS will say An Error Occurred and ask you to reboot, but it's already done.
  • You can then launch rxTools by going to Settings > Profile > DS Profile Settings.
    • Alternatively, you can install the MSET ROP with FBI.
    • Press select and use left and right on the D-pad to select rxTools3.x 4.x or rxTools3.x 6.x, depending on the version of MSET you are using.
  • Note: Do not install 4.x MSET on a 2DS. Formatting in this configuration will cause a soft brick.

User guide

rxMode

rxMode is a custom firmware/part of rxTools, bootable from the main menu:

  • It supports all Gateway emuNAND up to the latest version.
  • It will boot in emuNAND in automatic, if it is present in your sdcard.​
  • Note: To boot emuNAND 8.0 or higher, or to play newer games, you need​ slot0x25KeyX.bin in the root of your sdcard too, if you are on a sysNAND below 7.0.

rxMode contains the following features:

  • Native Firm:
    • Full and free EmuNAND support, up to the latest version, 10.5, also on n3ds.
    • Access to the eShop and to online playing (requires an updated emuNAND).
    • Support for 100% of the games (newer ones will require emuNAND).
    • Support for sysNAND, in case an emuNAND is not found.
    • Signatures Checks disabled.
    • Dynamic ram dumping (just for debug purpouses).
    • RX-E/S string patch in settings.
    • PastaMode, for Signatures Check free, but clean, sysNAND.
    • Reboot patch, for using SSBB and MH4 on o3ds.
    • Exceptions handler (just for debug purposes).
    • AGB (GBA Virtual Console) Support, wip on n3ds.
    • TWL (DSiWare/DS Cardriges) Support, wip on n3ds.
    • Region free on both o3ds and n3ds.
  • TWL Firm:
    • Cartridge blacklist check disabled.
    • Cartridge save type check disabled.
    • DSi cartridge save file exploit check disabled.
    • Nintendo logo check patch.
    • SHA hashes check patched, always succeeds.
    • Whitelist check disabled.
    • Signatures Check disabled.
  • AGB Firm:
    • Signatures Check disabled.

FAQ

Q. How do i know if i'm in sysNAND or emuNAND?

Check in System Settings, near the system version.

RX-S stays for sysNAND, while RX-E stays for emuNAND. Be sure to be in emuNAND before updating.

Q. Does this boot roms or homebrews? Any plan?

Yes, 100% support.

Q. Can i use flashcards with this?

Sky3DS should work, no other will work.

Q. Can i play GBA or DS/DSi games?

Yes, in both emuNand and sysNand.

The only issue is that to make those apps playable on emuNand you need to install them in sysNand too, or have your Nands linked.

Media

SKY3DS with rxTools Emunand the newest 9.7.0-25E Play Eshop and 3d roms on 8.1.0-4E (May liang)

Compatibility

Support for:

  • Web Browser (SPIDER) entrypoint for Old 3DS (ver 4.1-9.2).
  • System Settings (MSET) entrypoint for Old 3DS (ver 4.1-4.5, 6.0-6.4, and 9.2 with MSET downgraded to 6.x).
  • System Settings (MSET) downgrading for Old 3DS.
  • Ninjhax (Not Stable).

Credits

  • All the documentation on 3dbrew, and to all the devs who contributed.
  • Roxas75, myself, as the creator of rxTools.
  • Gateway team, for their work.
  • Reisyukaku for New 3DS MSET.
  • Archshift, who wrote some useful libs used in this project.
  • Many GBATemp users, who helped in the testing process.
  • patois, who developed BRAHMA.
  • mid-kid and b1l1s, who developed CakeHax.
  • Many other people who offered helped in private.

External links

Advertising: