BCML: BOTW Cross-Platform Mod Loader
A mod merging and managing tool for The Legend of Zelda: Breath of the Wild
Purpose
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?
1
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 inevitably 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.
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) or
Wii U (version 1.5.0)
• The latest x64 Visual C++ redistributable
• Cemu (optional)
Setup
There are two main ways to install BCML.
PyPI
Install Python 3.7+ (64 bit version), making sure to add it to your PATH, and then run pip install
bcml. Note that, because of the cefpython3 dependency, on Windows Python 3.9 is not supported.
Building from Source
Building from source requires, in addition to the general prerequisites:
• Python 3.7+ 64 bit
(Note: 3.9+ will not work on Windows until cefpython3 is updated.)
• Node.js v14
Steps to build from source:
1. Install Python requirements
1. Open terminal to repo root folder
2. Run pip install -r requirements.txt
2. Prepare the webpack bundle
1. Open terminal to bcml/assets
2. Run npm install
3. Run npm run build (or npm run test to watch while editing)
3. Build the docs
1. Open terminal to repo root folder
2. Run mkdocs build -d bcml/assets/help
4. Install BCML with python setup.py install or run without installing with python -m bcml
Note that on Linux, you can simply run bootstrap.sh to perform these steps automatically unless you would
like more control.
2
Usage and Troubleshooting
For information on how to use BCML, see the Help dialog in-app or read the documentation on the repo.
For issues and troubleshooting, please check the official Troubleshooting page.
Contributing
• Issues: https://github.com/NiceneNerd/BCML/issues
• Source: https://github.com/NiceneNerd/BCML
BOTW is an immensely complex game, and there are a number of new mergers that could be written. If you
find an aspect of the game that can be complicated by mod conflicts, but BCML doesn’t yet handle it, feel
free to try writing a merger for it and submitting a PR.
Python and JSX code for BCML is subject to formatting standards. Python should be formatted with Black.
JSX should be formatted with Prettier, using the following settings:
{
"prettier.arrowParens": "avoid",
"prettier.jsxBracketSameLine": true,
"prettier.printWidth": 88,
"prettier.tabWidth": 4,
"prettier.trailingComma": "none"
}
License
This software is licensed under the terms of the GNU General Public License, version 3 or later. The source
is publicly available on GitHub.
This software includes the 7-Zip console application 7z.exe and the library 7z.dll, which are licensed
under the GNU Lesser General Public License. The source code for this application is available for free at
https://www.7-zip.org/download.html.
This software includes a fork of the console application msyt.exe by Kyle Clemens, copyrighted 2018 under
the MIT License. The source code for this application is available for free at https://github.com/NiceneNer
d/msyt/tree/bcml.
This software includes part of a modified copy of the pywebview Python package, copyright 2020 Roman
Sirokov under the BSD-3-Clause License. The source code for the original library is available for free at
https://github.com/r0x0r/pywebview.
3
BCML: Breath of the Wild Cemu Mod Loader
Con este programa, puedes instalar fácilmente mods de zelda. (Emulado en PC).
Después de iniciar el programa, debes especificar dónde está el juego.
Asegúrate de mostrar la ruta de acceso a la carpeta de contenido.
Para instalar el mod, debes hacer clic en el botón Instalar y seleccionar el archivo
descargado.
¡Listo!
Acerca de este mod
BCML es un instalador y fusionador de mods para The Legend of Zelda: Breath of the Wild,
compatible con las versiones de Wii U y Switch. Es compatible con los mods de reemplazo
de archivos de paquetes gráficos (para Cemu 1.15+) y su propio formato, BCML Nano
Patch (BNP).
¿Un cargador de mods?
¿Por qué un cargador de mods para BOTW? Instalar un mod suele ser bastante fácil una
vez que tienes una consola casera o un emulador. ¿Es necesaria una herramienta
especial?
Sí. Tan pronto como comiences a intentar instalar múltiples mods, encontrarás
complicaciones. La ROM del juego BOTW está estructurada fundamentalmente para el
rendimiento y el uso de almacenamiento en una consola familiar, sin ningún soporte para
modificaciones. Como tal, archivos como la resource size table o TitleBG.pack comenzarán
a chocar casi inevitablemente una vez que tengas más de uno o dos mods. Los síntomas
pueden incluir mods que simplemente no surten efecto, errores extraños, actores que no
se cargan, que se cuelgan en la pantalla de carga o bloqueos completos. BCML existe
para resolver este problema. Identifica, aísla y fusiona los cambios realizados por cada
mod en un solo modpack que simplemente funciona.
Prerrequisitos
• Windows 10 (7-8 pueden funcionar, pero no son compatibles) o básicamente cualquier
distribución moderna de Linux.
• Un volcado de juego legal y desempaquetado de The Legend of Zelda: Breath of the
Wild para Switch (versión 1.6.0).
• El último Visual C++ redistributable x64.
Configuración
Hay dos opciones principales para instalar BCML.
La mejor manera es instalar BCML desde PyPI. Para obtener ayuda con esto, consulte el
video tutorial en la parte superior de esta página.
1. Asegúrese de que ya tiene instalada la versión más reciente de Visual C++ x64.
2. Instale Python 3.7 o 3.8 (64 bits), asegurándose de marcar Add Python to PATH.
3. Instale BCML usando pip en símbolo del sistema Command Prompt: pip install bcml.
4. Ejecute BCML usando el comando o haciendo un acceso directo a bcml.exe, que se
encuentra en la carpeta de Python's folder.bcml Scripts.
También puede instalar desde el código fuente.
En el primer uso, tendrás que apuntar BCML a los directorios que contienen tu juego base
desempaquetado y los archivos DLC. El asistente de la primera ejecución intentará guiarte.
Uso y solución de problemas
Para obtener información sobre cómo usar BCML, vea el vídeo de introducción anterior,
consulte el cuadro de diálogo Ayuda en la aplicación o lea la documentación on the repo.
Para problemas y solución de problemas, consulte la ayuda de la aplicación y la página
oficial de Troubleshooting antes de comentar.
Mods que requieren este archivo
Nombre del mod:
- First Real 3D Face in Zelda Breath of the Wild (Matschaak Mod Link Replacement).
- No Fall Damage.
- Powerful Better Master Sword (OP Mod).
- RemoteBombs No Cooldown.
- Second Wind. (Usar la última versión).
- Stasis No Cooldown.
