Patchwork: an on-console mod manager for BOTW & TOTK, with BCML package merging on the Switch
Hi all! I’ve released **Patchwork**, a homebrew mod manager for *Breath of the Wild* and *Tears of the Kingdom* that runs entirely on the Switch. No PC needed to find, install or manage mods.
**GitHub / download:** [https://github.com/TheRomeoAlfa/patchwork-nx](https://github.com/TheRomeoAlfa/patchwork-nx)
# What it does
* **Browse and search GameBanana** (and Waikuteru’s mods) with previews and descriptions * **One-press install** from zip, 7z and rar; it picks the right file for your game version and warns about mismatches * **Turn mods on/off without deleting them**, with a load order and warnings when two mods change the same files * **Keeps your own files safe**: anything already in `atmosphere/contents` is backed up and restored when a mod is turned off * **Add mods from anywhere**: SD card inbox folder, GameBanana mod number, or send a link from your phone by scanning a QR code * **Install save files** from GameBanana, with an automatic backup of your saves first * **Background add-ons**: turn sysmodules on/off, with an explanation when the mod loader crashes (the 010041544D530000 error)
# BCML packages, merged on the Switch
The part I’m most excited about: **BCML** `.bnp` **packages for BOTW are merged on the console**, the way BCML does on a PC. That covers packs, parameter files, game data, text, maps (with or without the DLC), drops, shops, actor info and the resource size table, in load order. It handles 376 of the 383 BCML packages on GameBanana; the rest use BCML 2’s old format.
To merge, it reads the game’s original files once: hold **L + R** while starting BOTW, which opens the Homebrew Menu with mods off, and launch Patchwork from there. The app walks you through it when needed.
I’ve confirmed packs, parameters, game data, maps with the DLC, text and drops working in-game, but not every package or combination, so please report anything that doesn’t merge correctly (with your mod list) on GitHub.
# Install
1. Download `patchwork.nro` from the release 2. Copy it to `sd:/switch/patchwork/patchwork.nro` 3. Launch from the Homebrew Menu (title takeover, holding R on a game, gives the most memory)
Requires Atmosphère.
# ⚠️ The usual warnings
Back up your saves and SD card, and don’t go online with Nintendo while modding. Mods can crash games, and running CFW online risks a ban. See the README for details.
It’s free and open source (GPL-3.0).