Skip to content

Mod Manager

A tool created by Rafa that merges mods which modify the same file so they can be used together.

Currently, Mod Manager shares the same GitHub repository as Heaven Tool, so to download it just access the latest release and download the ModManager-Windows.zip asset.

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