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).

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 - 3.9 (64 bit), making sure to check 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 36
1
Pages
Go to page:
  • Struckm4n avatar
    Struckm4n Joined 3y ago
    Offline
    790 points Ranked 48,177th
    7 medals 1 rare
    • Returned 1000 times Medal icon
    • Returned 100 times Medal icon
    • One month a member Medal icon
    • 6 months a member Medal icon
    • 1 year a member Medal icon
    • Thanked 5 submitters Medal icon
    4mo
    Traceback (most recent call last):

      File "D:\SwitchBCML\pkgs\bcml\_api.py", line 42, in status_run

        func(*args, **kwargs)

      File "D:\SwitchBCML\pkgs\bcml\_api.py", line 579, in update_bcml

        raise RuntimeError(result.stderr)

    RuntimeError: ERROR: Could not install packages due to an EnvironmentError: [WinError 5] Access is denied: 'd:\\switchbcml\\pkgs\\clr.pyd'

    Consider using the `--user` option or check the permissions.

    Bananite
    URL to post:
  • Dark link77 avatar
    Dark link77 Joined 8mo ago
    Offline
    44 points Ranked 102,075th
    4 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
    5mo
    Bonjour.
    J'ai install√© BCML sur mon pc mais lorsque j'installe des mods et que je les exporte pour les mettre sur ma switch quand je lance zelda le jeu crash. 
    Pourriez-vous me dire ce qui ne va pas.
    Merci d'avance.
    Le tout pour le tout
    URL to post:
  • WHI2004 avatar
    WHI2004 Joined 1y ago
    Offline
    5mo 5mo
    Hi. I need help resolving this issue, maybe someone knows how to solve this:

    This happens when i'm setting up BCML for the first time.

    Traceback (most recent call last):

      File "c:\users\mark\appdata\local\programs\python\python38\lib\site-packages\bcml\_api.py", line 33, in status_run

        data = func(*args, **kwargs)

      File "c:\users\mark\appdata\local\programs\python\python38\lib\site-packages\bcml\_api.py", line 85, in sanity_check

        util.sanity_check()

      File "c:\users\mark\appdata\local\programs\python\python38\lib\site-packages\bcml\util.py", line 490, in sanity_check

        get_game_dir()

      File "c:\users\mark\appdata\local\programs\python\python38\lib\site-packages\bcml\util.py", line 663, in get_game_dir

        raise FileNotFoundError(

    FileNotFoundError: The BOTW game dump directory has not been set or does not exist.


    Thanks.

    Bananite
    URL to post:
  • AnthSalmo avatar
    AnthSalmo Joined 4y ago
    Offline
    2,914 points Ranked 21,213rd
    9 medals 1 legendary 1 rare
    • Returned 5000 times Medal icon
    • 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
    7mo 7mo
    URL to post:
  • lefleur avatar
    lefleur Joined 12mo ago
    Offline
    7mo 7mo
    im so mad that it took 2 hours to get BCML to not working and then find out i need a full game dump on my pc. At that point only release this for WiiU, most people who hack their switches dont have beefy specs, they mostly have laptops. People who play on WiiU, 9/10 times, are playing on Cemu, with beefy specs. I don't know anybody, nor do I know of anybody who is willing to dump their entire game onto their laptops, get this working (which still is giving me a Microsoft C++ 14.0+ error) and load mods just to remove these mods 4 hours later. I've been putting mods into my switch for some time now, I've combined many mods, such as the Steve mod, infinite durability, hud tweaks, ALoT (a lot of tweaks) and many more mods. No glitches or complications like you say. Thats my insight. Keep up the good work with the mod though, a lot of people say its good. Sadly I don't have enough storage on my laptop to store a full game dump. 
    Bananite
    URL to post:
  • lefleur avatar
    lefleur Joined 12mo ago
    Offline
    7mo
    when I install BCML thru "pip install bcml" i get an error saying microsoft visual c++ 14+ is missing but I installed it. Is this because I only have the x64 version and not the x86? the bcml installation is still continuing though in my command prompt, please help me, thank you
    Bananite
    URL to post:
  • So I installed the bcml as said and it run successfully. I added the base file location and the dlc accordingly, but when I have to select language, it doesn't show any, which seem to blocking me to finish setting up as it is a required option to choose. Is there anything I missed? Please help.

    Permafrost
    URL to post:
  • I am using a Switch. I have used GameCard Installer to copy my games. How do I go about using BCML to add my mods? I'm not sure where to find the game along with the DLC. I'm pretty sure they are stored on the console.
    Bananite
    URL to post:
  • So, it was a pain in the ass to get this working in the first place, and now I find it won't simply let me merge mods together for use with Atmosphere; it requires the full game contents to be on my pc? So you're telling me that in order to use mods with my physical game cart using this mod manager, I have to rip a 14 GB game to my PC and keep the loose files there JUST so your program doesn't throw a fit? Why?! Why is this so popular?! Why do half the mods for this game come only in your proprietary format, when the ones that don't all work just fine? Just a huge nightmare to deal with altogether.
    • Win x 1
    Bananite
    URL to post:
  • FiskerK avatar
    FiskerK Joined 1y ago
    Offline
    6 medals 1 legendary 1 rare
    • Returned 5000 times Medal icon
    • 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
    10mo
    Hello, thanks for the great work.

    I have been using BCML for botw on Cemu for a whiles and everything works great.

    Now I am trying to make it work on my switch.
    I supplied BCML with all the needed files and "activating " the mods appears to be succesfull. But since Im using a hardware switch and not an emulator I could use some help as to what files to move to what folder.

    I understand I need to put some files in SD:/ atmosphere/contents/01007EF0001E000/romfs/
    but I am unsure of structure and what files to put here.

    hope someone can help.
    Bananite
    URL to post: