Repolode
Submit
SebaaMG

SebaaMG/ns2jb-modloader

A RomFS and ExeFS mod loader for Nintendo Switch 2 that loads mods by Title ID from a microSD card through an ns2jb session.

View on GitHub
Stars
77
Forks
7
Open issues
0
Last commit
3 hours ago

What is it?

ns2jb-modloader lets Switch 2 owners load RomFS and ExeFS mods directly from a microSD card, organized by each game's 16-digit Title ID. Mods for several games can sit on the same card, and one installation covers all of them. Atmosphère-style contents folders can be dragged in as-is when the mods are compatible.

The loader runs from a PC and requires an existing ns2jb FS 4/4 session with RPC running. After the Switch 2 is set up, the PC script detects the active session and loads the mods from the card. Once it reports READY, the ns2jb host is closed, SmileBASIC is closed without restarting the console, and the modded games can be launched. The loader stays active until the console reboots.

Supported formats include RomFS replacements and new files, romfs.bin, exefs files, .stub, exefs.nsp, and IPS/IPS32 patches. Runtime cheats and plugins are not covered. The project is tested on regular microSD cards with firmware 23.0.1, and microSD Express support still needs hardware testing.

Key features

  • 01Loads RomFS and ExeFS mods by 16-digit Title ID from microSD.
  • 02Supports multiple games on one card with a single installation.
  • 03Accepts Atmosphère-style contents folders and IPS/IPS32 patches.
  • 04Detects the active ns2jb session automatically, with a manual run-dir option.
  • 05Runs on Linux, WSL, and Node.js 22+ on the PC side.

Use cases

  • Installing a Mario Kart World mod such as a 200cc change on a Switch 2.
  • Keeping mods for several Switch 2 games on a single microSD card.
  • Moving Atmosphère-style mod folders from a Switch 1 setup to Switch 2 when compatible.

Quick start

  1. 1

    Download and extract the ZIP from the releases page

  2. 2

    Copy the contents of sd-card-root/ to your SD card root and add mods under contents/<TITLE_ID>/

  3. 3

    With ns2jb FS 4/4 and RPC running, open a terminal in the ModLoader folder

    cd "/path/to/extracted/zip/ModLoader"
  4. 4

    Run the loader and wait for READY

    node load.cjs

Things to know

  • Requires an existing ns2jb FS 4/4 session with RPC running on Switch 2.
  • Runs on Linux/WSL with Node.js 22+, so native Windows is not listed as supported.
  • Licensed under GPL-2.0, a copyleft license.
  • Some older Switch 1 ExeFS mods need updates for games that moved from 32-bit to 64-bit.

Topics

#switch-2#modding#romfs#exefs#nintendo-switch#microsd

FAQ

What is ns2jb-modloader?
A RomFS and ExeFS mod loader for Nintendo Switch 2 that loads mods by Title ID from a microSD card through an ns2jb session. ns2jb-modloader lets Switch 2 owners load RomFS and ExeFS mods directly from a microSD card, organized by each game's 16-digit Title ID. Mods for several games can sit on the same card, and one installation covers all of them. Atmosphère-style contents folders can be dragged in as-is when the mods are compatible.
Is ns2jb-modloader free to use? What license does it have?
ns2jb-modloader is open source under the GPL-2.0 license. Check the license terms before using it in commercial products.
Is ns2jb-modloader still maintained?
Actively maintained. The last commit to ns2jb-modloader was on Nov 7, 2026.
What can I use ns2jb-modloader for?
Installing a Mario Kart World mod such as a 200cc change on a Switch 2. Keeping mods for several Switch 2 games on a single microSD card. Moving Atmosphère-style mod folders from a Switch 1 setup to Switch 2 when compatible.
How do I install ns2jb-modloader?
Download and extract the ZIP from the releases page Copy the contents of sd-card-root/ to your SD card root and add mods under contents/<TITLE_ID>/ With ns2jb FS 4/4 and RPC running, open a terminal in the ModLoader folder: cd "/path/to/extracted/zip/ModLoader" Run the loader and wait for READY: node load.cjs
Where can I get ns2jb-modloader?
The source code and installation instructions are on GitHub: https://github.com/SebaaMG/ns2jb-modloader

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects