Luminger has published Balatro Switch RCE, a research project targeting the physical Nintendo Switch 1 edition of Balatro. According to its documentation, the project has been tested on both an original Nintendo Switch and a Nintendo Switch 2, with the latter running the game through backward compatibility.
The central finding is that specially prepared save data can change what the game executes when it starts. Instead of entering Balatro’s normal interface, the title loads a standalone launcher containing tools for inspecting and scripting the game’s process.
How the Technique Works
Balatro uses the LÖVE framework, which loads Lua scripts to initialize and run the game. The repository explains that LÖVE’s filesystem gives save data priority over the game’s bundled filesystem when matching filenames are present.
The project takes advantage of that behavior by placing replacement startup scripts inside the save. When Balatro launches, those files take precedence over the original scripts, allowing the research launcher to run.
According to the developer, this does not require modifying the cartridge, replacing the game’s bundled files or installing a custom title update. The payload is carried inside the save data itself.
What Has Been Tested?
The README reports hardware testing with the physical Switch 1 cartridge on both Switch generations. It identifies two supported Balatro patch levels:
1.0.1f, identified as the cartridge’s stock patch level.
1.0.1o, identified in the repository as the latest Balatro patch.
These are game versions, not Nintendo Switch system firmware versions. The README does not provide a system firmware compatibility list, so these results should not be presented as confirmation that every firmware is supported.
The documentation also distinguishes the Switch 1 game running through backward compatibility from a separate native Switch 2 binary. The current implementation uses information specific to the supported Switch 1 game images; those values cannot simply be applied to a different executable.
How It Runs on Switch 2
The documented Switch 2 method begins with a modified Switch 1, where the launcher save is prepared using a save manager. Nintendo’s official transfer functionality then carries that save to the Switch 2.
Once the physical Switch 1 edition of Balatro is launched on the Switch 2, the replacement scripts load from the transferred save.
The target Switch 2 does not require custom firmware for the demonstrated method. However, the documented preparation still relies on access to a modified Switch 1. This is an important requirement for readers evaluating what the release actually offers.
What the Launcher Provides
The launcher includes a full-screen status interface showing build information, startup events and network status. It also provides a network-accessible Lua REPL, allowing researchers to evaluate Lua code inside the title’s process.
An integrated FTP server provides access to the launcher’s own files. Researchers can inspect or replace those files without restoring the entire save for every change.
The project also records diagnostic information in save data, including network connections, commands and file transfers. These features make it a tool for research and instrumentation rather than a replacement gaming interface.
Is This a Full Switch 2 Jailbreak?
No. The project explicitly describes userland execution inside Balatro’s process.
The README states that it does not provide kernel access, system-module execution, backup loading or a Nintendo DRM bypass. It cannot run commercial games.
The confirmed result is narrower: the project demonstrates that a prepared save can cause the supported game to execute researcher-controlled code, including when that game runs on Switch 2 through backward compatibility.
That distinction matters when reporting the news. The repository documents a working research entry point within a game, without claiming complete control of the console’s operating system.
Important Limitations
Luminger describes the release as a proof of concept, not a finished product. Restoring the launcher save replaces the existing Balatro save, and the launcher takes the place of normal gameplay.
The documentation also warns that its network services are unauthenticated and unencrypted. Additionally, the developer notes that using the software may violate Nintendo’s terms of service and could result in a console ban.
For the homebrew research community, the notable finding is the save-data loading behavior and its demonstrated transfer to Switch 2. Any further capabilities would require separate evidence; the current repository does not establish a complete jailbreak or broader system access.
Official source: Luminger — Balatro Switch RCE on GitHub
