A mod merger and manager for BOTW

1. A Mod Loader?

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?

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 inevtiably 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.

2. 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)
The latest x64 Visual C++ redistributable

3. Setup

There are two primary options for installing BCML.

The best way is to install BCML from PyPI. For help with this, consult the video tutorial at the top of this page.

Make sure you already have the latest x64 Visual C++ installed.
Install Python 3.7 - 3.9 (64 bit), making sure to check Add Python to PATH.
Install BCML using pip in a Command Prompt: pip install bcml
Run BCML using the command bcml or by making a shortcut to bcml.exe, which is located in Python's Scripts folder.

You can also install from source.

On first use, you will have to point BCML to the directories containing your unpacked base game and DLC files. The first run wizard will try to guide you.

4. Usage and Troubleshooting

For information on how to use BCML, watch the intro video above, see the Help dialog in-app, or read the documentation on the repo. For issues and troubleshooting, please check the in-app help and the official Troubleshooting page before commenting.

1-10 of 36

Pages

Go to page:

Struckm4n Joined 3y ago

Offline
790 points Ranked 48,177th

7 medals 1 rare
Struckm4n

4mo
Traceback (most recent call last):

File "D:\SwitchBCML\pkgs\bcml\_api.py", line 42, in status_run

func(*args, **kwargs)

File "D:\SwitchBCML\pkgs\bcml\_api.py", line 579, in update_bcml

raise RuntimeError(result.stderr)

RuntimeError: ERROR: Could not install packages due to an EnvironmentError: [WinError 5] Access is denied: 'd:\\switchbcml\\pkgs\\clr.pyd'

Consider using the `--user` option or check the permissions.

Bananite

URL to post:
Dark link77 Joined 8mo ago

Offline
44 points Ranked 102,075th

4 medals 1 rare
Dark link77

5mo
Bonjour.
J'ai installé BCML sur mon pc mais lorsque j'installe des mods et que je les exporte pour les mettre sur ma switch quand je lance zelda le jeu crash.
Pourriez-vous me dire ce qui ne va pas.
Merci d'avance.
Le tout pour le tout

URL to post:
WHI2004 Joined 1y ago

Offline
48 points

4 medals
WHI2004

5mo 5mo
Hi. I need help resolving this issue, maybe someone knows how to solve this:

This happens when i'm setting up BCML for the first time.

Traceback (most recent call last):

File "c:\users\mark\appdata\local\programs\python\python38\lib\site-packages\bcml\_api.py", line 33, in status_run

data = func(*args, **kwargs)

File "c:\users\mark\appdata\local\programs\python\python38\lib\site-packages\bcml\_api.py", line 85, in sanity_check

util.sanity_check()

File "c:\users\mark\appdata\local\programs\python\python38\lib\site-packages\bcml\util.py", line 490, in sanity_check

get_game_dir()

File "c:\users\mark\appdata\local\programs\python\python38\lib\site-packages\bcml\util.py", line 663, in get_game_dir

raise FileNotFoundError(

FileNotFoundError: The BOTW game dump directory has not been set or does not exist.

Thanks.

Bananite

URL to post:
AnthSalmo Joined 4y ago

Offline
2,914 points Ranked 21,213rd

9 medals 1 legendary 1 rare
AnthSalmo

7mo 7mo
I tried to merge some mods for switch with bnp format. Zelda's Ballad & More (With a Standalone version) (this works if its is alone with the rar version), Zelda's Ballad - Amiibo Outfits (Switch), and Zelda's Ballad - Helm Pack (Switch).However, they didnt work on my swith, just the basic model and icons change. Could you tell me how should I install it.?
Bananite
URL to post:
lefleur Joined 12mo ago

Offline
14 points

1 medal
lefleur

7mo 7mo
im so mad that it took 2 hours to get BCML to not working and then find out i need a full game dump on my pc. At that point only release this for WiiU, most people who hack their switches dont have beefy specs, they mostly have laptops. People who play on WiiU, 9/10 times, are playing on Cemu, with beefy specs. I don't know anybody, nor do I know of anybody who is willing to dump their entire game onto their laptops, get this working (which still is giving me a Microsoft C++ 14.0+ error) and load mods just to remove these mods 4 hours later. I've been putting mods into my switch for some time now, I've combined many mods, such as the Steve mod, infinite durability, hud tweaks, ALoT (a lot of tweaks) and many more mods. No glitches or complications like you say. Thats my insight. Keep up the good work with the mod though, a lot of people say its good. Sadly I don't have enough storage on my laptop to store a full game dump.
Bananite

URL to post:
lefleur Joined 12mo ago

Offline
14 points

1 medal
lefleur

7mo
when I install BCML thru "pip install bcml" i get an error saying microsoft visual c++ 14+ is missing but I installed it. Is this because I only have the x64 version and not the x86? the bcml installation is still continuing though in my command prompt, please help me, thank you
Bananite

URL to post:
Winters_Grace Joined 7mo ago

Offline

9 points

Winters_Grace

7mo

So I installed the bcml as said and it run successfully. I added the base file location and the dlc accordingly, but when I have to select language, it doesn't show any, which seem to blocking me to finish setting up as it is a required option to choose. Is there anything I missed? Please help.

Permafrost

URL to post:
MattHamby Joined 2y ago

Offline
52 points

4 medals
MattHamby

7mo
I am using a Switch. I have used GameCard Installer to copy my games. How do I go about using BCML to add my mods? I'm not sure where to find the game along with the DLC. I'm pretty sure they are stored on the console.
Bananite

URL to post:
hawkmint Joined 8mo ago

Offline
9 points

2 medals
hawkmint

8mo
So, it was a pain in the ass to get this working in the first place, and now I find it won't simply let me merge mods together for use with Atmosphere; it requires the full game contents to be on my pc? So you're telling me that in order to use mods with my physical game cart using this mod manager, I have to rip a 14 GB game to my PC and keep the loose files there JUST so your program doesn't throw a fit? Why?! Why is this so popular?! Why do half the mods for this game come only in your proprietary format, when the ones that don't all work just fine? Just a huge nightmare to deal with altogether.
- Win x 1
Bananite
URL to post:
FiskerK Joined 1y ago

Offline
56 points

6 medals 1 legendary 1 rare
FiskerK

10mo
Hello, thanks for the great work.

I have been using BCML for botw on Cemu for a whiles and everything works great.

Now I am trying to make it work on my switch.
I supplied BCML with all the needed files and "activating " the mods appears to be succesfull. But since Im using a hardware switch and not an emulator I could use some help as to what files to move to what folder.

I understand I need to put some files in SD:/ atmosphere/contents/01007EF0001E000/romfs/
but I am unsure of structure and what files to put here.

hope someone can help.
Bananite

URL to post: