Remote

Music and Melody has the support for providing remote catalogs so that players can browse, download and update an endless array of Albums, without worrying about distribution file size.

By default, all players have access to the content provided by the official and community catalogs, which includes optional downloads for a ton of Minecraft-related soundtracks not part of the base game & mod.

If you're hosting your own catalog, you're welcome to reach out on the Discord server to apply for your catalog to be added to the Community Catalog list so all players can check it out in-game!

Making Remote Catalogs

If you're a developer who wishes to host their own catalog for players to be able to seamlessly browse and download your albums, playlists, events or themes, you can simply create a catalog.json file on a repository, as per the below example.

If you're a user, you just need to add the url to where the catalog is hosted via Manage Repositories.

{
  "schema": 1, // schema version
  "repository": {
    "id": "music_and_melody", // id of your repository
    "name": "Music & Melody Catalog" // repository name shown in-game
  },
  "packs": [
    {
      "id": "minecraft_dungeons:minecraft_dungeons", // id of the album/pack being installed
      "name": "Minecraft Dungeons", // name displayed in the in-game album browser, prior to installation
      "description": "Full base Minecraft Dungeons OST", // description shown on the About page
      "version": "1.0.0", // version tracking, increment this when releasing a new version
      "url": "https://github.com/Rebel459/music-and-melody-remote/releases/download/minecraft-dungeons/minecraft-dungeons-1.0.0.zip", // url to a zip file
      "sha256": "0765937d99d8ced7b04f8d6b35dd660068bc526c05687eb8cd09080638a2e7f9", // sha256
      "size": 255378437, // file size
      "icon": "music_and_melody:textures/album/minecraft_dungeons.png", // icon to be shown prior to installation. Identifiers and URLs are supported. Will fallback to the vanilla fallback icon if not present on the client
      "tags: ["album"], // content tags - at least one must be present, but you can have multiple. Can be "album", "theme", "event" or "playlist"
      "dependencies: ["mod_id"], // stops your content being installed if the client does not have the required mods
      "show_from_version": "1.21", // the minimum Minecraft version in which this album should appear for download (optional)
      "show_below_version": "26.1" // the Minecraft version below which this album should appear for download within (optional)
    }
  ]
}

To get a sha256 and file size, you can run the following commands in powershell:

(Get-Item FULL_PATH.zip).Length
(Get-FileHash FULL_PATH.zip -Algorithm SHA256).Hash.ToLower()

The zip you provide is similar to a resource pack, however it does not have a pack.mcmeta or assets root folder. Rather, you should simply have [namespace]/[content] directly, such as [file-name].zip/[namespace]/[albums]/[album-name].json.

Resource-stacking (eg en_us.json) is supported as with a full resource pack.

For a full, functioning example of remote catalogs, check out the official repo.