Help:Tools/BCML: Difference between revisions

Update really old information
No edit summary
(Update really old information)
Line 11: Line 11:
==Setup==
==Setup==
-BCML requires Python [[https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe 3.8.10]] or [<nowiki/>[[3.7.9https://www.python.org/ftp/python/3.7.9/python-3.7.9-amd64.exe|3.7.9]]], and the [[https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads#section-2 x64 Visual C++ redistributable]]. When you open the Python installer, there will be a checkbox that says <code>Add Python to PATH</code>. You MUST check this box, or else BCML can't be installed. From here, continue as normal, and install the x64 Visual C++ redistributable.
-BCML requires Python [[https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe 3.8.10]] or [<nowiki/>[[3.7.9https://www.python.org/ftp/python/3.7.9/python-3.7.9-amd64.exe|3.7.9]]], and the [[https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads#section-2 x64 Visual C++ redistributable]]. When you open the Python installer, there will be a checkbox that says <code>Add Python to PATH</code>. You MUST check this box, or else BCML can't be installed. From here, continue as normal, and install the x64 Visual C++ redistributable.
-Open a command prompt anywhere (if you don't know how, just type <code>cmd<code/> into Windows Search). Run <code>pip install bcml<code/> (in normal cmd, NOT the python console). You should see a bunch of progress bars, and then a success message.


==Usage==
==Usage==
[[File:BCML GUI Preview.png|thumb|right|BCML GUI Interface - Old version 1.0]]
[[File:BCML GUI Preview.png|thumb|right|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 <code>pip</code>, BCML can be launched with the <code>bcml</code> command for the CLI version or the <code>bcml-gui</code> command for the graphical version. {{CLI help}} A desktop shortcut can also be made pointing to the executable in Python's <code>Scripts</code> directory.
-Next, we'll create a shortcut for BCML. Search Python in Windows search, then right click and hit <code>Open file location<code/> on <code>IDLE (Python 3.8 64-bit)<code/>. Right click the shortcut it opens to, and click <code>Open file location<code/> again. This should bring you to <code>pythonw.exe<code/>. Right click the exe and hit <code>Create Shortcut<code/>. Right click the shortcut you created, hit <code>Properties<code/>, then add <code> -m bcml<code/> to the end of the text in the first box. Rename the shortcut to <code>BCML<code/>, then drag it onto the taskbar to pin it. Now, you can use this shortcut to launch BCML.


The commands between the CLI and GUI version are the same, for more information about them, consult the [https://github.com/NiceneNerd/BCML/blob/master/docs/README.md readme on GitHub]. A basic overview:
For more information about the UI, consult the [https://github.com/NiceneNerd/BCML/blob/master/docs/README.md 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 ('''B'''CML '''N'''ano '''P'''atch) format files.
*'''+''' (in the bottom right): Installs a mod. Note that BCML only supports graphic pack mods in ZIP, RAR, or 7z format, or BNP ('''B'''CML '''N'''ano '''P'''atch) 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.
*'''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.
*'''Circular Arrow''' (bottom left): Remakes all merged mod files. Use this as a first option when you run into mod conflicts.
*'''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.
*'''Export''': Exports all installed mods as a single mod. The exported zip file will be in a graphics pack format, or Atmosphere format (if in Switch mode)
*'''Explore''': GUI only, opens the folder where the selected mod is installed.
*'''Explore''': Opens the folder where the selected mod is installed.


==Known Issues==
==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.
*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.
autopatrol
55

edits