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 (WiiU)


v3.7.1 6d
  • Improvement Restore the sane and sensible folder browser (Windows)
  • BugFix Fix for areadata merging
  • BugFix Fix permission error ( Linux, #212) - @tam1m
  • BugFix Fix for conversion of mods with options - @Nitr4m12
  • Amendment Removed .bphyssb from excluded platform converter extensions - @Nitr4m12
v3.7.0 24d Addition3 Improvement3 Refactor Amendment BugFix2 v3.6.2 2mo BugFix v3.6.1 2mo BugFix v3.6.0 2mo Feature Improvement3 BugFix

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 Wii U (version 1.5.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.

21-30 of 367
Go to page:
  • N8endo avatar
    N8endo Joined 3y ago
    40 points Ranked 3,894th
    19 medals 4 rare
    • Returned 1000 times Medal icon
    • 10 submissions featured Medal icon
    • Submitted 15 Mods Medal icon
    • Submitted 20 Mods Medal icon
    • One month a member Medal icon
    • 6 months a member Medal icon
    What is the export bug that was fixed?  I've been using the export function for months and didn't notice anything wrong.  Should I remake and re-export everything?
    URL to post:
  • End Thus I Am avatar
    End Thus I Am Joined 3y ago
    665 points Ranked 47,677th
    I don't see it, what's the method to updating? Just click modify after unzipping?
    URL to post:
  • Coughy avatar
    Coughy Joined 3mo ago
    I'm trying to install Bcml but everytime I run the pip command I get this error message
    ERROR: Could not install packages due to an OSError: [Errno 2] No such file or directory: 'C:\\Users\\___\\AppData\\Local\\Packages\\PythonSoftwareFoundation.Python.3.8_qbz5n2kfra8p0\\LocalCache\\local-packages\\Python38\\site-packages\\botw_havok\\classes\\common\\'
    URL to post:
  • 3mo 3mo
    I keep getting this error, please help
    Thanks in advance.

    Edit: was able to get working but now i get this other error

    C:\Users\___\Downloads\ROMs\CEMU\BOTW\bcml-getting-started-stuff\BCML-3.4.9>C:\Users\____\AppData\Local\Programs\Python\Python39\Scripts\mkdocs.exe build -d bcml/assets/help

    ←[31mERROR    -  ←[0mConfig value: 'theme'. Error: Unrecognised theme name: 'material'. The available installed themes are:

                readthedocs, mkdocs

    Aborted with 1 Configuration Errors!

    i like monke hehe funni
    URL to post:
  • None of my mods are working, I downloaded them and when I open the game in CEMU my game is still the same
    URL to post:
  • Yasuuuuuu avatar
    Yasuuuuuu Joined 3mo ago
    3 medals 1 legendary 1 rare
    • Returned 5000 times Medal icon
    • Returned 1000 times Medal icon
    • Returned 100 times Medal icon
    The file I need to download cannot be found, the file with Visual Studio and Python yes, but not the BCML file.
    URL to post:
  • emoanimedream avatar
    emoanimedream Joined 4y ago
    720 points Ranked 46,831st
    I got error trying to running Bcml. I got an error message instead of bcml running

    URL to post:
  • I hate how the way to download it is Horrid I rather use Graphic Packs than this It can't even download cause it doesn't load up at Python Which is considered Very Useless

    URL to post:
  • Does this mean I can have switch mods on Cemu?
    URL to post:
  • Is there any way to create a shortcut that can be pinned to the windows start menu? I tried creating a batch file to run the bcml command but it doesn't work. I'm assuming the batch file cannot activate python related commands but I don't know.
    URL to post: