A mod manager for The Legend of Zelda: Breath of the Wild
Project description
BCML: BOTW Cross-Platform Mod Loader
A mod merging and managing tool for The Legend of Zelda: Breath of the Wild
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 three ways to install BCML.
PyPI
Install Python 3.7+ (64 bit version), then run pip install bcml
. Note that
3.8 is only supported on Linux. Windows users need to use 3.7 until
Python.NET is updated with wheels for
3.8.
Windows Installer
Download the setup executable from the latest GitHub release or from GameBanana. Double click to run and install BCML. Note: It is highly recommended that you do not use "Install for all users."
Building from Source
Building from source requires, in addition to the general prerequisites:
- Python 3.7+ 64 bit
- Node.js 14
- The following Python packages:
- aamp>=1.4.1
- byml>=2.3.1
- oead>=1.1.1
- pywebview~=3.2
- pyYaml~=5.3.1
- requests~=2.23.0
- rstb>=1.2.0
- setuptools~=46.4.0
- xxhash~=1.4.3
- wheel~=0.34.2
To build from source, you will first need to prepare the webpack bundle. Enter
the bcml/assets
folder, run npm install
to collect dependencies, and then
run npm build
or npm test
.
Finally, back at the root folder, you can install using
python setup.py install
. You can also run without installing by using python -m bcml
.
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
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.
License
This software is licensed under the terms of the GNU General Public License, version 3 or later.
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 lightly modified copy 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://gitlab.com/jkcclemens/msyt. The
only change is a replacement of serde_yaml
with serde_json
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.