Help:Tools/BCML

From ZeldaMods (Breath of the Wild)
Jump to navigation Jump to search
BCML
Author(s) Nicene Nerd
Source code https://github.com/NiceneNerd/BCML
License GLPv3+
Written in Python
Platform support Cross-platform

BCML (Breath of the Wild Cross-platform Mod Loader) is a mod installer and merging tool for BotW mods. It can be used to install and uninstall mods by priority and merge conflicts in the RSTB, SARC (pack) files, or game texts.

Setup

-BCML requires Python [3.8.10] or [3.7.9], and the [x64 Visual C++ redistributable]. When you open the Python installer, there will be a checkbox that says Add Python to PATH. You MUST check this box, or else BCML can't be installed. From here, continue as normal, and install the x64 Visual C++ redistributable.

Usage

BCML GUI Interface - Old version 1.0

If installed by the setup executable, BCML can be launched from the Start Menu or desktop shortcut(s). If installed using pip, BCML can be launched with the bcml command for the CLI version or the bcml-gui command for the graphical version. [help] A desktop shortcut can also be made pointing to the executable in Python's Scripts directory.

The commands between the CLI and GUI version are the same, for more information about them, consult the readme on GitHub. A basic overview:

  • + (in the bottom right): Installs a mod. Note that BCML only supports graphic pack mods in ZIP, RAR, or 7z format, or BNP (BCML Nano Patch) format files.
  • Hamburger button (bottom left): Show sort handles, to drag and drop, which changes mod load order. Changes the load priority of a mod and then adjusts any RSTB, pack, or text merges as needed.
  • Circular Arrow (bottom left): Manually triggers a fresh merge of the RSTB, packs, and texts. Deletes old merged files and completely remakes them anew.
  • Export: Exports all installed mods as a single mod. Can export using different folder structures for use as a graphic pack, an SDCaffiine mod, or mlc file replacement.
  • Explore: GUI only, opens the folder where the selected mod is installed.

Known Issues

  • Certain game files are too complex for the basic merging logic, and custom logic will have to be written for them. Almost all mods made as of Oct 17, 2020 are currently supported, but future mods may not be.