unsup

Unsup — это компактная реализация системы синхронизации рабочих директорий на языке Java. Модификация может работать в качестве Java-агента, используя запуск другой программы для собственной активации.

Идеальное решение для маленьких приватных сборок или разовых проектов в небольшой группе, где полноценная публичная дистрибуция (например, через Modrinth) избыточна или нежелательна. Инструмент способен загружать моды из их первоисточников — везде, где поддерживается протокол HTTP(S).

Для работы необходим файл конфигурации unsup.ini, размещённый в рабочей директории, либо указание пути к нему через аргумент JVM -Dunsup.bootstrapUrl=.

Надёжность и безопасность

Обновление построено таким образом, чтобы рабочая директория никогда не оказывалась в несогласованном состоянии. За исключением внезапного отключения питания в момент применения изменений (крайне маловероятный сценарий), процесс обновления через unsup гарантированно завершится корректно.

Инструмент проводит проверку целостности на основе хеш-сумм (с поддержкой различных алгоритмов, SHA-256 рекомендуется) для всех загружаемых файлов, а также перед их перезаписью. Пользователь будет предупреждён, если локально изменённый файл подлежит обновлению. Дополнительно поддерживается подписание манифестов с помощью OpenBSD Signify для повышения уровня безопасности.

Совместимость

Благодаря уникальному упрощённому дизайну, unsup совместим со всеми популярными лаунчерами — от стандартного варианта до MultiMC. Достаточно добавить -javaagent:unsup.jar в аргументы JVM и разместить файлы unsup.jar и unsup.ini в директории .minecraft.

В Prism Launcher unsup можно использовать как компонент, импортировав com.unascribed.unsup.json из последнего релиза на Forgejo. Это позволит лаунчеру самостоятельно загружать и управлять unsup. (MultiMC, несмотря на запросы, не поддерживает компоненты в виде Java-агентов.)

Функциональность

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

Unsap также способен обновлять компоненты MultiMC, включая самого себя, если он добавлен в таком качестве. Это открывает возможность обновления загрузчиков модов или даже самой версии Minecraft.

Создание сборок

Вы можете указать unsup на файл pack.toml от Packwiz (рекомендуется) либо написать нативный манифест unsup вручную. Графический интерфейс для создания манифестов временно не разрабатывается, поскольку Packwiz стал фактическим стандартом для сборок модов Minecraft.

Стабильность

Инструмент успешно применялся для сборок на версиях от b1.7.3 до 1.21.5, как на клиенте, так и на сервере. Совместимость подтверждена с Forge (устаревшими и современными версиями), Fabric, Quilt и NeoForge. Unsap использовался в множестве сборок — от скромных до крупномасштабных. Нативная поддержка манифестов и манифестов Packwiz стабильна и проверена в реальных условиях.

Функция подписи пока носит экспериментальный характер и не применялась в крупных проектах. Возможно, именно вы станете первым — делитесь обратной связью, если всё работает хорошо!

Интерфейс

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