Help:Tools/UKMM: Difference between revisions - ZeldaMods (Breath of the Wild)

(3 intermediate revisions by 2 users not shown)

Line 8:

UKMM ('''UK'''ing '''M'''od '''M'''anager) is an updated mod manager for BotW. It is used to install and uninstall mods, and solves many mod conflicts. It was created to solve bugs that fundamentally couldn't be solved by BCML, due either to limitations in the Python programming language or early design choices in BCML.

==Why Use a Mod Manager?==

BotW contains about 17,000 archives in its standard form. When those archives are fully and completely decompressed and extracted, the game contains roughly 200,000 files. Most of those 200,000 files contain dozens, even hundreds, of parameters.

If a mod edits just one of those parameters, in one of those files, in one of those archives, then, without a mod manager, that mod will override every other mod that you have that contains that archive. Given that an archive may contain an average of several thousand parameters, you can see how often mods will conflict.

This isn’t even taking into account a special file that BotW has, called the RSTB. The RSTB contains data on almost every one of those 200,000 files, and so almost every mod needs to edit the RSTB. Most mods rely on a mod manager to edit the RSTB, so even if you don’t want to install more than one mod, the odds are still good that the mod you’re installing is assuming you’ll use a mod manager to make it work.

And to top it all off, even if the one mod you want to use includes its own RSTB? That RSTB was probably made automatically, using an outdated tool that generates bad edits for the RSTB. And nobody has ever fixed that tool, because UKMM contains a much more accurate tool for it, that everyone is using anyway.

BotW is not like other games. Manually installing mods is not a simple process for it, 99% of the time. You ''need'' a mod manager.

==BCML or UKMM?==

Line 17:

Line 28:

# It installs BNPs just like BCML does

# It's easier to install

# If you're using Cemu, or previously used BCML, it's much easier to set up

# It gives you more control over where your mods are deployed and how they're deployed there

# It doesn't force a remerge every single time you change anything. You can install 30 mods with UKMM and choose to only merge one time, at the very end, if you want. BCML would go through a long, full remerge process every single time, increasing the amount of time you spent not playing

Line 146:

Line 158:

|Deploy Layout

|Whether or not UKMM includes a personalized folder when it merges mods out

|Using with Atmosphere on a Switch or with the Atmosphere mod location for Switch emulators? ~~Atmosphere Layout~~. Otherwise, use ~~Emulator Mod Layout~~.

|Using with Atmosphere on a Switch or with the Atmosphere mod location for Switch emulators? Without Name. Otherwise, use With Name.

|-

|Auto Deploy

Line 195:

Line 207:

==Known Issues==

* Certain mods distributed as BNPs ~~are incompatible~~ with UKMM, due to how they were made. A fix is currently being worked on.

* Certain mods distributed as BNPs will not install with UKMM, due to how they were made. If you find one, please contact Ginger.

* Certain mods distributed as BNPs that add lots of the same thing very close to each other on the map may be missing some of those things. A fix is currently being worked on.

If you can provide in-depth support to the developers on how to cause any of these issues, please [https://discord.gg/vPzgy5S contact Ginger on the discord]. This would go a long way toward fixing them.

@@ Line 8: / Line 8: @@
 UKMM ('''UK'''ing '''M'''od '''M'''anager) is an updated mod manager for BotW. It is used to install and uninstall mods, and solves many mod conflicts. It was created to solve bugs that fundamentally couldn't be solved by BCML, due either to limitations in the Python programming language or early design choices in BCML.
+==Why Use a Mod Manager?==
+BotW contains about 17,000 archives in its standard form. When those archives are fully and completely decompressed and extracted, the game contains roughly 200,000 files. Most of those 200,000 files contain dozens, even hundreds, of parameters.
+If a mod edits just one of those parameters, in one of those files, in one of those archives, then, without a mod manager, that mod will override every other mod that you have that contains that archive. Given that an archive may contain an average of several thousand parameters, you can see how often mods will conflict.
+This isn’t even taking into account a special file that BotW has, called the RSTB. The RSTB contains data on almost every one of those 200,000 files, and so almost every mod needs to edit the RSTB. Most mods rely on a mod manager to edit the RSTB, so even if you don’t want to install more than one mod, the odds are still good that the mod you’re installing is assuming you’ll use a mod manager to make it work.
+And to top it all off, even if the one mod you want to use includes its own RSTB? That RSTB was probably made automatically, using an outdated tool that generates bad edits for the RSTB. And nobody has ever fixed that tool, because UKMM contains a much more accurate tool for it, that everyone is using anyway.
+BotW is not like other games. Manually installing mods is not a simple process for it, 99% of the time. You ''need'' a mod manager.
 ==BCML or UKMM?==
@@ Line 17: / Line 28: @@
 # It installs BNPs just like BCML does
 # It's easier to install
+# If you're using Cemu, or previously used BCML, it's much easier to set up
 # It gives you more control over where your mods are deployed and how they're deployed there
 # It doesn't force a remerge every single time you change anything. You can install 30 mods with UKMM and choose to only merge one time, at the very end, if you want. BCML would go through a long, full remerge process every single time, increasing the amount of time you spent not playing
@@ Line 146: / Line 158: @@
 |Deploy Layout
 |Whether or not UKMM includes a personalized folder when it merges mods out
-|Using with Atmosphere on a Switch or with the Atmosphere mod location for Switch emulators? Atmosphere Layout. Otherwise, use Emulator Mod Layout.
+|Using with Atmosphere on a Switch or with the Atmosphere mod location for Switch emulators? Without Name. Otherwise, use With Name.
 |-
 |Auto Deploy
@@ Line 195: / Line 207: @@
 ==Known Issues==
-* Certain mods distributed as BNPs are incompatible with UKMM, due to how they were made. A fix is currently being worked on.
+* Certain mods distributed as BNPs will not install with UKMM, due to how they were made. If you find one, please contact Ginger.
+* Certain mods distributed as BNPs that add lots of the same thing very close to each other on the map may be missing some of those things. A fix is currently being worked on.
 If you can provide in-depth support to the developers on how to cause any of these issues, please [https://discord.gg/vPzgy5S contact Ginger on the discord]. This would go a long way toward fixing them.