Skip to content

Mod Manager

Some mods modify the same game files, which normally causes them to overwrite each other.

Mod Manager solves this by merging compatible files so multiple mods can work together without conflicts.

For example:

  • Mod A edits ItemParam.bcsv
  • Mod B also edits ItemParam.bcsv

Without merging, one mod would overwrite the other.
Mod Manager combines the changes so both mods can work at the same time.

NameLocation / ExtensionSupport
BCSVBCSV/*.bcsv
MSBTMessage/*.sarc.zs
EventFlowEventFlow/*.bfevfl
ModelModels⚠️

Model cannot be merged, so avoid having mods that change the same model.

Using Mod Manager is very simple!
~~ The terminal can look a bit scary, but I promise it’s very easy to use!

  1. Download the latest Mod Manager from GitHub: Windows

  2. Extract it to a folder of your choice

  3. Create an empty mods folder inside the extracted folder

  4. Drop all your mods into this mods folder.

  5. Open HeavenTool.ModManager.CLI.exe. It will display the valid detected mods and ask if you want to merge them.

  6. The merged mods will be created inside the output folder (in the extracted folder)

  7. Place the folders inside output on your SD card at atmosphere/contents/01006F8002326000/romFs/

  8. Make sure to remove the old mods and use only the merged ones on your SD card.

Mod Manager expects all mods to be zipped and contain a romfs folder inside the archive.

It can be either:

  • my_mod.zip/atmosphere/contents/01006F8002326000/romfs/
  • my_mod.zip/romfs/

Both formats are supported as long as the files are correctly named and placed. Full Example:

  • DirectoryMy_Mod.zip
    • Directoryromfs/
      • DirectoryBcsv/
        • ItemParam.bcsv
      • DirectoryMessage/
        • Dialog_USen.sarc.zs
      • DirectoryModel/
        • MyCustomModel.Nin_NX_NVN.zs