Формат mrpack для установки модпаков Minecraft¶
mrpack — это архивный формат файлов, используемый для распространения и установки модпаков (коллекций модов, ресурспаков и настроек) в Minecraft. Файл с расширением .mrpack представляет собой ZIP-архив, содержащий манифест в формате JSON (modrinth.index.json) со списком компонентов, ссылками на их скачивание и хешами для проверки целостности. Формат разработан площадкой Modrinth и стал де-факто стандартом для передачи сборок между лаунчерами.
¶Структура архива
Внутри .mrpack-файла, как правило, находятся:
- modrinth.index.json — основной манифест. Содержит версию формата, название пака, версию игры, версию загрузчика модов (Fabric, Forge, Quilt, NeoForge) и список файлов.
- overrides/ — папка с файлами, которые должны быть скопированы в корень игровой папки без изменений: конфиги модов, ресурспаки, шейдерпаки, иногда сохранения.
- client-overrides/ и server-overrides/ — аналогичные папки, но только для клиентской или серверной части.
Каждый элемент в массиве files манифеста описывает один файл: его путь внутри .minecraft, размер, хеши SHA1 и SHA512, а также список зеркал (URL) для скачивания. Лаунчер скачивает файлы с любого доступного зеркала, проверяет хеш и размещает по указанному пути.
¶Способы установки
¶Через лаунчеры, поддерживающие mrpack
Ряд лаунчеров умеют устанавливать .mrpack «из коробки»:
| Лаунчер | Поддержка |
|---|---|
| Prism Launcher | Импорт через «Add Instance» → Import from file |
| MultiMC / PolyMC / Modrinth Launcher | Прямой импорт архива |
| ATLauncher | Поддержка mrpack наравне с собственным форматом |
| GDLauncher | Импорт через меню создания инстанса |
Типичный процесс в Prism Launcher: «Add Instance» → вкладка «Import» → «From file» → выбор .mrpack. Лаунчер читает манифест, скачивает перечисленные моды, применяет overrides и создаёт готовый инстанс с нужной версией игры и загрузчиком.
¶Через Modrinth App
Официальное приложение Modrinth автоматически ассоциируется с .mrpack. Достаточно открыть файл — приложение создаст профиль, подтянет все моды и конфигурации. При недоступности какого-либо зеркала загрузчик пробует альтернативные URL.
¶Вручную
Если лаунчер не поддерживает формат, архив распаковывается вручную:
- Создаётся инстанс с версией игры и загрузчиком, указанными в
modrinth.index.json. - Из
overridesкопируются конфиги, ресурспаки и прочие файлы в папку инстанса. - Моды скачиваются по ссылкам из манифеста и помещаются в папку
mods.
Этот способ требует ручной работы, но применим к любому лаунчеру.
¶Требования к окружению
Перед установкой .mrpack необходимо убедиться, что:
- Установлена нужная версия Java (для современных версий Minecraft — Java 17 или 21).
- В лаунчере доступна версия игры, указанная в
modrinth.index.json(полеdependencies.minecraft). - Установлен и активен нужный загрузчик модов — его версия также прописана в манифесте (например,
fabric-loader,forgeилиneoforge).
Часть лаунчеров устанавливает загрузчик автоматически при импорте, другим требуется сделать это вручную.
¶Отличие от других форматов
.mrpack не следует путать с:
.zip-сборками — произвольные архивы, структура которых зависит от автора; лаунчер не может программно разобрать их содержимое.- CurseForge-форматом — площадка CurseForge использует собственные метаданные и API, хотя многие лаунчеры поддерживают оба формата.
.mrpackбез манифеста — битый или изменённый вручную архив не будет корректно импортирован: лаунчер не найдётmodrinth.index.json.
¶Ограничения
Формат описывает только контент, который можно скачать по прямым ссылкам. Файлы, размещённые вне перечисленных зеркал (например, приватные моды или контент с авторизацией), в манифест попасть не могут. Некоторые лаунчеры при импорте отфильтровывают моды, отсутствующие в их внутренней базе, — в таких случаях моды приходится добавлять вручную.
¶Источники
- Документация Modrinth: спецификация формата mrpack
- Справка Prism Launcher: импорт инстансов
- Modrinth App: руководство пользователя