What is KaiHEN
KaiHEN is a free and open source, semi-tethered homebrew enabler for the Nintendo Switch 2. It allows anyone to write their own games and applications ("homebrew") for the console without being subject to usual constraints.
Disclaimer
Piracy is not supported by KaiHEN. Please use KaiHEN to run only legitimate homebrew applications. Downloading or distributing pirated copies of software is illegal in most jurisdictions.
Fine, what do I need to run KaiHEN?
To run KaiHEN, you need a few things:
- SmileBASIC 4 (4.4.9/4.4.6 Demo) OR Sid Mier's Civilization VII (ONLY the Switch 1 version works, 1.0.0)
- Some consoles may exhibit a "Nag" after connecting to Nintendo servers recently
- This is why blocking servers preemptively is needed
- A console with the Nag cannot proceed
- Firmware 23.0.1 installed on your console
- 90DNS or other methods to block Nintendo servers
- A good, low latency internet connection
- A personal computer, Windows via WSL, Linux and macOS work.
- A microSD or microSD Express card
- A microSD Express card is reccomended as it is natively supported by the console and has faster transfer speeds
- Patience, as getting KaiHEN to run may require multiple attempts
How do I use KaiHEN with SmileBASIC 4
- Download Kurumuz NS2JB fork (not linked here)
- Download kaiHEN
- Enter the NS2JB directory in your terminal (in WSL you must use /mnt/{letter}/ to access a drive)
- Complete the one-time SmileBASIC 4 setup, by typing the contents of NS2JB's bootstrap.bas into SmileBASIC
- To do this, you must open the "Create a program" menu
- Then press -, and tap the Go to ERRORLINE button
- Type out the exploit (a USB Keyboard or autotyper helps a lot)
- Press - again
- Save the file as "NS2"
- Ensure node.js is installed
- Run "node hen.cjs --dir /path/to/extracted/kaihen"
- Restart SmileBASIC 4 and reopen the Make a program
- Type in
LOAD "TXT:NS2" - Hit enter and accept the prompts
- Follow the instructions printed by the script, selecting your IP if nessesary
- Wait until the script verifies that HEN has been started. If it has not been started, restart your console and follow the steps to re-run the exploit
Re-running KaiHEN with SmileBASIC 4
- Open SmileBASIC 4 and open the Create a program menu
- Type in
LOAD "TXT:NS2", accepting any prompts - Run the kaiHEN script as in the previous section
- Follow the instructions printed by the script, selecting your IP if nessesary
- Wait until the script verifies that HEN has been started. If it has not been started, restart your console and follow the steps to re-run the exploit
Preemtively Awnsered Questions (PAQ)
Q: Does this work on Firmware past 23.0.1 (like 23.5.0)?
A: No, KaiHEN requires Firmware 23.0.1. Past 23.5.0 patch out the chain used to load homebrew.
Q: Are other games usable on Firmware 23.0.1?
A: Yes, in theory. Balatro and various Artemis Engine games (like Seedsow lullaby) can be taken over, but this requires a save file bug. Thus, these are more useful as secondary entrypoints after a exploited save has been installed
Q: How do I make apps for KaiHEN?
A: Refer to our developer's guide
Q: How do I download X game for free?
A: Update to 23.5.0, go to the Nintendo eShop and pay for your games.
Q: What protections are there against malicious homebrew applications?
A: At the moment, few. Thus, please be cautious when using homebrew applications
Q: Where do I find trustworthy homebrew applications?
A: On the hblist