Breath of the Wild is an extremely complex game, and as such a number of things can potentially go wrong when installing and merging mods, or even just setting up BCML. This page catalogues the most common problems when using BCML and what you can do about them.
I installed BCML using the Windows installer and don't know how to open it.
Though BCML's installer does not offer a desktop shortcut, it does create a Start Menu shortcut. Open your Start Menu and search for BCML to launch it.
I'm doing a PIP install, but
pip is not recognized as a command.
This usually means that Python has not been correctly added to your PATH. You can solve that here:
The Cemu settings file could not be found.
You have set your Cemu directory in the BCML settings incorrectly. The exact folder you put into BCML must be the one that contains
"The Cemu update directory could not be found" or "The Cemu aoc directory could not be found."
This usually indicates either that your game dump and/or Cemu directory is set incorrectly, or it could mean that your update data or DLC data is not installed in the correct location for Cemu. The exact location of each folder will be determined by the Cemu MLC folder and by the title ID of your game. BCML supports both the old Cemu MLC layout (pre-1.15.11c) and the new one (1.15.11c+). The exact pattern BCML uses is hard to summarize, but here's an example:
If BCML is searching for
TitleBG.pack, and you have the North American version of BOTW, it will check the following locations in order (though, obviously, the search through DLC files will be irrelevant for
- Update data (new MLC):
- Update data (old MLC):
- Base game:
- For the DLC (new MLC):
- For the DLC (old MLC):
In order to find your game's title ID, BCML will go up one folder from game dump directory (e.g. from
BOTW/) and then check
Mod Installation Problems
FileNotFoundError: No rules.txt was found in MOD.
This one is as it says. BCML didn't find a
rules.txt file in the mod you picked. BCML only supports either graphic pack mods or BNPs. Other formats will need to be converted first.
ValueError: Invalid version: 1-wiiu (expected 1-3).
The mod you are trying to install contains a BYML file (often
ActorInfo.product.sbyml) that has been corrupted by an outdated BYML tool.
There was an error installing MOD. It processed successfully, but could not be added to your BCML mods.
If the full text of the error includes anything about XML, you probably either (1) have an old version of Cemu or (2) have a corrupt Cemu settings file. Make sure you have at least Cemu 1.15, and if you still have issues, try deleting
settings.xml from the Cemu folder.
BCML hangs forever at "Enabling installed mods in Cemu".
The cause of this bug is unknown, and reinstalling Cemu is the only known fix.
FileNotFoundError: [WinError 2] The system cannot find the file specified.
Check if the rest of the error text says anything about
wszst_yaz0. If so, your problem is probably that you are running 32 bit Python, but BCML requires 64 bit Python.
Any time you have any problem with one or more mods in-game after installing them through BCML, the first thing you should try is using the Remerge button.
Cemu crashes immediately after compiling shaders.
This indicates a problem with a bootup file, generally either
Bootup.pack itself, a file within it, or one of the
Bootup_XXxx.pack message packs containing game texts. First thing to try is to Remerge. If that doesn't solve it, it could be a problem with any mod that affects game texts or
Bootup.pack, so you can try investigating those.
I installed the Linkle mod, and it kind of works, but Linkle looks mixed with Link.
This is usually a problem of mod priority. Try setting the Linkle mod to a higher priority than other mods that affect
TitleBG.pack or armours. If you have already done so, try using Remerge. If it still doesn't work, it could be a more complicated problem with your mod configuration; consider clearing your mods and starting fresh.