MRPack to ZIP

.mrpack 文件是什么？Modrinth 整合包格式详解

简短的回答

.mrpack 文件是一个遵循 Modrinth 整合包规范的 ZIP 压缩包。它的作用是描述一个完整的 Minecraft 整合包，但不包含模组文件本身 —— 而是列出每个模组应当从哪个 URL 下载。

.mrpack 文件内部结构

如果把后缀改成 .zip 再解压，你会看到：

my-modpack.mrpack
├── modrinth.index.json    ← the manifest
└── overrides/             ← optional folder
    ├── config/
    ├── resourcepacks/
    └── scripts/

modrinth.index.json 清单文件

一份 JSON 文档，列出每个模组的文件大小、SHA-512 哈希以及一个或多个下载地址。启动器读取这份清单，逐个抓取 URL，在磁盘上组装出可玩的整合包。参见 逐字段参考.

/overrides 文件夹

这些文件会原样复制到 Minecraft 实例中：配置文件、脚本、资源包、光影，以及其他无法作为模组下载的内容。它们是整合包作者的个性化设置。

为什么说 .mrpack 是「购物清单」而不是「购物袋」

因为模组只是被引用而非被打包， .mrpack 文件通常只有 10–500 KB，即便包含数百个模组也是如此。这对分享很友好，对离线使用则很不友好：没有网络时， .mrpack 无法独立变成可玩的整合包。

.mrpack 与 CurseForge ZIP 整合包有何不同

CurseForge 的 ZIP 整合包内含一个 manifest.json ，列出的是 CurseForge 自有 API 的 projectID/fileID 组合。Modrinth 的 .mrpack 列出的则是直接 URL 和哈希值。取舍在于：Modrinth 的格式与启动器无关；CurseForge 的格式则与 CurseForge 深度绑定。

完整对比： 整合包格式横向对比.

什么时候应该转成 ZIP

  • 你想在不支持 .mrpack 的启动器里使用整合包（CurseForge 桌面版、原版启动器）
  • 你要把整合包上传到只接受 ZIP 的服务器托管商
  • 你要分享给一位处于离线状态、无法自行下载模组的朋友

这三种情况，都请使用我们的 主转换器.