modrinth.index.json —— 每个 .mrpack 内部的清单文件

它是什么

modrinth.index.json 是位于每个 .mrpack根目录下的 JSON 文件。它描述了整合包 —— 对应哪个 Minecraft 版本、哪个加载器，以及一份包含下载地址和哈希值的完整模组清单。

示例

{
  "formatVersion": 1,
  "game": "minecraft",
  "versionId": "1.2.3",
  "name": "My Modpack",
  "files": [
    {
      "path": "mods/sodium.jar",
      "hashes": {
        "sha1": "...",
        "sha512": "..."
      },
      "downloads": [
        "https://cdn.modrinth.com/data/.../sodium-0.5.jar"
      ],
      "fileSize": 832544
    }
  ],
  "dependencies": {
    "minecraft": "1.20.1",
    "fabric-loader": "0.15.0"
  }
}

关键字段

formatVersion

目前恒为 1。预留给 Modrinth 规范的未来变更。

game

目前恒为 "minecraft" ，预留给 Modrinth 未来可能支持的其他游戏。

versionId / name

作者自定义的版本标签和便于阅读的整合包名称。

files[]

「购物清单」。每条记录包含目标 path （文件在实例中的存放位置）、一个或多个 downloads 下载地址、 fileSize、 hashes （用于完整性校验）。

dependencies

最低 Minecraft 版本和所需的模组加载器版本。转换器据此在日志中告诉你需要在目标启动器里安装哪个加载器。

为什么要两种哈希（SHA-1 + SHA-512）？

保留 SHA-1 是为了兼容旧工具。SHA-512 才是标准的完整性校验方式。我们的转换器使用 SHA-512 校验每一个下载文件。