Simple Modpack Update Checker

Мод Simple Modpack Update Checker для Minecraft 1.21

Simple Modpack Update Checker — это компактная утилита для клиентов Minecraft, предназначенная для автоматического контроля версий модапаков. Мод сравнивает установленную версию сборки с целевым источником (ID проекта Modrinth или внешняя ссылка) и выводит всплывающее уведомление (toast), если доступна новая версия. Программа поддерживает фильтрацию по версиям игры и каналам выпуска при использовании ID проекта Modrinth.

Основной принцип работы

Мод запускается автоматически при старте игры и выполняет проверку конфигурационного файла config/simple-modpack-update-checker.json. В зависимости от типа источника (ID проекта или URL), мод использует разные методы получения данных: API Modrinth для официальных проектов или парсинг текстового файла для внешних ссылок. Если версия в источнике выше локальной, пользователю показывается сообщение о доступности обновления.

Настройка конфигурации

Для работы мода необходимо создать файл конфигурации в корневой папке config. Ключевые параметры, которые требуют обязательного заполнения:

• configVersion — номер версии схемы файла (по умолчанию 2), устанавливается автоматически.
• localVersion — строка с текущей версией вашего модапака.
• identifier — идентификатор цели проверки. Может быть либо Modrinth project ID (например, KmiWHzQ4), либо прямая ссылка на текстовый файл (например, pack.toml из packwiz), содержащий строку version = "String".

Каналы выпуска и фильтрация

При указании Modrinth project ID мод поддерживает выбор канала выпуска (releaseChannel). Каналы работают иерархически: нестабильные версии включают в себя стабильные.

• release (по умолчанию): показывает только стабильные релизы.
• beta: показывает бета-версии и стабильные релизы, игнорируя альфа-версии.
• alpha: показывает все версии (альфа, бета и стабильные).

Также можно ограничить проверку конкретными версиями Minecraft через параметр minecraftVersions (например, "1.21.4"), но только в связке с Modrinth ID.

Примеры конфигурации

Вот несколько типовых сценариев использования в формате JSON:

Базовая проверка по ID:
`json
{
"configVersion": 2,
"localVersion": "3.3.3",
"identifier": "KmiWHzQ4"
}
`

С фильтрацией по бета-каналу:
`json
{
"configVersion": 2,
"localVersion": "3.3.3-beta.5",
"identifier": "KmiWHzQ4",
"releaseChannel": "beta"
}
`

Проверка по внешней ссылке (pack.toml):
`json
{
"configVersion": 2,
"localVersion": "3.3.3",
"identifier": "https://raw.githubusercontent.com/SkyblockerMod/Skyblocker-modpack/main/packwiz/pack.toml"
}
`

Ограничения и особенности

Мод не поддерживает фильтрацию версий Minecraft и выбор каналов выпуска при использовании URL-ссылок. Он просто извлекает строку версии из указанного файла. Также мод не отслеживает серверные версии, так как работает исключительно на стороне клиента.