LittleCube-hax / MMRecompModTemplate

Mod template for making Majora's Mask: Recompiled mods.

Majora's Mask: Recompiled Mod Template

This is an example mod for Majora's Mask: Recompiled that can be used as a template for creating mods. It has a basic build system, headers, sample code, and a mod config toml.

Writing mods

See this document for an explanation of the modding framework, including how to write function patches and perform interop between different mods.

Tools

You'll need to install clang and make to build this template.

• On Windows, using chocolatey to install both is recommended. The packages are llvm and make respectively.
• On Linux, these can both be installed using your distro's package manager.
• On MacOS, these can both be installed using Homebrew. Apple clang won't work, as you need a mips target for building the mod code.

On Linux and MacOS, you'll need to also ensure that you have the zip utility installed.

You'll also need to build N64Recomp for the RecompModTool utility.

Building

• First, make sure that the RecompModTool executable is in the root of the mod directory.
• Next, run make (with an optional job count) to build the mod code itself.
  • This will produce your mod's .nrm file in the build folder.
• Finally, compile your mod offline.
  • This part is temporary and only needed while the recomp mod runtime doesn't have LuaJIT recompilation implemented
  • Start by running the OfflineModRecomp utility (included in the N64Recomp repo). Pass the following arguments: build/mod_syms.bin build/mod_binary.bin Zelda64RecompSyms/mm.us.rev1.syms.toml build/mod_recompiled.c
  • Next, build the dynamic library from the generated build/mod_recompiled.c file and pass offline_build as an include path.
    • On Windows, you can run:

      clang-cl build/mod_recompiled.c -fuse-ld=lld -Z7 /Ioffline_build /MD /O2 /link /DLL /OUT:build/mm_recomp_mod_template-1.0.0.dll
      

      On Linux, you can run:

      clang build/mod_recompiled.c -shared -fvisibility=hidden -fPIC -O2 -Ioffline_build -o build/mm_recomp_mod_template-1.0.0.so
      

    • Make sure your mod's dynamic library and .nrm file have the same filename (besides the extension).
      • e.g. testmod-1.0.0.nrm and testmod-1.0.0.dll