Repolode
SebaaMG

SebaaMG/ns2jb-modloader

面向 Switch 2 的 RomFS 与 ExeFS 模组加载器,通过 ns2jb 会话从 microSD 卡按 Title ID 加载模组。

Star
77
Fork
7
未关闭 Issue
0
最近提交
3小时前

这是什么?

ns2jb-modloader 让 Switch 2 用户可以直接从 microSD 卡加载 RomFS 和 ExeFS 模组。模组按游戏的 16 位 Title ID 存放在卡上的对应目录中,同一张卡可以同时放置多个游戏的模组,一次安装即可覆盖所有游戏。若模组兼容,Atmosphère 格式的 contents 目录也可以直接拖入使用。

加载器在 PC 上运行,需要已有的 ns2jb FS 4/4 会话并开启 RPC。脚本会自动检测当前会话并从存储卡加载模组,显示 READY 后关闭 ns2jb 主机与 SmileBASIC,无需重启主机即可启动已安装模组的游戏。加载器会一直有效,直到主机重启。

支持的格式包括 RomFS 替换与新增文件、romfs.bin、exefs 文件、.stub、exefs.nsp 以及 IPS/IPS32 补丁,但不包括运行时作弊码和插件。项目在 firmware 23.0.1 的普通 microSD 卡上测试通过,microSD Express 仍需实机验证。

核心功能

  • 01从 microSD 卡按 16 位 Title ID 加载 RomFS 与 ExeFS 模组。
  • 02同一张卡可容纳多个游戏的模组,一次安装即可全部生效。
  • 03兼容 Atmosphère 格式的 contents 目录以及 IPS/IPS32 补丁。
  • 04自动检测当前 ns2jb 会话,也可手动指定运行目录。
  • 05PC 端支持 Linux、WSL 与 Node.js 22 及以上版本。

适用场景

  • 在 Switch 2 上安装《马力欧赛车 世界》的 200cc 等模组。
  • 把多款 Switch 2 游戏的模组集中保存在同一张 microSD 卡上。
  • 在兼容的前提下,将 Atmosphère 格式的模组目录从 Switch 1 迁移到 Switch 2。

快速上手

  1. 1

    从发布页面下载并解压 ZIP 文件

  2. 2

    将 sd-card-root/ 的内容复制到 SD 卡根目录,并将模组添加到 contents/<TITLE_ID>/ 下

  3. 3

    在 ns2jb FS 4/4 和 RPC 运行时,在 ModLoader 文件夹中打开终端

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

    运行加载器并等待显示 READY

    node load.cjs

使用前须知

  • 需要先在 Switch 2 上运行已有的 ns2jb FS 4/4 会话并开启 RPC。
  • 仅支持 Linux/WSL 并需要 Node.js 22+,README 未列出原生 Windows 支持。
  • 采用 GPL-2.0 许可证,属于 Copyleft 许可。
  • 部分较早的 Switch 1 ExeFS 模组需要为从 32 位迁移到 64 位的游戏进行更新。

标签

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

常见问题

ns2jb-modloader 是什么?
面向 Switch 2 的 RomFS 与 ExeFS 模组加载器,通过 ns2jb 会话从 microSD 卡按 Title ID 加载模组。 ns2jb-modloader 让 Switch 2 用户可以直接从 microSD 卡加载 RomFS 和 ExeFS 模组。模组按游戏的 16 位 Title ID 存放在卡上的对应目录中,同一张卡可以同时放置多个游戏的模组,一次安装即可覆盖所有游戏。若模组兼容,Atmosphère 格式的 contents 目录也可以直接拖入使用。
ns2jb-modloader 可以免费使用吗?用的什么许可证?
ns2jb-modloader 以 GPL-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
ns2jb-modloader 还在维护吗?
活跃维护中。ns2jb-modloader 最近一次提交是在 2026年11月7日。
ns2jb-modloader 适合用来做什么?
在 Switch 2 上安装《马力欧赛车 世界》的 200cc 等模组。 把多款 Switch 2 游戏的模组集中保存在同一张 microSD 卡上。 在兼容的前提下,将 Atmosphère 格式的模组目录从 Switch 1 迁移到 Switch 2。
ns2jb-modloader 怎么安装和运行?
从发布页面下载并解压 ZIP 文件 将 sd-card-root/ 的内容复制到 SD 卡根目录,并将模组添加到 contents/<TITLE_ID>/ 下 在 ns2jb FS 4/4 和 RPC 运行时,在 ModLoader 文件夹中打开终端: cd "/path/to/extracted/zip/ModLoader" 运行加载器并等待显示 READY: node load.cjs
在哪里获取 ns2jb-modloader?
源代码和安装说明在 GitHub 上:https://github.com/SebaaMG/ns2jb-modloader

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目