MM Recomp Music Randomizer (v1.1.0)

Reimplements the music randomization features from MMR.

The best place to find custom music tracks for MM is the music-releases channel on the MMR Discord. If you need an OOT audiobin for OoTRS files, you can download one from their website. You can also find all of my own soundfont adaptations on my GitHub.

If you want to report any, please contact me on the N64 Recomp Discord, N64 Recomp Modding Discord, DM me on Discord directly at @asticky, or open an issue on GitHub.

Instructions:

Drag and drop all mod files (the .nrm, and the .dll for Windows, .so for Linux, or .dylib for MacOS) into your mods directory, or use the Install Mods button on the Zelda64 Recomp Launcher's mod menu.

To add custom music, create a mod_data folder in the same directory as mods, then create a music folder and drop your .mmrs files inside that. (i.e., on Windows, AppData\Local\Zelda64Recompiled\mod_data\music.) These directories will be created on launching the game if they do not exist.

A database will be created in the mod_data folder, which will add or remove tracks based on filenames and modification dates. If you want to reset your music database, you can delete mod_data\musicDB.db.

New in 1.1: You can also use .ootrs files made for Ocarina of Time Randomizer! Download an audiobin from MMR's website and place it in your mod_data folder, and it should Just Work (TM).

Your folder structure should look like this:

⌞Zelda64Recompiled
  ⌞mods
    ⌞mm_recomp_music_randomizer.nrm
    ⌞mm_recomp_music_randomizer_extlib(.dll|.so|.dylib)
    ⌞magemods_audio_api.nrm
    ⌞magemods_audio_api(.dll|.so|.dylib)
  ⌞mod_data
    ⌞music.db
    ⌞OOT.audiobin (optional)
    ⌞music
      ⌞(.mmrs, .ootrs, .zseq files)

Features:

• Reads and interprets .mmrs, .ootrs, and .zseq files

• Shuffles both vanilla and custom music using (mostly) the same categories as MMR

• Supports custom sounds, custom audiobanks, and .formmask

• Adds a toggle to enable or disable combat music

• Displays the name of the currently-playing song on load

New in 1.1!

• Added support for .ootrs and .zseq files!
• Put a band-aid over Fixed an issue where songs would fail to load, which can lead to a softlock on the credits scene
• Added a loading screen with status updates for database updating
• Fixed a few bugs and edge cases

v1.1.0

• Added support for .ootrs files
• Added support for .zseq files
• Added a loading screen
• Moved database preparation to a separate thread
• Fixed a bug that caused tracks to fail to play on a cold load
• Fixed a bug that caused custom sounds to fail to parse if their sample address was too high
• Fixed a bug that caused tracks with no sequence to be added to the database, leading to a crash

v1.0.1

• Fixed a crash related to custom tracks with ID 0x1D.
• Removed links to weird chess website in changelog.
• Updated README.

v1.0.0

• Total rewrite of entire mod. Too many changes to list here
• Updated README.

v0.2.0

• Changed music directory to mod_data/music.
• Added a progress counter to the debug mode when reading the music directory.
• Fixed a bug where an improperly initialized audiotable would overwrite data from other mods, resulting in many unpredictable behaviors.
• Fixed a bug where individual song slots would not be considered for randomization.
• Implemented a temporary workaround for a bug with soundfonts above id 255.
• Fixed a bug where custom sounds were not deleted from the database properly.
• Removed ProxyMM-KV as a dependency.
• Updated README.

v0.1.3

• Fixed issue with category string not being null-terminated, resulting in final categories not being read correctly in some circumstances.
• Added a log-level mask to a certain print_bytes call.
• Updated README.

v0.1.2

• Fixed handling of empty or missing music folder.
• Updated Audio API dependency to require version 0.5.2.
• Restored some debug log messages.
• Updated README.

v0.1.1

• Added Recomp Rando as a dependency.
• Updated README.

v0.1.0

• Initial release.
• Updated README.