/rxTools

rxTools

Primary LanguageCGNU General Public License v2.0GPL-2.0

rxTools - Roxas75 3DS Toolkit

Join the chat at https://gitter.im/roxas75/rxTools

Official twitter account

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.

Current functionality

General

  • Support for Web Browser (SPIDER) entrypoint for Old 3DS (ver 4.1-9.2)
  • 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
  • Support for Ninjhax (Not Stable)
  • Hacking tools collection

rxMode

  • Support for the latest emuNAND version on Old 3DS and New 3DS (you currently need key_0x16.bin and key_0x1B.bin for N3DS)
  • Support for sysNAND, in case an emuNAND is not found
  • Access to the eShop and to online playing (requires an updated emuNAND)
  • Support for 100% of the games (newer ones will require emuNAND)
  • Signatures Checks disabled, which should allow just homebrew, but the world is cruel...
  • Support for installing FBI (a CIA Manager) in both emuNAND and sysNAND
  • Support for AGB (GBA Virtual Console) on both sysNAND and emuNAND on Old 3DS
  • Support for TWL (DS/DSi cartridges and DSiWare) only on sysNAND
  • Dynamic RAM dumping (just for debug purposes)

Nightlies

Nightly builds of rxTools are a thing, again! :D https://lavanoid.github.io/

How to build

Requirements for Windows:

Requirements for GNU/Linux:

In case make.exe fails with stack trace dump, install 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 >= 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 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 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 "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.

  • 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, 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
  • Many GBATemp users, who helped in the testing process
  • patois, who developed BRAHMA: https://github.com/patois/Brahma
  • mid-kid and b1l1s, who developed 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

##License ###rxTools Copyright (C) 2015 The PASTA Team

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

See LICENSE for the details.

###CakeHax The Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.

See CakeHax/LICENSE.txt for the details.

###CakesROP CakesROP is licensed by zoogie, mid-kid, bilis, and Reisyukaku under the BSD 2-clause license.

See CakesROP/LICENSE for the details.

###PolarSSL Copyright (C) 2006-2010, Brainspark B.V.

The program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation

The program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

See LICENSE for the details.

###JSMN Copyright (c) 2010 Serge A. Zaitsev

The software is licensed under MIT License.

See LICENSE_JSMN for the details.

Support the original, not the imitation!