MCInstance Loader - Установщик модпаков прямо в игре

Этот компактный мод открывает возможность установки модпаков формата .mcinstance непосредственно в Minecraft. Данный формат представляет собой упрощенный способ распространения сборок модов, который поддерживает загрузку файлов из интернета, включение дополнительных ресурсов и множество других функций.

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

Особенности формата и мода

MCInstance Loader и поддерживаемый им формат предлагают богатый набор возможностей:

Вы можете размещать любые файлы в папке overrides - они будут скопированы в корневую директорию Minecraft (обычно .minecraft). Также предусмотрена специальная папка carryover, куда игроки могут добавлять собственные файлы, которые объединятся с содержимым модпака.

Система поддерживает загрузку файлов с любых URL-адресов и их сохранение в любом месте папки Minecraft. Интегрирована работа с API Modrinth и CurseForge с несколькими режимами на случай сбоев.

Для проверки целостности загружаемых файлов используются хеш-суммы (SHA-512, SHA-256, SHA-1, MD5 или CRC32). Реализована система кэширования файлов с хешами, чтобы избежать повторной загрузки при обновлениях.

Мод включает проверки StopModReposts для предотвращения использования сайтов-репостов (эту функцию можно отключить при необходимости). Также поддерживаются раздельные файлы для клиента и сервера, что полезно для модов с графическим интерфейсом.

Дополнительные возможности

Гибкая система опциональных файлов с меню выбора, поддержкой группировки, несколькими меню и многовариантными интерфейсами с настраиваемым количеством переключаемых элементов (пока только на стороне клиента, серверная реализация планируется).

Полноценная система логирования позволяет легко отслеживать проблемы, связанные с этим модом. Есть возможность включения подробного вывода в журналы Forge.

Интегрирован проверщик обновлений для поддержания актуальности мода. В экран загрузки добавлена новая полоса прогресса, показывающая, сколько модов осталось загрузить.

Настраиваемый информационный интерфейс заменяет главное меню для уведомления пользователя об ошибках или успешной установке. Поддерживается таймер автоматического выхода, пользовательские сообщения об успехе и совместимость с модами, изменяющими меню (можно задать список классов).

После успешной установки файл pack.mcinstance автоматически отключается с возможностью его удаления или отключения этой функции. Это необходимо для нормальной игры после установки модпака.

Что такое формат .mcinstance?

Формат MCInstance (.mcinstance) представляет собой переработанный ZIP-архив со специфической внутренней структурой, содержащий файлы .packconfig, похожие на формат INI. Цель этого мода - обеспечить установку таких файлов непосредственно в игре, создавая кроссплатформенный формат модпаков. Поддержка формата также может быть добавлена в сторонние лаунчеры для установки пакетов двойным щелчком по файлу.

Планы на будущее

На данный момент портирование мода на другие версии не ведется, но планируется в будущем. Цель - сделать формат mcinstance доступным для как можно большего числа игроков. Сейчас разработка начинается с версии 1.7.10, портирование на другие версии будет выполнено, когда мод будет готов.

Поскольку мод распространяется под лицензией MIT, вы можете помочь с портированием, создав pull request на GitHub для любой версии (будь то 1.3.2, 1.18, Forge, Fabric и т.д.).

Лицензирование и благодарности

Хотя мод распространяется под лицензией MIT, это не относится к файлам в пакете net.lingala.zip4j, поскольку это исходный код библиотеки zip4j, включенный для удобства использования. Библиотека zip4j лицензирована под Apache License 2.0, а версия, включенная здесь, - релиз 2.9.1.

Благодарности:

• Srikanth-lingala за создание библиотеки zip4j, которую использует этот мод
• AstroTibs за OptionsEnforcer, который вдохновил разработку
• Janrupf и HansWasser за ModDirector, который также повлиял на создание этого мода