Help:Tools/UKMM - Revision history

Ginger: Remove DAR from the list of incompatible mods, since it’s compatible as of 3.6

2026-04-24T19:59:47Z

Remove DAR from the list of incompatible mods, since it’s compatible as of 3.6

← Older revision		Revision as of 19:59, 24 April 2026
Line 212:		Line 212:

	==== What are the exceptions, for when I should use BCML instead? ====		==== What are the exceptions, for when I should use BCML instead? ====
	~~# You're using Dark Army Resurrection~~
	# You're using the online multiplayer mod		# You're using the online multiplayer mod
	This list is not exhaustive, but it ''almost'' is. There's very few other real reasons to use BCML, after 2024 when UKMM surpassed it.		This list is not exhaustive, but it ''almost'' is. There's very few other real reasons to use BCML, after 2024 when UKMM surpassed it.

Ginger: /* Okay. WHY do I need to use a mod manager? */ Rewrite with more casual language, so the average person can understand

2026-04-14T23:14:50Z

Okay. WHY do I need to use a mod manager?: Rewrite with more casual language, so the average person can understand

← Older revision		Revision as of 23:14, 14 April 2026
Line 190:		Line 190:

	==== Okay. WHY do I need to use a mod manager? ====		==== Okay. WHY do I need to 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~~.		In other games, mods are generally not file replacements, they're a series of standalone instruction sets that tells the game (or a patching library, like BepInEx or Reloaded) how to change what to use.

	~~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~~.		BotW doesn't have anything like that. It needs to have all the files and code merged and in order before you even boot your console/emulator, because the best we can do for those is replace archives.

	~~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.		Now, BotW contains almost all of its data in archives and registry files.

	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~~.		When those archives are fully and completely decompressed and extracted, each one contains anymore from about a dozen, to a few thousand files. Most of those files contain dozens, even hundreds, of parameters. If a mod edits just one of those parameters, it will override every other mod that contains one of the other 12-2000 files. Plus, a lot of mods edit the game's most important archives: the ones loaded at bootup and in the title screen's background. So if you take any random two mods, they'll ''probably'' conflict with each other.

			The registry files are single files that contain a ton of data about other files. You know that meme about the different Spidermans (Spidermen?) all pointing at each other? The registry files are basically like that. If they're not all agreeing on everything (aka they don't all have the same data) then things can get real buggy.

			And ''then'', as if it's not complicated enough already, there's a special file that BotW has, called the RSTB. The RSTB contains data on almost every one of the other files in the entire game, 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 you only want to use one mod? It may not edit everything it needs to. The mod author might have assumed you'd be using a mod manager that would automate some of the process, and not actually changed everything they needed to, meaning you might not get the entire mod, even if you use only one.

			So... yeah. It's complicated. It's a mess. We do our best, but BotW modding is really just a gigantic ball of chaos held together with string and chewing gum. The mod managers help keep it all together.

	=== UKMM vs. BCML Questions ===		=== UKMM vs. BCML Questions ===

Ginger: /* Prebuilt program */ Point back to official repo now that everything has been merged back into it

2026-04-14T22:56:20Z

Prebuilt program: Point back to official repo now that everything has been merged back into it

← Older revision		Revision as of 22:56, 14 April 2026
Line 13:		Line 13:
	Unlike BCML, installing UKMM is simple		Unlike BCML, installing UKMM is simple

	# Download the executable archive for your system from [https://github.com/~~GingerAvalanche~~/ukmm/releases the current UKMM releases page]		# Download the executable archive for your system from [https://github.com/NiceneNerd/ukmm/releases the current UKMM releases page]
	# Extract the executable from the archive to just about anywhere on your computer		# Extract the executable from the archive to just about anywhere on your computer
	# Run the executable		# Run the executable

Ginger: Overhaul: Moved early info sections into FAQ, added some FAQ questions, reorganized FAQ area, simplified some language, added note about changing language for non-English and non-native speakers

2026-04-04T17:41:13Z

Overhaul: Moved early info sections into FAQ, added some FAQ questions, reorganized FAQ area, simplified some language, added note about changing language for non-English and non-native speakers

Show changes

Ginger: /* Why use UKMM? */ Add the thing about forwarding map file changes. Dunno why. Nobody reads this freakin section.

2026-02-13T05:30:27Z

Why use UKMM?: Add the thing about forwarding map file changes. Dunno why. Nobody reads this freakin section.

← Older revision		Revision as of 05:30, 13 February 2026
Line 30:		Line 30:
	# If you're using Cemu, or previously used BCML, it's much easier to set up		# 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 gives you more control over where your mods are deployed and how they're deployed there
			# It merges map changes from the DLC files into the base game, so you can install many mods that only have DLC map files even if you don't have the DLC
	# 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		# 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
	# It doesn't need to fully remerge every single file when you install something. BCML could never manage to merge only the files required by changed mods without breaking something. UKMM can do it just fine, so installing small mods doesn't take 2 minutes if you have a large mod installed		# It doesn't need to fully remerge every single file when you install something. BCML could never manage to merge only the files required by changed mods without breaking something. UKMM can do it just fine, so installing small mods doesn't take 2 minutes if you have a large mod installed

Ginger: /* Manual Setup */ Change switch base folder description, emulator executable command description

2026-01-18T08:59:34Z

Manual Setup: Change switch base folder description, emulator executable command description

← Older revision		Revision as of 08:59, 18 January 2026
Line 125:		Line 125:
	\|Base with Update Folder (Switch)		\|Base with Update Folder (Switch)
	\|Where you store your Base with Update Game dump.		\|Where you store your Base with Update Game dump.
	\|The folder named <code>romfs</code> ~~inside~~ , inside the <code>~~01007EF00011E800~~</code> folder in your game dump. Should look like <code>C:/some/path/~~01007EF00011E800~~/romfs</code>, where <code>C:/some/path</code> is something only you know.		\|The folder named <code>romfs</code>, inside the <code>01007EF00011E000</code> folder in your game dump. Should look like <code>C:/some/path/01007EF00011E000/romfs</code>, where <code>C:/some/path</code> is something only you know.
	\|-		\|-
	\|Update Folder (WiiU Unpacked)		\|Update Folder (WiiU Unpacked)
Line 174:		Line 174:
	\|Emulator Executable (optional)		\|Emulator Executable (optional)
	\|The command to use to run open your emulator when using the Open Emulator button		\|The command to use to run open your emulator when using the Open Emulator button
	\|~~The~~ path to ~~your emulator executable~~		\|A shell command for running your emulator. On Windows, this requires quotes around it at all times. On other OSes, it requires quotes around it if there are spaces in the path. As a shell command, it supports switches, e.g. "C:\path\to\Cemu.exe" -g "C:\path\to\botw\U-King.rpx" will open Cemu and skip the game selection menu, running the game immediately.
	\|-		\|-
	\|}		\|}

Ginger: /* Why use UKMM? */

2025-05-11T22:07:26Z

Why use UKMM?

← Older revision		Revision as of 22:07, 11 May 2025
Line 28:		Line 28:
	# It installs BNPs just like BCML does		# It installs BNPs just like BCML does
	# It's easier to install		# 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 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		# 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

Ginger: /* Why Use a Mod Manager? */Added “Why Use a Mod Manager?” Section

2025-05-01T20:10:58Z

Why Use a Mod Manager?: Added “Why Use a Mod Manager?” Section

← Older revision		Revision as of 20:10, 1 May 2025
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.		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?==		==BCML or UKMM?==

Ginger: /* Known Issues */

2025-03-23T16:37:05Z

Known Issues

← Older revision		Revision as of 16:37, 23 March 2025
Line 195:		Line 195:
	==Known Issues==		==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.		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.

HGStone: Undo revision 11901 by HGStone (talk)

2025-01-26T19:28:46Z

Undo revision 11901 by HGStone (talk)

← Older revision		Revision as of 19:28, 26 January 2025
Line 146:		Line 146:
	\|Deploy Layout		\|Deploy Layout
	\|Whether or not UKMM includes a personalized folder when it merges mods out		\|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		\|Auto Deploy