You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Lorenzo DellacĂ  884b4a4e4a removed exception dump parser, moved to new repo: 2 years ago
.github/ISSUE_TEMPLATE Update, etc 2 years ago
arm9 Merge commit 'bb07a7334f064c9512bd7e387dab1b9ef9e228cd' into 3gx-master 2 years ago
arm11 Current year is 2020 2 years ago
k11_extension fixed various build errors 2 years ago
sysmodules added "-lm" flag 2 years ago
.gitattributes Add .gitattributes, update README and issue template 2 years ago
.gitignore Merge commit 'bb07a7334f064c9512bd7e387dab1b9ef9e228cd' into 3gx-master 2 years ago
LICENSE.txt LICENSE update (GPLv3) 7 years ago
Makefile update gitignore and makefile 2 years ago Update 2 years ago

Luma3DS-3GX Plugin Edition

Noob-proof (N)3DS "Custom Firmware", with 3GX plugins support

3GX Plugin Edition

This edition of Luma3DS allows the loading of .3GX plugins in Luma3DS, which are otherwise officially unsupported.

How to install this Edition

  1. download the latest boot.firm from the releases page
  2. put the downloaded boot.firm file in the root directory of your SD card (sd:/boot.firm), overwriting the official Luma3DS boot.firm.
  3. (re)boot your 3DS, and when prompted, enable:
    • "Enable game patching"
    • "Show NAND or user string in System Settings"
  4. press START and let your 3DS boot.

You successfully installed the 3GX Plugin Loader! Now, proceed to the next step to learn how to install and enable 3GX plugins.

How to install 3GX plugins

Plugins have to be installed in the sd:/luma/plugins folder. Usually, you need to put your specific plugin in the <TITLEID> subdirectory, eg: sd:/luma/plugins/<TITLEID>/<filename>.3gx. However, a default.3gx plugin can also be placed in the main sd:/luma/plugins directory: sd:/luma/plugins/default.3gx.


    sd:/luma/plugins/default.3gx # will be loaded for all games, low priority
    sd:/luma/plugins/<TITLEID>/<filename>.3gx # will only be loaded for the specified title, high priority

Now you know how to install 3GX plugins! Proceed to the next step to learn how how to enable 3GX plugins.

How to enable 3GX plugins

  1. when booted, press L + D-Pad Down + Select to open the Rosalina menu.
  2. Press D-Pad Down again until Plugin Loader, is selected, then press A and set it to [Enabled].

Done! You learned to install the 3GX Plugin loader, install 3GX Plugins and enable them. Now, simply launch the game you want to play and press SELECT to open up the 3GX menu!

Luma3DS introduction

Luma3DS is a program to patch the system software of (New) Nintendo (2)3DS handheld consoles "on the fly", adding features such as per-game language settings, debugging capabilities for developers, and removing restrictions enforced by Nintendo such as the region lock.

It also allows you to run unauthorized ("homebrew") content by removing signature checks. To use it, you will need a console capable of running homebrew software on the Arm9 processor.

Since v8.0, Luma3DS has its own in-game menu, triggerable by L+Down+Select (see the release notes).


  1. Clone the repository with git clone

  2. Run make.

    The produced boot.firm is meant to be copied to the root of your SD card for usage with Boot9Strap.

Setup / Usage / Features





This software is licensed under the terms of the GPLv3. You can find a copy of the license in the LICENSE.txt file.

Files in the GDB stub are instead triple-licensed as MIT or "GPLv2 or any later version", in which case it's specified in the file header.