Friday, November 21, 2014

Setup for 3DS Homebrew

Well, it's finally here!  The 3DS homebrew scene is live and ready to start.  With everything out in the open, I thought I'd do a quick tutorial on how to install everything to your 3DS, and what you can and can't do with it.

Setting up your 3DS

The first thing you will need is a 3DS (duh), an SD Card, internet access on your 3DS, and the game "Cubic Ninja".  This can either be a physical cartridge, or the version off of the Nintendo eShop (Japan only) [This has been taken down as of now].  Once you have this, go to the main menu of Cubic Ninja, select "Create", then select "QR code", and finally select "Scan QR Code".  This should open up a view from your 3DS' camera, and allow you to scan a QR code with it.

Once there, go to http://www.smealum.net/ninjhax/ and select your 3DS version, click submit, and it should present you with a nice QR code you can scan.  Scan this with your 3DS and you should see a screen like this pop up:


Don't forget to make sure that your 3DS has an internet connection as well to download part of the exploit.  Now you can choose to either run a homebrew application, or install it to the save file of the game.  This allows you to not have to worry about using the QR code in the future or needing an internet connection, so I highly recommend doing this, as it can be uninstalled later if you so choose.  Once this is done, you are all set and can begin using homebrew applications!

Running Homebrew

To run homebrew applications, you simply need to put the a boot.3dsx file on the root directory of your SD card, and then when you launch NinjHax, it will run your application.  My recommendation is to download a homebrew launcher and just leave that as the file, so that you can launch other homebrew applications with it.  It's a pretty simple process, but if you have questions, feel free to post them below.

To add other homebrew applications to the homebrew launcher, simply create a folder called "3ds", and place folders contain the boot.3dsx files of homebrew applications within there.  If you wish to make icons for your games, simply place them in an application's directory as "icon.bin" files.  You can use the SMDH tool included with devkitPro to make them, or look into my application over at https://github.com/gemisis/SMDH-Creator (Windows only).

When it comes to what you can run, please be aware that this does NOT run pirated games.  It ONLY runs homebrew applications.  We do NOT support piracy and will NOT be adding support in.

Deleting Homebrew

Should you ever wish to delete the homebrew save file on Cubic Ninja, all you have to do is hold L+R+X+Y on the main menu, and it will prompt you to delete the game's save data.  Click yes, and poof!  All of the homebrew stuff will be gone.  This can also be used to update the launcher in the future, as you can just delete it, and then reinstall it.

Creating Homebrew

Creating homebrew is a bit trickier, and requires knowledge of C.  As of right now, most of the tools are available from https://www.github.com/smealum/ctrulib.  There is also a quick install tutorial there, though I may add one on here in the future if a need arrives.  Using the libraries is a topic for another post, so I'll try to go over making a simple application at another time.

I hope this all seems pretty straight forward!  If you have can questions or comments, post them below!  Happy homebrewing!