3DS:Game modification

Luma3DS game patching

Luma3DS allows for the modification of a game or application without having to patch the original files. This is done by redirecting the application's file calls to a separate location containing the modified files. Because no original game files are actually being modified, this makes distribution/installation of ROM hacks simple, and even works with game cartridges. Files must be placed in a /luma/titles/<Title ID>/ folder, with the Title ID of the title being modified. Luma3DS's game patching supports the following files:

External code.bin and exheader.bin loading

Patched code.bin and exheader.bin files can be loaded. Compressed .code files will not work with this feature, it must be uncompressed into a code.bin.

IPS patching

IPS patches for code.bin are also supported, which contain only the changes to the original code rather than the entire code.bin. Patches should be named code.ips and placed instead of a patched code.bin.

LayeredFS

Files within a game or applications romfs folder can redirected by placing modified files within /luma/titles/<Title ID>/romfs.

Locale Emulation

Locale Emulation can be used to launch a title with different region settings than the system. Although Luma3DS allows for any region game to be launched, some games may crash if the system region settings are not supported. Luma3DS can use alternate locale information from a locale.txt file placed in the /<Title ID>/ folder for a title. Follow 3DS:Setting game locales for more detailed instructions.

ROM hacks

ROM hacks are game mods that work by modifying or adding to a games files to change or add new content. ROM hacks can be made for a variety of different reasons, from making a game harder, adding new levels, translating the game to a different language, texture packs, randomization, and much more. Most ROM hacks on 3DS are distributed as unpacked files, and applied using Luma3DS's layeredfs. You can find some ROM hacks on their individual game pages; see a full list at, or use the search feature.

Patching using layeredfs

Some hacks have additional files and instructions to follow that aren't covered here. Always refer to the hacks installation instructions/README if available.

Download a ROM hack
Copy the files to your SD card:
- If the files contain a /luma/ folder, copy it to the root of your SD card merging when asked
- If the files contain a /<Title ID>/ (16 character long) folder, copy it to /luma/titles/
- If the files contain /romfs/, code.bin or code.ips; create a new folder in /luma/titles/ and rename it to the Title ID of the game. Copy the /romfs/, code.bin or code.ips to the /luma/titles/<Title ID>/ folder you just made
  - You can get the game's title ID from here (cartridges), here (digital games), or from the FBI -> Titles menu. For example the Title ID for Pokémon X is 0004000000055D00, so modified Pokémon X files would be placed at /luma/titles/0004000000055D00/.
Insert your SD card into your console
While holding SELECT, power on your console to enter the Luma3DS configuration menu
Turn on Enable game patching if it is not already enabled
Press START to save and exit

Your title should now be patched using layeredfs.

Plugins

Plugins are add-ons that run with a game. Plugins generally come in two types, 3GX or PLG. 3GX plugins run using Luma3DS's built in plugin loader, while PLG plugins can be run using BootNTR. 3GX plugins are usually newer and should generally be used if given a choice. A large collection of PLG plugins can be found in the MegaNTR collection here or you can browse for Plugins on gamebrew

Cheat codes

Cheat codes, or Action Replay codes, are instructions to edit memory addresses that allow for games behavior and values to be edited. These can be used in a variety of ways, from invincibility, max currency, unlocking items, and more. The two main ways to use cheats are from Luma3DS's Rosalina menu, or CTRPluginFramework's Action Replay. Using cheats with CTRPluginFramework, or a dedicated cheat plugin for the game you want to play will usually be more compatible.

Rosalina menu cheats

To use cheats with Rosalina menu:

Place cheat files in plain text at either /cheats/<Title ID>.txt or /luma/titles/<Title ID>/cheats.txt
- Cheat files can be generated using Checkpoint, or downloaded from the Sharkive repository.
Open the Rosalina menu (L+D-Pad down+SELECT by default)
Select cheats...
Press A on any cheats you want activated
Press B until you exit the Rosalina menu

CTRPluginFramework Action Replay

To use cheats with CTRPluginFramework:

Install the latest version of CTRPluginFramework-BlankTemplate (the .3gx file) using the instructions here
Place cheat files in plain text at either /cheats/<Title ID>.txt or in the same folder as the .3gx plugin as cheats.txt
- A repository of compiled cheat codes can be found here
- Or create your own cheats; a list of all code types supported by Action Replay can be found here
Open the Rosalina menu (L+D-Pad down+SELECT by default)
Press A on Plugin Loader: to enable it
Press B until you exit the Rosalina menu
launch your game of choice
- The screen should flash another color to indicate that the plugin has successfully loaded
- it will say Plugin ready! on the top screen when it is loaded
Press SELECT to open the plugin menu
Tap on Action Replay
Select the Action Replay codes you want to use
Press SELECT to exit the plugin menu

Save editors

WIP

ROM editors

WIP

External links

Luma3DS/wiki/Optional-features
List of Rom Hacks from gamebrew
save editor 3DS applications from gamebrew