LowLevel/Luma3DS-3GX
Archived
1
0
Fork 0
Code Issues Pull Requests Releases 2 Wiki Activity
Luma3DS firmware, patched to enable support for 3GX plugins.
This repository has been archived on 2022-05-31. You can view files and clone it, but cannot push or open issues or pull requests.
1,458 Commits 3 Branches 68 Tags 9.6 MiB
C 96.7%
Assembly 1.6%
Makefile 1.3%
C++ 0.4%
8233d4e226
Go to file
Léo Lam 8233d4e226 loader: Add support for BPS patches 
The BPS format allows distributing patches that are smaller and that do
not contain copyrighted content if data is relocated
(unlike non-trivial IPS patches).

This is essential for games such as Majora's Mask 3D that have three
barely different code revisions. Supporting all three versions would
demand an unreasonable amount of work; with BPS patches only one
version has to be supported.

The patcher is written in C++ in order to make it possible to share the
implementation with Citra and because a C version would be a lot more
ugly and tedious to write. The patcher is non-intrusive for the rest of
the codebase and self-contained so hopefully that isn't an issue.

This adds roughly ~0x500 bytes of code to the loader sysmodule.
Code looks reasonably optimised (in IDA). Tested and works on an o3DS.
2019-12-21 18:32:18 +01:00
.github/ISSUE_TEMPLATE Fix bug-report.md name 2019-06-28 20:12:44 +02:00
arm9 Properly create BLX instruction 2019-06-29 15:22:33 +01:00
arm11 Fix #1232 2019-03-23 23:14:23 +01:00
exception_dump_parser Do the same for arm9 exceptions 2019-03-15 23:03:18 +01:00
k11_extension fix build with newer gcc 2019-06-16 23:20:40 +02:00
sysmodules loader: Add support for BPS patches 2019-12-21 18:32:18 +01:00
.gitignore Merge remote-tracking branch 'upstream/master' 2018-01-06 12:29:08 +03:00
LICENSE.txt LICENSE update (GPLv3) 2015-08-14 22:47:21 -04:00
Makefile Fix some of the bugs 2019-03-15 23:03:24 +01:00
README.md Relicense gdbstub (with permission of contributors) 2019-05-03 21:06:10 +02:00

README.md

Luma3DS

Noob-proof (N)3DS "Custom Firmware"

What it is

Luma3DS is a program to patch the system software of (New) Nintendo 3DS handheld consoles "on the fly", adding features (such as per-game language settings and 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. We recommend Plailect's guide for details on how to get your system ready.

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

Compiling

First you need to clone the repository with: git clone https://github.com/AuroraWright/Luma3DS.git
To compile, you'll need a recent commit of makerom added to your PATH. You'll also need to install firmtool, its README contains installation instructions. You'll also need to update your libctru and devkitARM installation to their latest releases. Then, run make. The produced file is called boot.firm and is meant to be copied to the root of your SD card, for usage with boot9strap.

Setup / Usage / Features

See https://github.com/AuroraWright/Luma3DS/wiki

Credits

See https://github.com/AuroraWright/Luma3DS/wiki/Credits

Licensing

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 double-licensed as MIT or "GPLv2 or any later version", in which case it is specified in the file header.