MCInstance Loader

Мод MCInstance Loader для Minecraft — инсталлятор пакетов модов

MCInstance Loader — это небольшой мод для Minecraft 1.7.10, который позволяет напрямую устанавливать пакеты модов в упрощённом формате .mcinstance. Он поддерживает скачивание файлов из интернета, сборку переопределений (overrides) и проверку целостности загружаемых данных. После успешной установки игра автоматически перезапускается, а файл конфигурации пакета отключается для корректной работы игры.

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

📦 Управление файлами и переопределениями

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

🌐 Скачивание и проверка данных

Мод позволяет скачивать файлы из интернета по любым URL-адресам и сохранять их в любую папку внутри директории Minecraft. Для обеспечения безопасности и целостности данных поддерживаются проверки хеш-сумм: SHA-512, SHA-256, SHA-1, MD5 или CRC32. Система кэширования хешей позволяет избежать повторного скачивания файлов при обновлениях, если хеш сохраняется в API источника.

⚙️ Настройки и пользовательский интерфейс

Для удобства управления предусмотрены следующие функции:

• Sided files: возможность скачивать определённые файлы только для сервера или клиента (полезно для GUI-модов).
• Опциональные файлы: гибкая система с меню группировки, множественными меню и GUI с выбором, позволяющая включать или отключать элементы пакета.
• Информационное меню: заменяет главное меню, уведомляя пользователя об ошибках или успехе установки. Поддерживает автоматический таймер выхода, кастомные сообщения об успехе и списки классов для модов, меняющих меню.
• Логирование: полная система логов для отслеживания проблем, включая расширенный режим для логов Forge.
• Проверка дублей: функция StopModReposts discourages использование сайтов с повторным распространением модов (может быть отключена).
• Прогресс-бар: отображает количество оставшихся модов во время загрузки.

🔌 Интеграция и поддержка

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