# lumateam/luma3ds

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/lumateam-luma3ds).**

6,495 stars · 631 forks · C · GPL-3.0

## Links

- GitHub: https://github.com/LumaTeam/Luma3DS
- awesome-repositories: https://awesome-repositories.com/repository/lumateam-luma3ds.md

## Topics

`3ds` `custom-firmware` `homebrew` `nintendo-3ds`

## Description

Luma3DS is a custom firmware for the Nintendo 3DS that removes factory restrictions to enable the execution of unsigned homebrew and game modifications. It functions as a kernel-level system extension that hooks system calls to bypass hardware limitations and introduce new operating system capabilities.

The project serves as a homebrew payload loader, using boot-time mechanisms to launch third-party software and custom firmware versions. It also provides a game modding framework capable of patching executable code and intercepting file requests to load custom assets and modified data.

The environment includes a hardware debugging suite for pausing processes and inspecting memory, alongside tools for legacy graphics upscaling. It further covers system customization through module extensibility, runtime state management via an overlay menu, and memory injection for game plugins and cheats.

## Tags

### Operating Systems & Systems Programming

- [Homebrew Payload Loaders](https://awesome-repositories.com/f/operating-systems-systems-programming/homebrew-payload-loaders.md) — Implements a boot-time mechanism for launching third-party software and custom firmware versions.
- [Kernel-Level Hooking](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-level-hooking.md) — Hooks system calls at the kernel level to bypass hardware restrictions and introduce new operating system capabilities.
- [Binary Instruction Patching](https://awesome-repositories.com/f/operating-systems-systems-programming/binary-instruction-patching.md) — Implements binary patching during the loading process to disable software signatures and enable unsigned code execution.
- [Custom Firmware](https://awesome-repositories.com/f/operating-systems-systems-programming/custom-firmware.md) — Provides a modified operating system that removes factory restrictions to run unsigned homebrew and game modifications.
- [Custom Firmware Extensions](https://awesome-repositories.com/f/operating-systems-systems-programming/custom-firmware-extensions.md) — Extends operating system capabilities through the installation of custom firmware patches and system module replacements.
- [File System Operation Interception](https://awesome-repositories.com/f/operating-systems-systems-programming/file-system-operation-interception.md) — Captures and reroutes kernel-level file system requests to load custom assets from external storage.
- [Hardware Debugging Environments](https://awesome-repositories.com/f/operating-systems-systems-programming/hardware-debugging-environments.md) — Ships a suite of tools for pausing processes, inspecting memory, and attaching external debuggers to console software.
- [System Call Interposition](https://awesome-repositories.com/f/operating-systems-systems-programming/system-call-interposition.md) — Overwrites operating system system calls to modify application behavior and bypass restrictions. ([source](https://github.com/lumateam/luma3ds#readme))
- [Process and Memory Management](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/process-and-memory-management.md) — Manages the execution lifecycle of system modules to remove access restrictions. ([source](https://github.com/lumateam/luma3ds#readme))
- [Runtime Environment Managers](https://awesome-repositories.com/f/operating-systems-systems-programming/runtime-environment-managers.md) — Provides a runtime overlay menu to dynamically adjust settings and manage the console environment. ([source](https://github.com/lumateam/luma3ds#readme))
- [System Memory Inspection](https://awesome-repositories.com/f/operating-systems-systems-programming/system-memory-inspection.md) — Utilizes a server and overlay menu to analyze system memory banks during fatal system errors. ([source](https://github.com/lumateam/luma3ds#readme))

### Development Tools & Productivity

- [Homebrew Execution Environments](https://awesome-repositories.com/f/development-tools-productivity/debugging-profiling-testing/debugging-diagnostics/in-app-debugging-consoles/console-execution-debuggers/homebrew-execution-environments.md) — Provides the runtime environment necessary to execute unsigned community-made software and modifications on the console. ([source](https://github.com/lumateam/luma3ds#readme))
- [Console Software Debuggers](https://awesome-repositories.com/f/development-tools-productivity/console-software-debuggers.md) — Enables the use of memory inspectors and communication ports to analyze code and resolve crashes during execution.
- [Debugger Integrations](https://awesome-repositories.com/f/development-tools-productivity/debugger-integrations.md) — Exposes communication ports that allow external debuggers to attach to processes and inspect memory. ([source](https://github.com/lumateam/luma3ds#readme))

### Game Development

- [Game Modding Toolkits](https://awesome-repositories.com/f/game-development/game-modding-toolkits.md) — Provides a framework for applying memory patches and modifying game files to change gameplay and visuals.
- [Game Interaction Plugins](https://awesome-repositories.com/f/game-development/game-interaction-plugins.md) — Enables the application of plugins and language overrides to alter how games run and appear. ([source](https://github.com/lumateam/luma3ds#readme))
- [Runtime Execution Plugins](https://awesome-repositories.com/f/game-development/game-interaction-plugins/runtime-execution-plugins.md) — Executes custom code within running applications to modify behavior or bypass software crashes. ([source](https://github.com/lumateam/luma3ds#readme))
- [Game Memory Modifiers](https://awesome-repositories.com/f/game-development/game-memory-modifiers.md) — Injects modified values into active game memory to alter gameplay mechanics and variables. ([source](https://github.com/lumateam/luma3ds#readme))

### Software Engineering & Architecture

- [Game Binary Patching](https://awesome-repositories.com/f/software-engineering-architecture/game-binary-patching.md) — Patches game executable binaries during the loading process to enable functional changes and modding. ([source](https://github.com/lumateam/luma3ds#readme))

### System Administration & Monitoring

- [Firmware Payload Chainloaders](https://awesome-repositories.com/f/system-administration-monitoring/kernel-updaters/bootstrapping-chainloaders/firmware-payload-chainloaders.md) — Provides a specialized bootloader that sequentially loads unsigned firmware payloads into system memory during startup.
- [System Setting Configurations](https://awesome-repositories.com/f/system-administration-monitoring/system-setting-configurations.md) — Allows adjusting advanced system behavior through boot-time menus and configuration files. ([source](https://github.com/lumateam/luma3ds#readme))

### Part of an Awesome List

- [System Capability Extensions](https://awesome-repositories.com/f/awesome-lists/devtools/core-and-community-extensions/system-capability-extensions.md) — Supports the installation of user-provided patches and module replacements to extend system capabilities. ([source](https://github.com/lumateam/luma3ds#readme))

### Graphics & Multimedia

- [Game Graphics Upscalers](https://awesome-repositories.com/f/graphics-multimedia/game-graphics-upscalers.md) — Provides resolution upscaling and visual enhancements for legacy handheld games. ([source](https://github.com/lumateam/luma3ds#readme))

### Security & Cryptography

- [In-Memory Process Injection](https://awesome-repositories.com/f/security-cryptography/in-memory-process-injection.md) — Executes custom code and plugins by injecting logic directly into the memory space of active processes.
- [Hardware Debugging Interfaces](https://awesome-repositories.com/f/security-cryptography/security/infrastructure-and-hardware/embedded-and-hardware/hardware-debugging-interfaces.md) — Provides a stub for low-level diagnostic debugging and code analysis directly on the physical hardware. ([source](https://github.com/lumateam/luma3ds#readme))

### User Interface & Experience

- [System Debug Overlays](https://awesome-repositories.com/f/user-interface-experience/overlay-management/system-debug-overlays.md) — Maintains a high-priority visual interface for adjusting system settings and debugging without interrupting the active application.
