Ads keep us online. Without them, we wouldn't exist. We don't have paywalls or sell mods - we never will. But every month we have large bills and running ads is our only way to cover them. Please consider unblocking us. Thank you from GameBanana <3

BCML: BOTW Cross-Platform Mod Loader - A Modding Tool for The Legend of Zelda: Breath of the Wild (Switch)


v3.4.9 2mo
  • BugFix Fix single select mod option accumulation
  • BugFix Fix standalone RSTB generator
  • Improvement Update docs
v3.4.8 2mo BugFix Addition v3.4.7 2mo Improvement2 BugFix2 Addition Adjustment v3.4.6 2mo Addition BugFix v3.4.5 2mo BugFix3 Feature Addition Removal

A mod merger and manager for BOTW

1. A Mod Loader?

Why a mod loader for BOTW? Installing a mod is usually easy enough once you have a homebrewed console or a emulator. Is there a need for a special tool?

Yes. As soon as you start trying to install multiple mods, you will find complications. The BOTW game ROM is fundamentally structured for performance and storage use on a family console, without any support for modification. As such, files like the resource size table or TitleBG.pack will almost inevtiably begin to clash once you have more than a mod or two. Symptoms can include mods simply taking no effect, odd bugs, actors that don't load, hanging on the load screen, or complete crashing. BCML exists to resolve this problem. It identifies, isolates, and merges the changes made by each mod into a single modpack that just works.

2. Prerequisites

  • Windows 10 (7-8 might work but are not supported) or basically any modern Linux distribution
  • A legal, unpacked game dump of The Legend of Zelda: Breath of the Wild for Switch (version 1.6.0)
  • The latest x64 Visual C++ redistributable

3. Setup

There are two primary options for installing BCML. 

The best way is to install BCML from PyPI. For help with this, consult the video tutorial at the top of this page.

  1. Make sure you already have the latest x64 Visual C++ installed.
  2. Install Python 3.7 or 3.8 (64 bit), making sure to checl Add Python to PATH.
  3. Install BCML using pip in a Command Prompt: pip install bcml
  4. Run BCML using the command bcml or by making a shortcut to bcml.exe, which is located in Python's Scripts folder.
You can also install from source.

On first use, you will have to point BCML to the directories containing your unpacked base game and DLC files. The first run wizard will try to guide you.

4. Usage and Troubleshooting

For information on how to use BCML, watch the intro video above, see the Help dialog in-app, or read the documentation on the repo. For issues and troubleshooting, please check the in-app help and the official Troubleshooting page before commenting.

1-10 of 24
Go to page:
  • Racks_1 avatar
    Racks_1 Joined 3d ago
    3d 3d
    Can't download bcml it comes with errors when trying to

    EDIT: I am dumb I forgot to add to path when installing python

    URL to post:
  • Hello. I've recently started using mods. I've been trying to use this modloader for a while now, and I've looked at a lot of sites. However, there is no site that shows how to use it with the Switch itself. Is it possible to use this modloader with the Switch in the first place? If so, please tell me how. I'm sorry for my poor explanation. I'm Japanese and my English is not good enough, so I used a translation tool.

    URL to post:
  • PedottoTot avatar
    PedottoTot Joined 4mo ago
    224 points Ranked 60,391st
    3mo 3mo
    How exactly am I supposed to set up BCML for yuzu? In the "Welcome to BCML" page, where you choose all of the directories, I have switch mode enabled. But when I go to select the Base and Update directory, nothing works. The following methods are what I've tried:

    • Choosing the romfs folder in a mod.
    • Choosing the folder where I keep my .xci and .nsp files.
    • Moving the base and update files to a romfs folder in the mods folder.
    And yet, nothing has worked. What am I missing?
    Someone bad at video games
    URL to post:
  • Wolguene avatar
    Wolguene Joined 3mo ago
    Hey guys, 

    I get this error while launching the game with cemu only 

    Traceback (most recent call last):

      File "E:\Downloads\bcml-win64-bundle\Lib\site-packages\bcml\", line 31, in status_run

        data = func(*args, **kwargs)

      File "E:\Downloads\bcml-win64-bundle\Lib\site-packages\bcml\", line 462, in launch_cemu

        Popen(cemu_args, cwd=str(util.get_cemu_dir()))

      File "D:\obj\windows-release\37amd64_Release\msi_python\zip_amd64\", line 800, in __init__

      File "D:\obj\windows-release\37amd64_Release\msi_python\zip_amd64\", line 1207, in _execute_child

    OSError: [WinError 740] L’opération demandée nécessite une élévation

    Hmu if you have any ideas or need info
    Thanks :) 
    URL to post:
  • Does BCML not work with versions of the game other than the USA one? I can open the European version without mods just fine, but when I try to add mods (which worked on the USA version) it instantly crashes.
    URL to post:
  • pollock avatar
    pollock Joined 4mo ago
    using Cemu here and anytime I install any mod with this, Cemu crashes when starting the game. Any way to just not use this BCML system?
    URL to post:
  • ButtSavage avatar
    ButtSavage Joined 1y ago
    1,192 points Ranked 24,556th
    6 medals 1 rare
    • Returned 1000 times Medal icon
    • One month a member Medal icon
    • Returned 100 times Medal icon
    • 6 months a member Medal icon
    • 1 year a member Medal icon
    • Reached 1,000 Points Medal icon
    Can you make it so whenever I click on a mod in the list so it doesn't immediately scroll to the top?
    URL to post:
  • jekk avatar
    jekk Joined 5mo ago
    BCML does not recognize E:\atmosphere\contents\01007EF00011E000\romfs as the base+update directory but does count E:\atmosphere\contents\01007EF00011f001\romfs as the DLC 
    URL to post:
  • Ritaku avatar
    Ritaku Joined 5mo ago
    5mo 5mo
    Weird issue converting a DLC mod to .bnp, specifically "Better Link House"; the archive ends up with a 0-size AocMainField.pack. I have both the game and DLC dumped, BCML is pointed to them, and they're versions 1.6.0 (Main)/3.0 (DLC). This is for the Switch version.
    URL to post:
  • GrapeSpagheti avatar
    GrapeSpagheti Joined 5mo ago
    5mo 5mo
    whenever i open setup.exe after following all the other steps, it shows up on my desktop, and when i try to open it, it does nothing what do i do
    and even after that i cant uninstall the files cause for some reason something else is using it when its the only thing opened what do i do

    URL to post: