MCInstance Loader

MCInstance Loader - это небольшой, но полезный мод для Майнкрафт, который решает одну из главных проблем сборок модов: их установку. Вместо того чтобы вручную копаться в папках, скачивать каждый файл отдельно и надеяться, что ничего не сломается, этот мод позволяет установить сборку в формате .mcinstance прямо из игры. Просто открой файл, и мод сам скачает всё необходимое, наложит нужные файлы и перезагрузит игру. Удобно, правда?

Что такое .mcinstance и зачем он нужен?

Формат .mcinstance - это по сути ZIP-архив с определённой структурой. Внутри лежат файлы конфигурации (.packconfig), папка overrides для наложения файлов и ссылки на скачивание модов. Главная фишка в том, что этот формат кроссплатформенный - его можно использовать не только в самом Майнкрафте, но и в сторонних лаунчерах. Двойной клик по файлу - и сборка установлена. Никаких лишних телодвижений.

Особенности MCInstance Loader

Вот что умеет этот мод и сам формат:

• Наложение файлов - любые файлы из папки overrides копируются в корневую папку Minecraft (обычно .minecraft). Это как с обычными сборками, только автоматически.

• Папка carryover - специальная папка для игроков. Если ты хочешь добавить свои файлы поверх того, что скачала сборка, просто кинь их туда. Они перезапишут то, что было.

• Загрузка файлов из интернета - можно указать любую ссылку, и мод скачает файл в нужную папку. Удобно для текстурпаков или шейдеров.

• Поддержка Modrinth и CurseForge - мод умеет скачивать файлы напрямую с этих платформ. Если что-то пойдёт не так, есть запасные режимы.

• Проверка хешей - для скачанных файлов проверяются хеши (SHA-512, SHA-256, SHA-1, MD5 или CRC32). Никаких битых файлов.

• Кэширование - если файл уже скачан, мод не будет качать его заново при обновлении. Экономит время и трафик.

• Защита от StopModReposts - мод проверяет, не скачиваешь ли ты файлы с сайтов-репостов. Можно отключить, если нужно.

• Разделение на клиент и сервер - можно указать, какие файлы качать только на клиенте или только на сервере. Полезно для GUI-модов и прочего.

• Гибкая система опциональных файлов - можно сделать меню с выбором: какие моды ставить, а какие нет. Поддерживаются группы, несколько меню и мультивыбор. Пока только на клиенте, но серверная часть в планах.

• Логирование - полный лог работы мода. Если что-то пошло не так, легко найти проблему. Есть режим подробных логов для Forge.

• Проверка обновлений - можно включить автообновление самого MCInstance Loader.

• Интеграция с прогресс-баром Forge - во время загрузки показывается отдельный прогресс-бар, чтобы ты видел, сколько ещё качать.

• Информационное GUI - после установки появляется окно с результатом: ошибки или успех. Можно настроить авто-выход через таймер или кастомное сообщение. Поддерживаются моды, меняющие главное меню.

• Автоотключение .mcinstance - после успешной установки файл автоматически отключается (или удаляется), чтобы игра запустилась нормально.

Как использовать?

Всё просто: скачай мод MCInstance Loader для Майнкрафт на нужную версию (пока поддерживается 1.7.10, но автор планирует портировать на другие версии). Затем открой файл .mcinstance - мод сам всё сделает. Если хочешь создать свою сборку в этом формате, загляни в вики проекта - там подробно расписана структура.

Важно знать

Мод распространяется под лицензией MIT, но это не касается библиотеки zip4j (версия 2.9.1), которая используется внутри и лицензирована под Apache License 2.0. Автор мода вдохновлялся проектами OptionsEnforcer и ModDirector.

Если хочешь помочь с портированием на другие версии (хоть 1.3.2, хоть 1.18, хоть Forge или Fabric), загляни на GitHub - код открыт, можно сделать pull request.