Skip to content

Troubleshooting

Jump to bottom
Caleb Smith edited this page Nov 18, 2019 · 11 revisions

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.

Setup Problems

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: https://lmgtfy.com/?q=add+python+to+path

Error: 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 Cemu.exe and settings.xml.

Error: 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 TitleBG.pack):

  1. Update data (new MLC): MLC_FOLDER/usr/title/0005000E/101C9400/content/Pack/TitleBG.pack
  2. Update data (old MLC): MLC_FOLDER/usr/title/00050000/101C9400/content/Pack/TitleBG.pack
  3. Base game: GAME_DUMP_FOLDER/Pack/TitleBG.pack
  4. For the DLC (new MLC): MLC_FOLDER/usr/title/0005000C/101C9400/content/0010/Pack/TitleBG.pack
  5. For the DLC (old MLC): MLC_FOLDER/usr/title/00050000/101C9400/aoc/content/0010/Pack/TitleBG.pack

In order to find your game's title ID, BCML will go up one folder from game dump directory (e.g. from BOTW/content to BOTW/) and then check code/app.xml.

For more information on how BCML locates game content, see the source code for util.py, especially the sections starting here and here.

Clone this wiki locally