Q: What files can TKMM merge?

TKMM can merge archive files ( .sarc , .pack ), parameter files ( .bgyml ), the resource database (RSDB), the Mals system (Mals) and the resource size table (RESTBL). Patches in the form of .ips or .pchtxt files are merged into one singular IPS patch. Support for texture archives ( .bntx ) and audio archives ( .bars ) is planned for future releases. TKMM will never support AI files ( .ainb ), animation sequence files ( .asb ), timeline files ( .bfevtm ) or event flow files ( .bfevfl ).

Q: Where are logs stored?

The TKMM logs are stored in the Logs folder next to the executable ( Tkmm.exe on Windows). On the Switch version, the logs are stored in the folder tkmm/Logs on your SD card.

Question 1

Why do I need a game dump?

Accepted Answer

To save space and be more copyright-friendly, TKMM stores mods without any of the game's copyrighted content.

This is achieved by comparing the game's copyrighted file with the modded file.

While this makes distributing mods easier, it also means that TKMM needs access to a copy of the game.

Distributing any part of the game files is illegal, thus, TKMM requires you to provide your own legally obtained copy of the game.

Question 2

Can I use an external cartridge dumping tool to get the game files?

Accepted Answer

Because these tools only dump the information from the cartridge, they will only have the base game and firmware stored on them. These tools cannot be used to dump the title.keys and prod.keys files, or an update of the game, which are required for TKMM to function.

Question 3

Why can't I use version 1.0.0?

Accepted Answer

The first version of Tears of the Kingdom is very different from every other version.

With the large number of changes, it becomes challenging to distinguish changes made by modders and changes from the update.

This is why version 1.0.0 of Tears of the Kingdom is not supported by TKMM.

Question 4

Can mods be made compatible for any version?

Accepted Answer

TKMM will apply the edits from each RomFS mod to the exact version of your game dump, which needs to be at least version 1.1.0 or later. This however will not be the case for ExeFS mods and cheats, those need to be directly compatible with your target version.

Question 5

Why do I see "MsgNotFound" in-game?

Accepted Answer

When mods edit or add more text, every language will not always be included. TKMM can handle this by applying text edits to the language you use in the game. In order to fix this problem, go to the settings page and navigate to Merging / Target Language then ensure your region and language are properly selected. For example, if you play in English and your region is set to America (in your Switch settings or emulator settings), you should select American English in the TKMM merging settings.

Question 6

How do I use cheats?

Accepted Answer

The method for enabling cheats depends on what you use to play the game:

Nintendo Switch: Use a cheat manager like EdiZon to enable cheats. You can also configure cheats to be enabled by default by editing /atmosphere/config/system_settings.ini and setting dmnt_cheats_enabled_by_default = u8!0x1.
Ryujinx: Use the built-in cheat manager within the emulator while the game is running.
Yuzu (and forks): Cheats are enabled by default and will work automatically.

Question 7

What files can TKMM merge?

Accepted Answer

TKMM can merge archive files (.sarc, .pack), parameter files (.bgyml), the resource database (RSDB), the Mals system (Mals) and the resource size table (RESTBL). Patches in the form of .ips or .pchtxt files are merged into one singular IPS patch. Support for texture archives (.bntx) and audio archives (.bars) is planned for future releases. TKMM will never support AI files (.ainb), animation sequence files (.asb), timeline files (.bfevtm) or event flow files (.bfevfl).

Question 8

Why aren't my mods showing up in-game?

Accepted Answer

If you play on Switch, ensure that you are running the latest version of Atmosphere. Follow this guide if your Switch isn't modded. If you play on emulator, you need to ensure the path to the emulator's executable in Application Settings is correct (e.g. C:\Games\Ryujinx\Ryujinx.exe). When that path is filled, the Merge Output is automatically set to a new folder in the emulator's mod folder for TotK. For example, a correct path for Ryujinx would be C:\Users\YourUsername\AppData\Roaming\Ryujinx\mods\contents\0100f2c0115b6000\TKMM. If that path is empty, or does not point to the correct location, right click TotK in your emulator, and select Open Mod Data Location or Open Mod Folder. In the location that is now opened in your file explorer, create a new folder called TKMM, and set that newly created folder as the Merge Output.

Question 9

Why am I getting errors / crashes in-game?

Accepted Answer

The most common problems are either caused by a corrupted game dump, broken / incompatible mods, or because the dump provided isn't the same version as the update you're playing on. You can check the version by going to the Cheats page in TKMM. At the top of the page, it will show the text Detected Game Version: followed by the version number detected by TKMM (e.g. 1.1.0). If it does not match the version in your emulator or Switch, you need to ensure your dump settings are correct. In the case of broken or incompatible mods, the best you can do is disable mods one by one and test again until you find which ones are causing problems. Sometimes, this can also be fixed by changing the priority order of the mods in question. For mods with configurable options, please ensure you selected those according to your preferences. If all else fails and your issue is persistent, please open an issue on the GitHub repository, or report the issue on our Discord server.

Question 10

Where are logs stored?

Accepted Answer

The TKMM logs are stored in the Logs folder next to the executable (Tkmm.exe on Windows). On the Switch version, the logs are stored in the folder tkmm/Logs on your SD card.

Frequently Asked Questions